Hilfe für Gestaltung dieser Website

Vorbemerkungen:

Dieser (in Vorbereitung befindliche) Text ist eine von G. Becker für die Zwecke dieser Hase-Website modifizierte Fassung der 'offiziellen' PmWiki-Hilfe (s. Menüpunkt):

Sie enhält einige KONVENTIONEN und TIPPS, einige Möglichkeiten wurden der Einfachheit halber weggelassen.

Diese Hilfe wird bei Bedarf laufend erweitert!

Testen Sie die Möglichkeiten der einfachen Formatierung

Nutzen Sie be Bedarf oder Wunsch auch andere Seiten der Hilfe, ggf, auch die englischsprachigen Seiten

Um mit diesen Regeln zu experimentieren gehe dazu bitte in den [1]?

Regeln zur Textformatierung

(deutsche Übersetzung der Seite PmWiki.TextFormattingRules, Stand 21.Nov 2004)

Auf dieser Seite des Wikis zeigen wir eine komplettere Liste einiger Markup Kombinationen, welche im PmWiki zur Verfügung stehen. Es sei gesagt, daß es einfach ist Seiten zu bearbeiten ohne ein einziges von den unten aufgelisteten Markups zu benutzen. Solltest Du jemals eines brauchen, hier findest Du sie.

Absätze

• Absätze nicht einrücken, d.h. fangt ganz links an zu schreiben
• Ihr könnt Zeilenumbrüche einfügen, so dass man bequem im Textfeld arbeiten kann. Zeilenumbrüche werden (normalerweise) entfernt
• Benutzt Leerzeilen um Absätze zu trennen
• Eingerückte Zeilen (beginnend mit einem oder mehr Leerzeichen) werden zu Schreibmaschinenschrift.
• Benutzt \ (einfacher Backslash) am Zeilenende um die folgende Zeile mit der aktuellen zu verbinden (continuation?) (unterdrückt einen Zeilenvorschub)
• Gebrauche \\ (zwei Backslashes) am Zeilenende um einen Zeilenumbruch zu erzwingen, aber bleib dabei in der "Reihe" als einer der vorangegangenen Listenpunkte.

Eingerückte Absätze (Zitate)

Pfeile (->) am Anfang eines Absatzes bewirken einen eingerückten Absatz. Mehrere Bindestriche (--->) am Anfang bewirken eine größere Einrückung.

->Four score and seven years ago our fathers placed upon this continent a new nation, conceived in liberty and dedicated to the proposition that all men are created equal.

Aufzählungen

Aufzählungen entstehen durch ein Sternchen ("*") am linken Rand der Zeile. Mehrere Sternchen erzeugen verschachtelte Aufzählungen.

* Obere Ebene
** Zweite Ebene
** Zweite Ebene
* Obere Ebene

Horizontale Linie

Vier oder mehr Minuszeichen (----) am Anfang einer Zeile ergeben eine horizonale Linie

Hervorhebungen

• Text eingefasst in zwei aufeinanderfolgende Apostrophe (''), i.e., zwei Apostrophe, wird hervor gehoben (üblicherweise kursiv)
• Text, eingefasst in drei aufeinanderfolgende Apostrophe ('''), i.e. drei Apostrophe wird stark hervorgehoben (üblicherweise fett)
• Text, eingefasst in fünf Apostrophe (''''') kombiniert die Effekte (also fett kursiv)
• Zwei "Klammeraffen" (at-Zeichen) (@@) ergeben Schreibmaschinenschrift, d.h. Text mit konstanter Buchstabenbreite
• Verwende [+...+] für größere Schrift and [-...-] für kleinere Schrift
• Hervorhebungen können mehrfach in einer Zeile verwendet werden. Sie dürfen jedoch nicht über eine Zeile hinweg gehen. -- Man kann also keinen neuen Absatz mitten im Fettdruck erzeugen.

Weitere typographische Formatierungen

