PmWikiDe/SeitenAbfolgen

Abfolgen mehrerer PmWiki-Seiten definieren

(deutsche Übersetzung der Seite PmWiki.WikiTrails, Stand 30. Dez 2004)

Das 'Seitenabfolgen'-Feature ermöglicht es Autoren, eine Art 'virtuelle Führung' durch eine Abfolge mehrerer Seiten eines Wikis zu erstellen.

• Zunächst muss der Autor dazu definieren, welche Seiten in welcher Reihenfolge zur Abfolge gehören sollen. Dies geschieht, indem auf irgendeiner Seite (im Folgenden 'Abfolgen-Index' genannt) eine Art Inhaltsverzeichnis der Abfolge erzeugt wird.
  Die einfache Regel hierfür lautet: Jede Wikiseite, deren Name als erstes Element hinter dem einleitenden Aufzählungszeichen in einer Aufzählung (egal ob nummeriert oder nicht-nummeriert) auftaucht, gehört zur Abfolge. Die zuerst referenzierten Seitennamen stehen am Beginn der Abfolge. Die Aufzählungen können beliebig durch Text unterbrochen werden -- es werden dennoch alle Seitennamen, innerhalb von Aufzählungen berücksichtigt, solange sie direkt auf das einleitende Aufzählungszeichen folgen.
  Tip: Als Abfolgen-Index kann sowohl eine bereits bestehende als auch eine neu angelegte Seite genutzt werden.
• Weiterhin muss jede Seite, die zu der im 'Abfolgen-Index' definierten Abfolge gehört, das spezielle Markup <<|[[Seitenname des Abfolgen-Index]]|>> enthalten (dies kann beispielsweise am Seitenende eingefügt werden). Dieses Markup wird dann -- entsprechend der Definition im 'Abfolgen-Index' -- durch Verweise auf die vorangehende und die nachfolgende Seite der Abfolge ersetzt.

Beispielsweise würde der Abfolgen-Index

  * [[WikiSeite1]]
  Irgendein Text
  * [[WikiSeite2]]
  ** [[WikiSeite2_1]]
  ** [[WikiSeite2_2]]  irgendein anderer Text [[WikiSeite5]] 

folgende Abfolge definieren:

  WikiSeite1 <-> WikiSeite2 <-> WikiSeite2_1 <-> WikiSeite2_2 

Beachten Sie, dass WikiSeite5 nicht Element der Abfolge ist, da es nicht direkt auf ein Aufzählungszeichen folgt.

Ein weiteres Beispiel liefert die Seite PmWikiDe.DokumentationsIndex, die eine 'virtuelle Führung' durch alle deutschen PmWiki-Dokumentationsseiten ermöglicht. Das spezielle Markup

  <<|PmWikiDe.DokumentationsIndex|>>

erscheint am Ende aller Seiten dieser Abfolge und erzeugt Verweise zur vorhergehenden und nachfolgenden Seite der Abfolge. Beachten Sie, dass dies die Neuorganisation von Seitenabfolgen (etwa das Hinzufügen neuer Seiten) sehr einfach macht: Es reicht, den 'Abfolgen-Index' (in diesem Fall PmWikiDe.DokumentationsIndex) entsprechend anzupassen.

Es sind einige zusätzliche Formatierungsanweisungen verfügbar:

• ^|[[Seitenname des Abfolgen-Index]]|^ zeigt die Zugehörigkeit einer Seite zu einer bestimmten Abfolge an. Anstelle der Verweise auf die vorangehende und die nachfolge Seite findet sich nur der Verweis auf die Abstammung.
• <|[[Seitenname des Abfolgen-Index]]|> führt dazu, dass am Anfang und am Ende der 'Führung' kein Verweis auf die vorhergehende bzw. die nachfolgende Seite angezeigt wird.

Weitere Hinweise

Das Markup %trail%, das von PmWikis Dokumentationsseiten genutzt wird, ist tatsächlich ein WikiStil, der in der PmWikiDe.GroupHeader-Seite definiert wurde. Dieses Markup nicht erforderlich, damit die Dokumentationsseiten als Abfolge verfügbar sind.

Für das spezielle Markup <<|[[Seitenname des Abfolgen-Index]]|>> können zwar wie bei normalen Verweisen doppelte eckige Klammern gebraucht werden (etwa um Seiten, die aus einem Wort bestehen, zu referenzieren), es kann allerdings kein alternativer Verweistext mittels des Senkrechtstriches | definiert werden.

Mit geringem Aufwand lässt sich das Navigationsmenü (üblicherweise Main/SideBar) als Abfolgen-Index nutzen. Zunächst sollte dazu die Menüseite Main/SideBar mit einem passenderen Titel (etwa 'Inhalte') versehen werden -- siehe dazu Cookbook/SideBarNameChange. Anschließend reicht es, das Markup <<|[[Inhalte]]|>> in der entsprechenden GroupHeader-Seite einzufügen.

With a little bit of effort you can use your Main/SideBar menu page as your TrailPage. First rename Main/SideBar into something more appropriate such as Contents - as described in Cookbook/SideBarNameChange. Then add a GroupHeader page and include in there a TrailPage as described above.

<< Passwörter | PmWikiDe.DokumentationsIndex | Kategorien? >>