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 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.
Markup | → | Resultat |
---|---|---|
''kursiver text'' | → | kursiver text |
'''fetter text''' | → | fetter text |
'''''fetter kursiver text''''' | → | fetter kursiver text |
[+groß+] oder [++größer++] | → | groß oder größer |
[-klein-] oder [--kleiner--] | → | klein or kleiner |
Andere Zeichen-Markups sind dicktengleiche Schreibmaschinenschrift, hochgestellte, tiefgestellte, unterstrichene und durchgestrichene Schrift. Wegen weiterer Informationen und Beispiele siehe Zeichen-Textauszeichnungen.
Autoren können eine Reihe von Zeilenstart-Markups1 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.
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 | Eine bedeutsame ÜberschriftEine 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 |
ebenso weit eingerückt
|
Wegen weiterer Information siehe Zeilen-Textauszeichnungen.
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.
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.
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]]
.
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.
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.
Wegen weiterer Informationen siehe Verweise.
Einige Textauszeichnungen betreffen die Darstellung mehrerer Zeilen des Textes — eben eines Blocks, siehe dazu Blockmarkup.
Autoren können diese und andere Textauszeichnungsbeispiele in der Sandkiste? testen. Dann erforschen Sie Tabellen, Bilder, Stile, Listenstile, Seitenlisten und Seitendirektiven.
<< | Dokumentations-Index | >>
Übersetzung von PmWiki.EditGettingStarted, Originalseite auf PmWikiDe.EditGettingStarted — Backlinks
Zuletzt geändert: | PmWikiDe.EditGettingStarted | am 12.07.2017 |
PmWiki.EditGettingStarted | am 03.08.2016 |