Inhaltsverzeichnis

für die Liste aller Seiten

Ein einfaches Inhaltsverzeichnis (TOC) und nummerierte Überschriften sind PmWiki 2.2.119 enthalten und kann mit dem folgenden Eintrag in der config.php-Datei aktiviert werden:

  $PmTOC['Enable'] = 1;

Dieser Zusatz basiert auf dem Rezept Cookbook:AutoTOC, ist aber ein wenig vereinfacht.

• Das Inhaltsverzeichnis erscheint automatisch, das Einfügen eines Markups ist dafür nicht nötig.
• Es wird noch vor der ersten Überschrift eingefügt.
• Voreingestellt ist, dass nur Seiten mit drei oder mehr Überschriften ein Inhaltsverzeichnis erhalten.
• Der Besucher kann das Inhaltsverzeichnis öffnen und schließen, seine bevorzugte Einstellung wird im "local storage" gespeichert.
• Der Zusatz kann die Überschriften in der Seite automatisch nummerieren.
• Überschriften in verborgenen Abschnitten ("comment" wikistyle, "display:none") werden nicht in das Inhaltsverzeichnis aufgenommen.
• Überschriften der %block notoc%-Klasse werden nicht in das Inhaltsverzeichnis aufgenommen.
• Überschriften in (:markup:)-Blöcken werden ignoriert.

Die folgenden Direktiven können den obigen Zusatz beinflussen:

• (:toc:) : Das Inhaltsverzeichnis wird an dieser Position (anstatt an der voreingestellten) eingefügt, selbst bei weniger als drei möglichen Einträgen.
• (:notoc:) : Das Inhaltsverzeichnis wird unterdrückt, selbst wenn es drei oder mehr Überschriften gibt oder eine (:toc:)-Direktive.

Das Inhaltsverzeichnis nutzt Anker oder IDs der Überschriften der Seite, wenn sie existieren, anderenfalls werden IDs (Hash) auf Grund der Seitenstruktur erzeugt. Folgende Markups erzeugen alle einen Link mit dem Anker in der Form PageUrl#here:

• !! Überschrift mit einer ID %block id=here%
• !! Überschrift mit einem Inline-Anker [[#here]], oder
• !! [[#here]] Überschrift mit einem Inline-Anker
• [[#here]]
!! Der Anker geht der Überschrift voraus

Wenn es keine ID oder keinen Anker an der Überschrift gibt, wird der Anker in der Form #toc-1.2.1 erzeugt, wobei 1.2.1 der strukturelle Pfad zu dem Abschnitt mit der Überschrift ist, in diesem Beispiel "Abschnitt 1, Unterabschnitt 2, Unter-Unterabschnitt 1".

Die folgende Konfiguration (in der local/config.php-Datei) kontrolliert die Voreinstellungen:

• $PmTOC['Enable'] = 1; # aktiviere TOC, Voreinstellung ist 'TOC ist inaktiv'.
• $PmTOC['MaxLevel'] = 6; # Überschriftenebenen, die in das Inhaltsverzeichnis aufgenommen werden, voreingestellt sind <h1> bis <h6>. Setzen Sie den Wert auf 3, um nur die Überschriftenebenen <h1> bis <h3> einzuschließen.
• $PmTOC['MinNumber'] = 3; # minimale Anzahl von Überschriften in der Seite, um ein Inhaltsverzeichnis zu erzeugen. Seiten mit wenig Überschriften sind gewöhnlich kurz und brauchen kein Inhaltsverzeichnis.
  • $PmTOC['MinNumber'] = 2; # Seiten mit 2+ Überschriften bekommen ein TOC
  • $PmTOC['MinNumber'] = -1; # Das Verzeichnis wird nicht automatisch angelegt, nur die explizite (:toc:)-Direktive wird ein Inhaltsverzeichnis in die Seite einfügen.
• $PmTOC['NumberedHeadings'] = '1.1.1.1.1.1'; # die Überschriften werden nummeriert (normalerweise deaktiviert).
  • Sie können hier die Ziffern der verschiedenen Überschriftenstufen setzen, nämlich 1 (arabische Ziffern), I or i (römische Ziffern), A or a (Buchstaben A-Z oder a-z). So setzt zum Beispiel die Wahl von
    $PmTOC['NumberedHeadings'] = 'I.1.a';
    die Nummerierung der höchsten Stufe auf römische Ziffern (Großbuchstaben: I, II, ...), die der zweithöchsten Stufe auf arabische Ziffern und die der dritthöchsten Stufe auf Kleinbuchstaben (a, b, ...). Die übrigen Stufen, falls vorhanden, werden mit arabischen Ziffern nummeriert.
• $PmTOC['EnableBacklinks'] = 1; # fügt nach den Überschriften "↑"-Pfeile ein, die zurückverweisen auf das Inhaltsverzeichnis (normalerweise deaktiviert).
• $PmTOC['ParentElement'] = "#wikitext"; # Der Abfrage-Wähler (query selector) des HTML-Elements, in das das Inhaltsverzeichnis eingefügt wird (und das dadurch zu dessen Elternelement wird). Standardmäßig wird das Inhaltsverzeichnis vor der ersten Überschrift eingefügt. Hier können Sie ein anderes Element auswählen. Wenn das Element mit dieser Konfigurationszeile ausgewählt wird, wird das Inhaltsverzeichnis ganz am Anfang dieses Elements eingefügt.

Die folgenden Zeichenketten können in der XLPage übersetzt werden, z. B. in Französisch:

  "Contents" => "Sommaire",
  "show"     => "afficher",
  "hide"     => "masquer",

Siehe auch: Cookbook:AutoTOC. Wenn Sie davor AutoTOC benutzt haben, müssen sie es deaktivieren, wenn Sie $PmTOC aktivieren. für die Liste aller Seiten