Wiki:help/wikiedit/toc

Inhaltsverzeichnis erstellen (lassen)

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)]]

Unterseiten einbeziehen

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.

Ebenentiefe einschränken

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)]]

Mehrere TOC Blöcke

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.

Weitere Möglichkeiten

Es gibt noch weitere Parameter, und somit weitere Möglichkeiten, das TOC-Makro zu manipulieren. Diese werden auf der WikiMakros Seite erläutert.