Seitenabfolge

Die Seitenabfolge ermöglicht es Autoren, eine Art 'virtuelle Führung' durch eine Abfolge mehrerer Seiten eines Wikis zu erstellen. Sie geben einfach die Seiten und ihre Reihenfolge (Trail genannt) in einem Seitenabfolgeverzeichnis an, das ist eine Seite mit einer Liste von Verweisen auf die gewünschten Seiten. Dann fügen Sie die Navigations-Auszeichnung in die entsprechenden Seiten ein, durch die Sie so hindurchführen wollen.

(Verwechseln Sie die Seitenabfolge nicht mit der Seitenlisten -Direktive — das sind zwei verschiedene Schuhe, wie es in FAQ erklärt wird.)

Abfolgentypen

PmWiki definiert drei Seitenabfolgen-Auszeichnungen:

• <<|Seitenabfolgeverzeichnis|>> wird zu "<< VorigeSeite | Seitenabfolgeverzeichnis | FolgendeSeite >>".
• <|Seitenabfolgeverzeichnis|> wird zu "< VorigeSeite | Seitenabfolgeverzeichnis | FolgendeSeite >", wobei der entsprechende Pfeil am Anfang oder Ende der Abfolge weggelassen wird.

und für einen Pfad:

• ^|[[Seitenabfolgeverzeichnis]]|^

Die Seitenabfolge wird oft in einem GroupHeader oder einem GroupFooter eingesetzt.

Schreibweisen der Seitenabfolgeverweise

Die Seitenabfolgeverweise haben die gleiche Schreibweise wie normale Verweise, das heißt, dass Sie zum Beispiel das Folgende schreiben können:

• <|[[Seitenabfolgeseite| +]]|>
• <<|[[Seitenabfolgeseite| eine Beschreibung]]|>>

Seitenabfolgeverweise können durch Anker eingeschränkt werden. Anker verweisen auf eine bestimmte Stelle in einer Seite, das bedeutet, man kann mehrere Abfolgen in einem Seitenabfolgeverzeichnis haben oder die Abfolge erst an einer bestimmten Stelle der Seite beginnt.

