Wiki Trails

‘Navigationsbalken’ für PmWiki-Seiten

Das ‘Navigationsbalken’-Feature ermöglicht es Autoren, eine Art ‘virtuelle Führung’ durch eine Abfolge mehrerer Seiten eines Wikis zu erstellen. Hierzu erzeugt der Autor eine ‘Navigations-Seite’, auf der die Abfolge der Seiten mittels einer nummerierten oder nicht-nummerierten Aufzählungsliste definiert wird. Die Seitennamen müssen direkt auf die einleitenden Aufzählungszeichen folgen. Weiterhin muss jede zu einer Abfolge gehörende Seite die Formatierungsanweisung "<<|NavigationsSeite|>>" enthalten (in der Regel wird dies am Seitenende eingefügt). Diese Anweisung wird dann — entsprechend der Definition in der NavigationsSeite — durch Verweise auf die vorangehende und die nachfolgende Seite ersetzt.

Beispielsweise definiert die Seite PmWiki.Documentation Index eine ‘virtuelle Führung’ durch alle (englischen) PmWiki-Dokumentationsseiten. Die spezielle Formatierungsanweisung

  <<|PmWiki.DocumentationIndex|>>

erscheint am Ende aller Seiten dieser Abfolge und erzeugt Verweise zur vorhergehenden und nachfolgenden Seite der Abfolge. Beachte, das dies die Neuorganisation von Seitenabfolgen (etwa das Hinzufügen neuer Seiten) sehr einfach macht: Es reicht, die NavigationsSeite (in diesem Fall PmWiki.Documentation Index) entsprechend anzupassen.

Hinweis: Du kannst in der Formatierungsanweisung zum Erzeugen der Navigations-Verweise keine alternative Bezeichnungen verwenden. Deshalb würde Folgendes nicht funktionieren:
<<|[[DocumentationIndex Documentation of PmWiki]]|>>
Free Links dagegen funktionieren:
<<|[[Documentation Index]]|>>

Es sind einige zusätzliche Formatierungsanweisungen verfügbar:

  • ^|NavigationsSeite|^ zeigt die Zugehörigkeit einer Seite zu einer bestimmten NavigationsSeite an. Anstelle der Verweise auf die vorangehende und die nachfolge Seite findet sich nur der Verweis auf die Abstammung.
  • <|NavigationsSeite|> führt dazu, dass am Anfang und am Ende der ‘Führung’ kein Verweis auf die vorhergehende bzw. die nachfolgende Seite angezeigt wird.

Anker in NavigationsSeiten

Um von der Formatierungsanweisung [[#Anker]] in einer NavigationsSeite Gebrauch zu machen, füge den Anker ein Zeile vor der Zeile ein, auf die der Anker verweisen soll. Verweise auf den Anker führen weiterhin zu der referenzierten Zeile. Die folgende Syntax ist der richtige Ansatz für NavigationsSeiten:

 [[#Anker]]
 * SeitenName

Wenn der Anker innerhalb der Zeile platziert wird, auf die er verweisen soll, dann wird diese Zeile (und die entsprechende Seite) nicht in die Seitenabfolge der ‘virtuellen Führung’ aufgenommen. Das Folgende ist als für NavigationsSeiten falsch:

 * [[#Anker]]SeitenName

Auch die folgende Anweisung erzeugt keinerlei Aufzählungselement:

 [[#Anker]] * SeitenName

Weitere Hinweise

Die %trail% Formatierungsanweisung, die von PmWikis Dokumentationsseiten genutzt wird, sind tatsächlich [Wiki Styles]], die in der PmWiki De.Group Footer-Seite definiert wurden. Insofern ist diese Anweisung nicht erforderlich, damit die Dokumentationsseiten als Abfolge verfügbar sind.

« Passwörter | PmWiki.Documentation Index | gruppenspezifische Inhalte »



This page may have a more recent version on pmwiki.org: PmWiki:WikiTrails, and a talk page: PmWiki:WikiTrails-Talk.