How to: Einen Namespace als Seitensammlung führen

Manche Namespaces sind keine Ordner, sondern ein Dokument mit vertiefenden Unterseiten – z. B. eine Anleitung, deren Kapitel eigene Seiten sind.

Der Marker ~~COLLECTION~~ auf der start-Seite des Namespace macht ihn zur Sammlung: Im Menü trägt er die Mehrdokumenten-Ikone statt des Ordners und steht für das ganze Dokument; ein Doppelklick auf den Namen öffnet seine Start-Seite.

Erste Zeile der start-Seite des Namespace:

~~COLLECTION~~
====== Titel der Sammlung ======

Einleitung ...

• Klickverhalten: Wie jeder Namespace-Knoten klappt eine Sammlung per Klick auf und zu, ohne die Seite zu wechseln. Zur Start-Seite führen ein Doppelklick auf den Namen oder die Eingabetaste, wenn die Zeile den Tastaturfokus hat. Ältere Fassungen (bis 1.5.0) öffneten die geschlossene Sammlung per Klick und wechselten zugleich zur Start-Seite; das gilt nicht mehr.
• Die start-Seite erscheint nie als eigenes Kind-Blatt – der Sammlungs-Knoten steht für das Dokument und führt selbst zu ihr.
• In den fokussierten Modi (ns=auto, startns=current) wird eine Sammlung nie Menü-Basis: Die Basis verlagert sich zum Eltern-Namespace der äußersten Sammlung, der Knoten erscheint dort aufgeklappt neben seinen Geschwistern. Sammlungen dürfen verschachtelt werden.
• Der Marker wirkt erst, nachdem die Start-Seite einmal gerendert wurde (Metadaten); er liegt nur in den aktuellen Metadaten und verschwindet nach dem Entfernen von selbst.
• Namespaces ohne lesbare Start-Seite (partial) können keine Sammlung sein – es gäbe kein Navigationsziel.
• Der Marker ist DokuWiki-Syntax; in Markdown-Seiten (wvdsmd/wvdsdwmd) wird er nicht erkannt. Auf der Seite selbst rendert er nichts Sichtbares.

• Produktives Beispiel: de:wiki:php:gw:admin (Sammlung mit verschachtelten Sammlungen windows/linux)
• Syntax-Referenz: COLLECTION-Marker
• Überblick