Einführung in Textauszeichnungen

für die Liste aller Seiten

PmWiki gibt Autoren viele Wege, zu ändern, wie das, was sie schreiben, auf der Seite dargestellt wird. Um das zu tun, fügen die Autoren Markups (Textauszeichnungen) hinzu — Text mit einer ganz besonderen Bedeutung — zum Inhalt der Seite. Die Übersicht über Textauszeichnungen listet alle verfügbaren Markups auf.

Zeichen-Markups

Zeichen-Markups bestehen aus öffnenden und schließenden Markierungen um einen gewählten Text. Diese sind Kombinationen aus Zeichen, die gewöhnlich nicht in einer alltäglichen Prosa vorkommen. Wenn das Wiki auf sie stößt, wandelt es die Art um, wie der eingeschlossene Text angezeigt wird.

Andere Zeichen-Markups sind dicktengleiche Schreibmaschinenschrift, hochgestellte, tiefgestellte, unterstrichene und durchgestrichene Schrift. Wegen weiterer Informationen und Beispiele siehe Zeichen-Textauszeichnungen.

Zeilen-Textauszeichnungen

Autoren können eine Reihe von Zeilenstart-Markups¹ einsetzen, um Absätze, Listen und andere Strukturen zu definieren. Zeilen-Textauszeichnungen umfassen Leerzeichen " ", Ausrufezeichen "!", Sternchen "*" und Nummernzeichen oder Raute "#". Wenn sie an den Absatzanfang gesetzt werden, wirken die Zeichen so, dass sie PmWiki Instruktionen zur Formatierung geben. Wenn sie an irgend einer andere Stelle außer dem Absatzanfang benutzt werden, sind sie einfach nur Zeichen, aber wenn sie als allererstes Zeichen in einem Absatz stehen, bedeuten sie etwas Besonderes für PmWiki.

¹ Zeile bezieht sich auf die Zeile im Quelltext, die womöglich im Editor genauso wie in der dargestellten Seite mehrfach umgebrochen sein kann. Beendet wird diese Zeile durch einen Zeilenumbruch (mit der Eingabetaste).

Wenn es keinen Zeilenstart-Markup gibt, ist der Text ein nackter Absatz. Um Text in getrennte Absätze zu gliedern, setzt man eine leere Zeile dazwischen. Aufeinanderfolgende Zeilen (ohne Leerzeilen dazwischen) werden zu einem gemeinsamen Absatz zusammengesetzt.

Um eine Überschrift zu machen, startet man die Zeile mit einem Ausrufezeichen ("!").

!! Eine bedeutsame Überschrift
!!! Eine weniger bedeutsame Überschrift

Für eine ungeordnete Liste startet man jeder Zeile mit einem Sternchen ("*").

* Bananen
* Zitronen
* Pfirsiche

Für nummerierte Listen beginnt man die Zeilen mit einem Nummernzeichen ("#").

# Nordsee
# Ostsee
# Chiemsee

Um eine Zeile ohne ein Listensymbol einzurücken (einen Absatz einzuziehen), beginne die Zeile mit einem "Pfeil" ("->")

* mit Listensymbol
-> ebenso weit eingerückt

Wegen weiterer Information siehe Zeilen-Textauszeichnungen.

Verweise (Links)

Das [[...]]-Markup verwandelt Text in einen Verweis. Mit Verweisen auf andere Wikiseiten oder anderen Websites machen es die Autoren ihren Lesern leichter, ihren Weg ringsherum zu finden. PmWiki organisiert Seiten in Gruppen — der volle Name dieser Seite ist "PmWikiDe.EditGettingStarted"; "PmWikiDe" ist die Gruppe und "EditGettingStarted" ist der Seitenname. Um auf eine andere Seite zu verweisen, muss ein Autor deren Namen kennen.

Seiten in der gleichen Gruppe

Um auf eine Seite in der gleichen Gruppe wie die aktuelle Seite zu verweisen, wie beispielsweise DocumentationIndex, schreibt man [[DocumentationIndex]]. Viele Autoren benutzen Großbuchstaben für ihre Seitennamen, aber das ist nicht zwingend notwendig; [[documentation index]] funktioniert genauso gut: documentation index. Schließlich kann man noch den Seitentitel (nicht den Seitennamen) anzeigen lassen, indem man ein Plus '+' als Verweistext einsetzt: [[documentation index|+]] mit dem Ergebnis: Dokumentations-Index.

Seiten in anderen Gruppen

Um auf Seiten in anderen Gruppen zu verweisen, so wie Main.HomePage, schreibt man [[Main.HomePage]]. Um auf eine Seite in einer anderen Grppe zu verweisen, ohne den Gruppennamen im Verweis zu zeigen, so wie in HomePage, schreibt man [[Main/HomePage]].

Seiten auf anderen Sites

Um auf eine Seite in einer anderen Site zu verweisen, so wie http://www.example.com, schreibt man [[http://www.example.com]] oder einfach http://www.example.com — das funktioniert auch.

Verweistext

Um auf ein Beispiel zu verweisen anstelle von http://www.example.com, schreibt man [[http://www.example.com|Beispiel]]. Das [[ Verweisname | Verweistext ]]-Markup funktioniert für alle Arten von Verweisen. Deshalb wird [[Main.HomePage|Einleitung]] zu Einleitung.

Mehr Verweise

Wegen weiterer Informationen siehe Verweise.

Block-Markups

Einige Textauszeichnungen betreffen die Darstellung mehrerer Zeilen des Textes — eben eines Blocks, siehe dazu Blockmarkup.

In Fahrt kommen

Autoren können diese und andere Textauszeichnungsbeispiele in der Sandkiste? testen. Dann erforschen Sie Tabellen, Bilder, Stile, Listenstile, Seitenlisten und Seitendirektiven.

<< | Dokumentations-Index | >> für die Liste aller Seiten