Grundlegende Textformatierungsregeln

für die Liste aller Seiten

Diese Seite enthält eine vollständigere Liste einiger der in PmWiki verfügbaren Textformatierungsregeln. Man kann auch problemlos Seiten erzeugen, ohne eine der unten beschriebenen Auszeichnungen zu verwenden. Aber wenn man sie braucht, sie sind da.

Um die Auszeichnungen auszuprobieren, versuchen Sie den Sandkasten zu bearbeiten.

Absätze

Um einen Absatz zu erzeugen, muss man einfach nur den gewünschten Text eingeben. Mit einer leeren Zeile lassen sich Absätze trennen.

Wörter in aufeinanderfolgenden Zeilen werden von PmWiki je nach Bedarf zusammengefasst und umgebrochen. (Das ist das normale Verhalten für XHTML.) Um das automatische Zusammenfassen abzuschalten, kann die Direktive (:linebreaks:) oberhalb der betreffenden Absätze genutzt werden.

• Ein \ (einfacher Backslash) am Ende der Zeile verbindet die aktuelle Zeile mit der folgenden.
• \\ (zwei Backslashes) am Ende der Zeile erzwingen einen Zeilenumbruch, jedoch wird die aktuelle Umgebung nicht verlassen (z. B. man bleibt innerhalb des aktuellen Listeneintrags).
• \\\ (drei Backslashes) am Ende der Zeile erzwingen einen Zeilenumbruch und fügt eine zusätzliche Leerzeile ein, ohne die aktuelle Umgebung zu verlassen. (Jeder weitere Backslash fügt eine weitere Leerzeile ein.)
• [[<<]] wird verwendet, um einen Zeilenumbruch zu erzwingen und gleichzeitig alle fließenden Elemente zu beenden.

Eingerückte Absätze (Zitate)

Pfeile (->) am Anfang eines Absatzes erzeugen einen eingerückten Absatz. Mehrere Bindestriche (--->) am Anfang des Pfeils führen zu einer stärkeren Einrückung.

   Achtung: Einrückung mit Leerzeichen an der linken Seite erzeugt Text mit fester Zeichenbreite.
            Siehe unten (Leerzeichen am Zeilenanfang).

Umgekehrte Pfeile (-<) am Anfang des Absatzes erzeugen einen Absatz mit hängenden Einzug. Bei zusätzliche Bindestrichen (---<) am Anfang wird der gesamte Text zusätzlich eingerückt.

sollte der Effekt hier nicht zu sehen sein (wegen zu hoher Bildschirmauflösung ab etwa 1300px), dann das Browserfenster schmaler einstellen

Textblöcke, für die mit (:linebreaks:) der automatische Zeilenumbruch abgeschaltet wurde, können eingerückt werden, indem der ersten Zeile des Textblockes ein Pfeil (->) vorangestellt wird und die folgenden Zeilen so mit Leerzeichen eingerückt werden, dass sich ihr erstes Zeichen genau unter dem ersten Textzeichen der ersten Zeile befindet. Eine nicht eingerückte Zeile beendet die Einrückung des Blocks. Ein Beispiel findet sich im Kochbuch-Rezept Cookbook:MarkupTricks (nur auf Englisch verfügbar). Vergleiche auch Leerzeichen am Zeilenanfang unten.

Aufzählungen und nummerierte Listen

