Andreas.Czak: https://de.wikipedia.org/w/index.php?title=Vorlage:TOC_limit

2025-01-16T09:53:02Z

https://de.wikipedia.org/w/index.php?title=Vorlage:TOC_limit

Neue Seite

<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
{{TemplateData|JSON=
{ "description": "Gliederungstiefe des [[Hilfe:Inhaltsverzeichnis|Inhaltsverzeichnisses]]<noexport> (TOC)</noexport> beschränken; und an dieser Stelle das Inhaltsverzeichnis anzeigen<noexport>.<br />
Dies kann besonders bei langen, stark gegliederten Seiten hilfreich sein, um dem Leser ein übersichtliches Inhaltsverzeichnis zu präsentieren. Die Vorteile von Überschriften innerhalb der Seite bleiben erhalten, auch wenn sie nicht mehr im Inhaltsverzeichnis angezeigt werden. Über ihren Bearbeitenlink können Abschnitte weiterhin schneller bearbeitet werden und Nutzer von Hilfsmitteln können die Überschriften direkt anspringen ([[Wikipedia:Barrierefreiheit]]).</noexport>",
"params": {
"1":
{ "label": "Tiefe",
"description": "Level der letzten eingeblendeten Überschriften; identisch der Anzahl von Gleichheitszeichen, die noch angezeigt werden. Sinnvolle Werte: 2–5",
"suggested": true,
"type": "number",
"default": "3",
"example": "4",
"aliases": [ "limit" ] }
},
"format": "inline"
}
|TOC=1}}

== Kopiervorlagen und Wirkung ==

Ohne Angabe des Parameters werden zwei Gliederungsebenen (<code>== … ==</code> und <code>=== … ===</code>) angezeigt:
<syntaxhighlight lang="wikitext" copy>
{{TOC limit}}
</syntaxhighlight>

Für die Anzeige weiterer Ebenen ist die gewünschte Tiefe über den Parameter anzugeben, der die angezeigte Tiefe des Inhaltsverzeichnisses einstellt. Diese Parameter-Zahl entspricht in der Regel der Überschriftenebene. Die Überschriftenebene 1 (<code style="white-space:nowrap">= … =</code>) wird normalerweise nicht manuell in Seiten eingesetzt und ist vom Inhaltsverzeichnis ausgeschlossen. Die Zählung des Parameters ist daher immer um 1 höher als die Anzahl der angezeigten Gliederungsebenen. Mehr als fünf Gliederungsebenen werden derzeit nicht von der [[MediaWiki]]-Software unterstützt.

Mit dem Parameter-Wert 4 werden also drei Gliederungsebenen (Überschriftenebene 2, also <code style="white-space:nowrap">== … ==</code>, bis einschließlich Überschriftenebene 4, also <code style="white-space:nowrap">==== … ====</code>) angezeigt:<br />
<code><nowiki>{{TOC limit|4}}</nowiki></code>

{| class="wikitable"
|-
! Code
! Anzahl Gliederungsebenen
! Vorschau
|-
| <syntaxhighlight lang="wikitext" inline>{{TOC limit|2}}</syntaxhighlight>
| 1 (bis <code>== … ==</code>)
| 1 Überschrift
|-
| <syntaxhighlight lang="wikitext" inline>{{TOC limit|3}}</syntaxhighlight> bzw.
<syntaxhighlight lang="wikitext" inline>{{TOC limit}}</syntaxhighlight>
| 2 (bis <code>=== … ===</code>)
| 1 Überschrift
<div style="margin-left:1em">1.1 Überschrift</div>
|-
| <syntaxhighlight lang="wikitext" inline>{{TOC limit|4}}</syntaxhighlight>
| 3 (bis <code>==== … ====</code>)
| 1 Überschrift
<div style="margin-left:1em">1.1 Überschrift</div>
<div style="margin-left:2em">1.1.1 Überschrift</div>
|-
| <syntaxhighlight lang="wikitext" inline>{{TOC limit|5}}</syntaxhighlight>
| 4 (bis <code>===== … =====</code>)
| 1 Überschrift
<div style="margin-left:1em">1.1 Überschrift</div>
<div style="margin-left:2em">1.1.1 Überschrift</div>
<div style="margin-left:3em">1.1.1.1 Überschrift</div>
|}

== Beispiele ==

=== Beispiel mit sauberer Gliederung ===
Mit <code><nowiki>{{TOC limit}}</nowiki></code> wird

== Weblinks ==
=== Neue Weblinks ===
==== Weblinks von 2009 ====
==== Weblinks von 2010 ====
==== Weblinks von 2011 ====
=== Alte Weblinks ===
== Einzelnachweise ==

zu

1 Weblinks
1.1 Neue Weblinks
1.2 Alte Weblinks
2 Einzelnachweise

=== Beispiel mit unsauberer Gliederung ===

Werden Überschriftenebenen ausgelassen, werden die Überschriften dennoch dem Inhaltsverzeichnis hinzugefügt und fortlaufend nummeriert. In diesem Fall entspricht die Zahl des Parameters nicht mehr der Zahl der Überschriftenebene.

Mit <code><nowiki>{{TOC limit}}</nowiki></code> wird

== Weblinks ==
==== Neue Weblinks ====
=== Alte Weblinks ===
== Einzelnachweise ==

trotzdem zu

1 Weblinks
1.1 Neue Weblinks
1.2 Alte Weblinks
2 Einzelnachweise

da das Inhaltsverzeichnis zwei Gliederungsebenen anzeigt, auch wenn diese nicht semantisch korrekt direkt aufeinander folgen.

== Ort der Einbindung ==
Diese Vorlage soll unter der Einleitung, am Ort des Inhaltsverzeichnisses, eingesetzt werden.

== Technische Umsetzung ==
Diese Vorlage ergänzt eine passende CSS-Klasse <code>toclimit-</code>''n'' für ein umschließendes Block-Element.
<includeonly>
[[Kategorie:Vorlage:Formatierungshilfe]]
[[Kategorie:Vorlage:TOC| TOC limit]]
</includeonly>

Vorlage:TOC limit/Doku - Versionsgeschichte

Andreas.Czak: https://de.wikipedia.org/w/index.php?title=Vorlage:TOC_limit