• '+groß+', '-klein-', '^über^', '_unter_', {+unterstrichen+}, {-gestrichen-}.
  groß , klein , ^über , _unter , unterstrichen , gestrichen
• `WikiWord WikiWord Aufhebung

Unter Stile? findest Du weitere Einstellungen zum Formatieren von Text

Verweise /Links

• Wörter und Sätze in Doppel-Klammern (beispielsweise [[text formatting rules]]) erzeugen Verweise zu anderen Seiten innerhalb des Wikis.

<<<<<<<

• Konvention (G. Becker) dazu (um die Übersicht über die Seiten und ihre Zusammenhänge zu behalten:
• möglichst kurze aber verständliche Seitennamen ausdenken
• Wird von einer Seite eine "Unterseite" erzeugt, dann Namen durch Anhängen eines Wortes mit erstem Buchstaben als Großbuchstaben, z.B. Unterseite zur Seite Exkursion: ExkursionAufgabe

* Zusammengefügte Worte mit Großbuchstaben (so genannte | WikiWörter? erzeugen automatisch einen Verweis auf eine andere Seite in diesem Wiki auch ohne sie in Doppel-Klammern zu setzen. (G. Becker: nicht verwenden!) ======= Auf diese Weise können auch neue Seiten erzeugt werden (s.unten) * Zusammengefügte Worte mit Großbuchstaben (so genannte | WikiWörter? erzeugen automatisch einen Verweis auf eine andere Seite in diesem Wiki auch ohne sie in Doppel-Klammern zu setzen. G. Becker: nicht verwenden! >>>>>>>

• URLs mit Protokollangabe "http:", "ftp:", "gopher:", "mailto:", oder "news:" erzeugen automatisch Verweise, z.B. http://www.pmichaud.com/toast.
• URLs mit der Endung .gif, .jpg, or .png werden als Bilder in der Seite dargestellt.
• Verweise mit beliebigem Text können entweder als [[Zielposition | Textabschnitt]] oder [[Textabschnitt -> Zielposition]] erzeugt werden. Textabschnitt kann auch eine URL von einer Grafik sein. In diesem Fall wird die Grafik ein Verweis auf die weitere url oder ein | WikiWort?.
• Ziele von Ankern innerhalb von Seiten (#-Verweise) können durch [[#Zielposition]] gesetzt werden.

Download

Beispiel Arbeitsblatt-test.doc und Arbeitsballt.pdf

[[Download:Arbeitsblatt-test.doc|Attach:word.gif]] ergibt: ?

oder:

[[Download:Arbeitsblatt-test.pdf|Attach:pdf.gif]] ergibt: ?

oder:

[[Download:Arbeitsblatt-test.doc|download]] ergibt: download?

oder

Downloaden Sie [[Download:Arbeitsblatt-test.doc|hier]] ergibt: Downloaden Sie hier?

Anschließend muß die Datei Arbeitsblatt-test.doc bzw. Arbeitsblatt-test.pdf tatsächlich über "A" hochgeladen werden!

Bilder einfügen /hochladen

mit Attach:bild.jpg wird ein Bild mit dem Dateinamen bild.jpg eingefügt, das nach Abspeichern der Seite

über "A" noch hochgeladen werden muss!

Bei der Kreierung von Dateinamen für Bilder gilt entsprechendes wie bei der Anlage neuer Seiten (s.u.): möglichst einfache und verständliche Namen mit Bezug zum jeweiligen Seitennamen, z.B. Exkursion1_Bild1.jpg oder Exkursion1_Bruecke.jpg

Überschriften

Überschriften entstehen durch ein Ausrufezeichen (!) am linken Rand . Aufeinander folgende Ausrufezeichen am Zeilenanfang erzeugen Überschriften auf niedrigerer Ebene. Zum Beispiel

! Überschrift erster Ordnung
!! Überschrift zweiter Ordnung
!!! Überschrift dritter Ordnung

Fluchtsequenzen - Auszeichnungen ausschalten / Escape sequence

Alles, was in [= and =] eingefasst ist, wird von PmWiki/PmWiki nicht interpretiert. Das macht es einfach, WikiWords zu erzeugen, die keine Verweise sind und man schaltet damit auch die Interpretation anderer Formatierung aus. [= and =] können mehrere Zeilen überspannen und so den Effekt auf mehrere Eingabezeilen anwenden.

Zum Beispiel wird ein Leerzeichen [= am Zeilenanfang den Text bis zum nächsten =] in Schreibmaschinenschrift und für PmWiki nicht interpretabel darstellen. Das ist nützlich für vorformatierten Text, beispielsweise in Programm-Listings.

Nummerierte Listen

Nummerierte Listen werden durch ein Nummernzeichen (#) links am Zeilenanfang erzeugt .

# Bereite das Experiment vor
## Pack den Knallfrosch aus
## Steck den Knallfrosch in den Toaster
#  Schalte den Toaster ein
# Suche Deckung

Definitionslisten

Definitionslisten werden duch einen Doppelpunkt am linken Rand gebildet.

:term:definition of term
::second-level item: definition of 2nd-level item

Tabellen

Tabellen entstehen durch Einfassen der Zelleninhalte mit '||'.

• Eine Zelle mit führenden und folgenden Leerzeichen wird zentriert.
• Eine Zelle mit führenden Leerzeichen wird rechtsbündig
• Alle anderen Zellen sind linksbündig
• Eine leere Zelle wird mit der vorherigen Zelle verschmolzen. (Es gibt zur Zeit keinen derartigen Mechanismus um mehrere Reihen miteinander zu verbinden.)
• Eine Zeile mit '||' benennt die Tabellenattribute für die nachfolgende Tabelle

||align=center border=1 width=50%
||Links   || Zentriert ||  Rechts||
||A      ||    B   ||      C||
||       || einzeln || ||
||       || mehrfach verbunden ||||

Mehr Information gibt es bei Tabellen? , Tabellen 2? and Tabellengestaltung für Fortgeschrittene?.

Neue Seiten

Dazu wird von einer bestehen Seite ein Link mit einem neuen (Wiki)Namen gesetzt:

[[Neueseite|linktext]]

Nach Abspeichern wird der Linktext mit Fragezeichen erzeugt. Mit Klicken auf das Fragezeichen wird die neue Seite erzeugt. Sie muss nur noch mit Inhalt gefüllt und ebenfalls abgespeichert werden!

Um die Übersicht bei komplexen Webseiten zu bewahren sollten bei der Namensgebung der neuen Seiten Konventionen vereinbart werden: Alle Unterseiten der Exkursionsseite 1, die Exkursion1 heißt, soll nach dem Muster angelegt werden: 'Exkursion1_1, Exkursion1_2 oder auch Exkursion1Furt u.ä. (der 2. Namensteil sollte mit einem Großbuchstaben beginnen)

Ansonsten gilt: möglichst kurze aber verständliche Seitennamen ausdenken, keine Umlaute oder Sonderzeichen benutzen

Als Alternative zur direkten Erzeugung neuer Seiten, kann man sie direkt in die Adresszeile eingeben. Die Verlinkung erfolgt in diesem Fall als 2. Schritt!

Mit dem Klicken auf das nach Abspiechern entstehende Fragezeichen kann die neue Seite tatsächlich erzeugt und mit Inhalt gefüllt werden.

Um den Überblick über die Gesamtwebsite zu bewahren, ist es sinnvoll Konventionen für die Namengebung zu vereinbaren. So sollten bei der Aufteilung der Exkursionsseiten alle Namen so aussehen: Exk1_1, Exk1_2

Kommentare

Ein Text nach einem %comment% Tag bis zum Ende der Zeile oder einem folgenden %% wird nicht angezeigt.

Hier steht ein Satz %comment% und ein versteckter Kommentar %% über nichts besonderes.

<< | PmWikiDe.DocumentationIndex | >>

[2]