Aufzählungen werden mit einem Sternchen (*) am linken Rand versehen. Nummerierte Listen erzeugt man, indem man ein Ziffernzeichen (#) am linken Rand unterbringt. Weitere Sternchen oder Ziffernzeichen erhöhen die Ebene:

Siehe auch: Wikistile für Listen sowie die Kochbuch-Rezepte Cookbook:OutlineLists und Cookbook:NumberedHeaders (letztere sind nur auf Englisch verfügbar).

Definitionslisten

Definitionslisten werden erzeugt, indem man am Zeilenanfang einen Doppelpunkt einfügt und dann einen weiteren Doppelpunkt zwischen Ausdruck und Definition hinzufügt.

Leerzeichen am Zeilenanfang

Einrückung mit Leerzeichen in Aufzählungen: Jede Zeile, die mit Leerzeichen beginnt und genauso weit eingerückt ist, wie ein vorangegangener Aufzählungseintrag, wird so behandelt, als gehöre sie zu diesem Aufzählungseintrag. Der Text wird also wie gewöhnlich zusammengefasst und umgebrochen und die (:linebreaks:)-Direktive wird beachtet.

Einrückungen mit Leerzeichen in Listen: Wie bei Aufzählungen kann ein Listenelement über mehrere Zeilen gehen und ein Unterpunkt durch passende Einrückung erzeugt werden (anstatt mit '**').

Einrückungen mit Leerzeichen in Definitionslisten: die Einrückung wird nur von der Zahl der führenden Doppelpunkte vor den Element bestimmt.

Ansonsten werden Zeilen, die mit Leerzeichen beginnen als vorformatierter Text behandelt. Dieser wird mit fester Zeichenbreite dargestellt und es findet kein automatischer Zeilenumbruch statt. (Ein gewünschter Zeilenumbruch kann mit Formatierungsanweisungen explizit definiert werden.)

Horizontale Linie

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

Hervorhebungen und Zeichenformatierungen

• Text umrahmt von jeweils zwei aufeinanderfolgenden Apostrophen (''), z. B. zwei Apostrophe, wird hervorgehoben (üblicherweise kursiv).
• Text umrahmt von jeweils drei Apostrophen ('''), z. B. drei Apostrophe, wird stark hervorgehoben (üblicherweise fett).
• Text umrahmt von jeweils fünf Apostrophen (''''') kombiniert die beiden Effekte (also fett kursiv).
• Zwei "Klammeraffen" (at-Zeichen) (@@) ergeben Schreibmaschinenschrift, d.h. Text mit fester Zeichenbreite.
• Benutze [+groß+] für großen Text, [++größer++] für größer, [-klein-] für kleinen Text und [--kleiner--] für kleiner.
• 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.
• '~italic~' und '*bold*' können über Einträge in der Konfigurationsdatei 'config.php' verfügbar gemacht werden.

Weitere typographische Formatierungen:

• `WikiWort WikiWort neutralisieren

Siehe auch Wikistile für fortgeschrittenere Formatierungen.

Verweise

• Wörter und Sätze in doppelten eckigen Klammern (beispielsweise [[text formatting rules]]) erzeugen Verweise zu anderen Seiten innerhalb des Wikis.
• Bei manchen (vor allem älteren) Installationen von PmWiki erzeugen zusammengefügte Worte mit Grossbuchstaben (so genannte WikiWörter) automatisch einen Verweis auf eine andere Seite in diesem Wiki, auch ohne sie in doppelte Klammern zu setzen.
• Internetadressen (URLs) mit Protokollangabe (URI-Schema-Angabe) "http:", "ftp:", "gopher:", "mailto:", oder "news:" erzeugen automatisch Verweise, z. B. http://www.pmichaud.com/toast.
• Internetadressen mit Endungen wie .gif, .jpg, or .png werden als Bilder in der Seite dargestellt.
• Verweise mit beliebigem Text können entweder als [[Ziel | Beschreibung]] oder [[Beschreibung -> Ziel]] erzeugt werden. Beschreibung kann auch eine Internetadresse einer Grafik sein. In diesem Fall wird die Grafik ein Verweis auf die weitere Internetadresse oder ein WikiWort.
• Anker (Lesezeichen) innerhalb von Seiten (#-Verweise) können durch [[#Lesezeichen]] gesetzt werden.

Überschriften

Überschriften entstehen durch ein Ausrufezeichen (!) am Zeilenanfang. Aufeinander folgende Ausrufezeichen erzeugen Überschriften niedrigerer Ebenen. Zum Beispiel:

Beachten Sie, dass die Überschrift erster Ordnung schon für den Seitentitel verwendet wird, jedenfalls beim PmWiki-Skin, beginnen Sie also mit der zweiten Ordnung, um wohlgeformte, suchmaschinenoptimierte Texte zu erzeugen.

Siehe Cookbook:Numbered Headers für nummerierte Überschriften.

Escape-Sequenzen

Alles, was in [= und =] eingefasst ist, wird von PmWiki nicht interpretiert. Damit wird es einfach, spezielle Formatierungen abzuschalten und WikiWörter zu neutralisieren, die keine Verweise sind (hier ist es jedoch einfacher ein Akzentzeichen ` davor zu setzen, Beispiel: `WikiWort).

Die Formatierungsanweisung [= und =] kann auch über mehrere Zeilen (auch leere Zeilen) hinweg angewendet werden. Damit ist es sehr einfach möglich, mehrere Zeilen Quelltext einzuschließen, Dieser Quelltext wird dann mit fester Zeichenbreite angezeigt und wird nicht von PmWiki interpretiert. Einfach ein Leerzeichen vor das öffnende [= setzen und mit =] abschließen. Beispiel:

 
Bei ''mehreren'' Zeilen wird
der Umbruch übernommen '''und'''
der Text in fester Zeichenbreite
gesetzt.

Für vorformatierte Textblöcke kann die Formatierungsanweisung [@...@] genutzt werden:

Hier ist Quelltext [[PmWiki.PmWiki]]
$CurrentTime $[by] [=$ChangeSummary=]; #einfach etwas Quelltext

Ein mehrzeiliges [@...@] ist ein Block. Um den Stil dieses vorformatierten Textes zu ändern, muss man einen "block"-Wikistil einsetzen.

 
  Die Zeichenfarbe 
  dieses Textes ist blau.

Es ist auch praktisch, [= =] innerhalb anderer Wiki-Strukturen zu nutzen, weil man damit Zeilenumbrüche in Texten originalgetreu übernehmen kann. Das folgende Beispiel zeigt, wie man einen mehrzeiligen Text in ein verstecktes Feld eines HTML-Formulars übernehmen kann.

(:input hidden message "[=Line1
Line2=]":)

Kommentare

(:comment Eine Information:) kann sehr hilfreich für nachfolgende Autoren sein, insbesondere bei komplizierten Markup-Konstruktionen.

Sonderzeichen

Wenn man eine Seite erzeugt, ist es gebräuchlich, ein kommerzielles Trademark, ein Copyright, Umlaute und andere nicht auf der Tastatur erreichbaren Symbole zu benutzen.

Diese Tabelle zeigt eine Liste einiger Sonderzeichen, welche PmWiki unterstützt.

ISO-Standard-Codes

PmWiki unterstützt die HTML-Spezialzeichen-Listen von der W3C W3C-Seite der 'Special Character codes ISO standard'.

Für eine hübsche Tabelle aller erreichbaren Sonderzeichen, siehe Liste der Unicode-Zeichen auf Wikipedia.

Viele weitere Zeichen können als numerische Entity der Form &#nnnn; geschrieben werden, wobei nnnn eine Dezimalzahl ist, die numerische Zeichenreferenz eines Unicodezeichen. Z. B. ist µ ein "µ" oder Ɲ ein exotisches "Ɲ".

Andere Wege der Eingabe

Zeichentabelle

Suchen Sie die Zeichentabelle Ihres Rechners (Windows7: Klicken Sie auf 'Start' und geben Sie 'Zeichentabelle' oder besser 'charmap.exe' in das Suchfeld ein, wählen Sie die Zeichentabelle aus dem Suchergebnis aus). Klicken Sie auf das Symbol, das Sie interessiert und sehen Sie auf die Information am Fuß des Fensters. Geben Sie dann das Zeichen ein, indem Sie die 'Alt'-Taste gedrückt halten und auf dem Ziffernblock die angezeigte Nummer eingeben (jedoch nicht auf der Ziffernreihe oben auf der Tastatur).

© = Alt+0169 = © | ® = Alt+0174 = ® | ° = Alt+0176 = ° (degrees).

Einfügen

• Benutzen Sie Word oder eine andere Desktopanwendung, um Ihren Text mit den besonderen Zeichen zu erzeugen. Kopieren Sie den Abschnitt und fügen Sie ihn in die Wikiseite ein, die Sie erzeugen oder ändern.
• Suchen Sie das besondere Zeichen in einer Onlinedokumentation, kopieren Sie es und fügen Sie es in den Wikitext ein.

Siehe auch: die Auflistung von Sonderzeichen und die Liste spezieller Zeichen.

Tabellen

Tabellen entstehen durch Einfassen der Zelleninhalte mit '||'. Eine Zelle mit Leerzeichen am Anfang und Ende wird zentriert, eine Zelle mit Leerzeichen am Anfang wird rechtsbündig und alle anderen Zellen werden linksbündig dargestellt. Eine leere Zelle veranlasst die vorherige zelle über mehrere Spalten zu gehen. (Es gibt derzeit keinen Mechanismus um mehrere Spalten zusammen zu fassen.) Eine beginnend mit '||' definiert die Attribute für nachfolgende Tabellen. Ein '!' als erstes Zeichen einer Zelle hebt den Inhalt hervor um eine Überschrift zur Verfügung zu stellen – ziemlich praktisch.

Siehe auch Tabellendirektiven für die Erzeugung fortgeschrittener Tabellen.

Etwas nicht gefunden?

Siehe Übersicht über Textauszeichnungen, Einfache Tabellen, erweiterte Tabellen, Zeichen-Textauszeichnungen, Zeilen-Textauszeichnungen, Blockmarkup oder Verweise. für die Liste aller Seiten