• <|[[Seitenabfolgeseite(#trailanfang#trailende)]]|>

Erzeugung einer Abfolge

Um eine Seitenabfolge durch einen Satz von Seiten zu erzeugen, erstellt der Autor ein "Seitenabfolgeverzeichnis", das ist eine separate Seite, die die Reihenfolge der Seiten entweder als normale oder nummerierte Liste oder als Definitionsliste vorgibt. Insofern erzeugt jede Liste von Links implizit auch eine Seitenabfolge.

Es ist sehr wichtig, dass die Seitennamen-Verweise das erste Element nach einem Listenzeichen (Punkt oder Nummer) sind. Jeglicher Text oder jegliche Formatierung vor dem Verweis schließt ihn aus der Seitenabfolge aus. Wenn Sie ihre Liste formatieren wollen, können Sie ein CSS einfügen.

Ein Seitenabfolgeverzeichnis könnte z. B. folgende Liste enthalten:

[[#trailanfang]]
* [[Installation]] eine Anleitung
* [[lokale Anpassungen->LocalCustomizations]]
* [[PmWiki]] etwas Text [[PmWiki Philosophy]] [-(Das letztere erscheint nicht in der Abfolge, weile ihm Text vorangeht.)-]
* Noch ein bisschen Text. [[PmWiki.WikiStyles|+]] [-(Das erscheint nicht in der Abfolge, weile es einem Text folgt.)-]
* %center%[[PmWiki/Uploads]] [-(Das erscheint nicht in der Abfolge, weil davor der [=%center%=]-Stil steht.)-]

* Some text [-(Das ist kein Link, erscheint nicht in der Abfolge, stört aber auch nicht!)-]
* [[PmWikiDe/PageLists|+]] {PmWikiDe/PageLists$:Summary}
* [[http://pmwiki.org]] [-(Das wird nicht in die Abfolge aufgenommen, weil es kein Verweis auf eine Seite ist.)-]
** [[PmWiki:InterMap]]  [-(Das erscheint nicht in der Abfolge, weil es ein [[InterMap]] Verweis ist.)-]
* [[Cookbook:Cookbook]] [-(dito)-] 
: [[PmWiki philosophy]] :  [[Design notes]] [-(Der erste Verweis in dieser Definitionsliste wird in der durch ([[TextFormattingRules#DefinitionLists | Definitionslisten]]) definierten Abfolge erscheinen, der zweite nicht. )-]
* [[#security]][[Security]] [-(Das erscheint nicht in der Abfolge, da es durch einen (verborgenen) [[Links#anchors|Anker]] angeführt wird.)-]
* %newwin%[[Links]] [-(Das erscheint nicht in der Abfolge, da es durch einen (verborgenen) [=%newwin%=]-Stil angeführt wird.)-]
* ''[[PmWiki/Troubleshooting]]''  [-(Das erscheint nicht in der Abfolge, da es durch eine (verborgene) ''kursiv''-Auszeichnung angeführt wird.)-]
[[#trailende]]

Die obige Liste erzeugt folgende Seitenabfolge:

(:pagelist trail={$FullName}#trailanfang#trailende fmt={$FullName}#traillist:)

Beobachtungen:

1. Im Allgemeinen spielen Einrückungen in der Liste keine Rolle — Seitenabfolgen sind eine lineare Folge von Seiten.
2. Eine Seite ist nur dann Teil der Seitenabfolge, wenn sie unmittelbar der Listenauszeichnung folgt.
3. Eine Liste selbst kann durch die Benutzung von Ankern eingegrenzt werden, sodass man mehrere Listen auf einer Seite aufführen kann oder um einen Teil der Liste auszuschließen.

Anwendung der Seitenabfolge

Das Erzeugen einer Seitenabfolge macht selbst noch nichts — genau genommen ist jede Seite mit einer normalen oder nummerierten Liste eine Seitenabfolge. Es wird erst dann zu einer Seitenabfolge, wenn in den Seiten der Seitenabfolge (d.h. die aufgelisteten Seiten) eine spezielle Auszeichnung untergebracht wird.

Um eine Seitenabfolge zum Laufen zu bringen, wird eine Seitenabfolgen-Auszeichnung wie z.B. <<|AbfolgeIndexSeite|>> zu einer Seite hinzugefügt. Hierbei ist AbfolgeIndexSeite die Seite, die eine Liste der Seiten aus der Abfolge enthält. PmWiki zeigt diese Auszeichnung mit Verweisen zu der vorigen und folgenden Seite einer Abfolge an.

Die Auszeichnung kann irgendwo in der Seite, im GroupHeader oder im GroupFooter erscheinen und eine Seite kann mehrere Seitenfolgen-Auszeichnungen enthalten. Wenn sie eine Seitenabfolgen-Auszeichnung auf jeder Seite eine Gruppe platzieren wollen, denken Sie darüber nach, sie im GroupHeader oder im GroupFooter einzufügen anstatt sie auf jeder Seite der Gruppe zu setzen.

Path trail

^|[[Seitenabfolgeverzeichnis]]|^ behandelt die Listenebenen als Hierarchie und zeigt den "Pfad" zum Erreichen der aktuellen Seite an (d.h. eine 'Brotkrümel'-Abfolge).

Sei die Seitenabfolge durch folgende Liste gegeben.

[[#abhier]]
* [[TableDirectives | + ]]    
* [[WikiStyles | + ]] 
** [[WikiStyleExamples | + ]]
** [[WikiStyleColors | + ]]
** [[WikiTrails]]
[[#bishier]]

Bei obiger Beispielabfolge würden bei der Auszeichnung ^|[[WikiTrails(#abhier#bishier)|+]]|^ auf dieser Seite die 'Brotkrümel' so aussehen:

Seitenabfolge | Wikistile | WikiTrails

Wikiadministratoren können den Trenner zwischen den Verweisen des Path trail ^|[[Seitenabfolgeverzeichnis]]|^ von der Voreinstellung '|' auf einen eigenen Trenner umstellen. Dazu setzen sie die Variable $TrailPathSep in der config.php-Datei. Zum Beispiel $TrailPathSep = ' > '; gibt "Seitenabfolge > Wikistile > WikiTrails " aus.

Kreisförmige Abfolgen

Typischerweise ist eine Seitenabfolge eine lineare Liste mit einer ersten und letzten Seite. Allerdings kann man diese "kreisförmig" machen indem man im Seitenabfolgeverzeichnis die erste Seite am Ende als letzten Eintrag nochmal wiederholt:

    
    * [[AbfolgenSeite1]]
    * [[AbfolgenSeite2]]
    ...
    * [[AbfolgenSeiteN]]
    * [[AbfolgenSeite1]]

Wenn das Seitenabfolgeverzeichnis der Seitenabfolge von allen lesbar sein soll (wie zum Beispiel unser Dokumentations-Index), kann man den letzten Eintrag auch mit %item comment% oder durch einen (:if false:)-Block unsichtbar machen:

   
    * [[AbfolgenSeite1]]
    * [[AbfolgenSeite2]]
    ...
    * [[AbfolgenSeiteN]]
    * [[AbfolgenSeite1]] %item comment%     

   
    * [[AbfolgenSeite1]]     
    * [[AbfolgenSeite2]]
    ...
    * [[AbfolgenSeiteN]]
    (:if false:)
    * [[AbfolgenSeite1]]
    (:ifend:)

Cross Group Trails

Wenn Ihre Seitenabfolge Seiten verschiedener Gruppen enthält, muss der volle [[Gruppen.Name]]-Verweis angegeben werden anstelle nur der [[Name]], jedenfalls vor Version 2.2.1.

Weitere Anmerkungen

• Es gehört kein Leerzeichen zwischen <| und [[link]] und |>; das gilt auch für die anderen Seitenabfolgen.
• Beachten Sie, dass nicht existierende Seiten in der Seitenabfolge als Link erscheint.
• Conditional markup unterstützt die ontrail -Abfrage.
• Seitenlisten bietet den trail= -Parameter an.
• Die %trail%-Auszeichnung, die in vielen Dokumentationsseiten von PmWiki erscheint, ist nur ein Wikistil, der einen grauen Hintergrund erzeugt. Er wird nicht für die Funktionsweise einer Seitenabfolge benötigt. Er ist auf der PmWikiDe.GroupHeader Seite definiert.

Trail style

PmWiki kapselt die Seitenabfolge mit einer wikitrail-CSS-Klasse ab. Das erlaubt es, die Seitenabfolge wikiweit durch einen Eintrag in die local.css-Datei anzupassen.

Trail in Seitenlisten

Trails einer einzelnen Seite können nur durch den trail -Parameter angezeigt werden. Zum Beispiel:

(:pagelist trail=PmWikiDe/WikiTrails#trailanfang fmt=PmWiki.WikiTrails#traillist order=random,$Name count=3:)

ein ganz einfaches Beispiel einer Seitenabfolge

1) In dem Seitenabfolgeverzeichnis :

* [[MyTrailPage1]]
* [[MyTrailPage2]]
* [[MyTrailPage3]]

2) in den Seiten MyTrailPage1, 2, und 3:

<<|[[TrailIndexPage]]|>>

Frage

Übersetzung von PmWiki.WikiTrails Originalseite auf PmWikiDe.WikiTrails - Backlinks
Zuletzt geändert:
PmWikiDe.WikiTrails am 01.09.2015
PmWiki.WikiTrails am 10.05.2022