toc - jbruechert/freetz.org GitHub Wiki
- Wiki Bearbeitung - Tipps und Tricks
- Wiki Goodies
- Formatierungs-Guidelines
-
Tabellen
- Überblick der verschiedenen Formate
- Anwendung: Wie erstelle ich eine Tabelle?
- Inhaltsverzeichnis erstellen (lassen)
- Tagging
- Screenshots
Am rechten Rand ist ja ein Inhaltsverzeichnis zu sehen, welches sich
sogar über mehrere Artikel erstreckt. Dafür wurde ein
Makro
verwendet, dessen genaue Syntax sich auf der soeben angegebenen Seite
findet. Damit die Überschrift hier auch auf Deutsch ist, verwenden wir
auf deutschsprachigen Seiten das Argument heading=Inhaltsverzeichnis
-
als Beispiel für ein einfaches Inhaltsverzeichnis für die aktuell
bearbeitete Seite sähe das dann so aus:
[[TOC(heading=Inhaltsverzeichnis)]]
Es lassen sich auch Unterseiten (oder ganz andere Seiten) mit einbeziehen, sodass ein Inhaltsverzeichnis entsteht, welches mehrere Artikel überspannt. Hierzu gibt man die zu indizierenden Seiten explizit an:
[[TOC(help/wikiedit,help/wikiedit/toc,help/wikiedit/goodies,heading=Inhaltsverzeichnis)]]
etwa würde die angegebenen Seiten in das automatische Inhaltsverzeichnis einbeziehen. Da man auf diese Art allerdings jedesmal, wenn eine neue Unterseite angelegt wird, das TOC-Makro auf allen beteiligten Seiten wieder anpassen müsste, geht das auch einfacher:
[[TOC(help/wikiedit,help/wikiedit/*,heading=Inhaltsverzeichnis)]]
Das ist der Vorteil eines hierarchischen Wikis: Das WildCard "*" greift nicht zu weit um sich, sondern bleibt beim Thema.
Werden die Unterseiten dann doch zahlreicher, und die mit dem TOC-Makro
zusammengefassten Überschriften sprengen ob der Schachtelungstiefe die
Seiten (etwa, weil eine oder mehrere Seiten ziemlich viele Überschriften
niedrigerer Ebenen, also quasi "2.1.3.5", haben), lässt sich die
maximale Tiefe der vom TOC-Makro anzuzeigenden Überschriften ebenfalls
einschränken, wozu der Parameter depth
herangezogen werden kann. Soll
das TOC-Makro also beispielsweise nur die Überschriften der Ebenen 1 und
2 anzeigen, sähe das so aus:
[[TOC(help/wikiedit,help/wikiedit/*,depth=2,heading=Inhaltsverzeichnis)]]
Tja, das klappt leider nicht sauber: Das themenüberspannende, jedoch auf 2 Ebenen eingeschränkte TOC-Makro mit einem seitenspezifischen zu verbinden, welches alle Ebenen umfasst. Auch ein zusätzliches, zweites TOC-Makro geht gehörig schief: Es positioniert sich nämlich nicht unterhalb des ersten, sondern unmittelbar links daneben - damit ist von der Seitenbreite dann nicht mehr viel übrig; ganz davon abgesehen, dass es ziemlich dämlich aussieht.
Was aber nun tun, wenn ein zweiter Block benötigt wird? Sofern es nur
darum geht, die Überschriften aufzulisten - und es nicht unbedingt der
"schöne gelbe Kasten da rechts" sein muss, bietet das Keyword inline
hier Abhilfe:
[[TOC(help/wikiedit,help/wikiedit/*,inline,noheading)]]
wäre etwa geeignet, den entsprechenden Index mitten im Artikel - also so, als hätte man die einzelnen Punkte mit ihren Links selbst abgetippt
- darzustellen.
Es gibt noch weitere Parameter, und somit weitere Möglichkeiten, das TOC-Makro zu manipulieren. Diese werden auf der WikiMakros Seite erläutert.