MediaWiki/Überschriften

Aus Foxwiki
Version vom 16. Februar 2023, 10:30 Uhr von Dirkwagner (Diskussion | Beiträge) (Textersetzung - „MediaWiki:Syntax“ durch „MediaWiki:Anleitung“)

Abschnitte, Kapiteln und Unterkapiteln

  • Überschrift dient vor allem als Kennzeichnung für einen Abschnitt in einer Seite.
  • Das dient später als Gliederung, da die Wiki automatisch ein Inhaltsverzeichnis vor dem ersten Abschnitt erstellt.
  • Eine Überschrift ist übrigens ein Schlagwort, kein Text!

Kapitel

Diese Überschrift dient als Kennzeichnung für ein Kapitel unter einem Abschnitt. Kapiteln sollten dann angelegt werden, wenn ein Abschnitt zu groß ist. Es ist übrigens wünschenswert, möglichst kurz und knapp seine Informationen reinzuschreiben. Einen ganzen Roman zu erstellen, ist nicht empfehlenswert.

Unterkapitel

Diese Überschrift dient als Kennzeichnung für ein Unterkapitel. Unterkapitel sollten nur so wenig wie möglich eingesetzt werden, da darunter die Lesequalität leidet.


Überschrift

Eine Überschrift kann man so setzen:

= Überschrift =

Ein Kapitel unter einer Überschrift ist:

== Kapitel ==

Und ein Unterkapitel unter einem Kapitel ist:

=== Unterkapitel ===
  1. Überschriften nicht
    • zusätzlich formatiert
    • manuell nummerieren

Es ist üblich, zur besseren Erkennbarkeit je ein Leerzeichen zwischen die Gleichheitszeichen und die Bezeichnung zu setzen.

Generell wird vor jeder höherrangigen Überschrift eine Leerzeile gesetzt. Bei sehr tiefgestaffelten Strukturen entfällt dies gelegentlich für H5 oder H4. Betreffend einer allfälligen Leerzeile nach Überschriften gibt es keine allgemein gültigen Regeln bzw. es gibt keinen Konsens dazu. Innerhalb eines Artikels sollen etwaige Leerzeilen nach Überschriften aber einheitlich gesetzt werden.

Bis zu sechs Gleichheitszeichen sind möglich.Vorlage:Hilfe Diese Seite behandelt die Gliederung und Darstellung des Inhaltsverzeichnisses in Wikipedia-Artikeln. Das Inhaltsverzeichnis erscheint standardmäßig ab der Verwendung von vier Überschriften unmittelbar oberhalb der ersten Überschrift auf einer Seite, ohne dass Wikiautoren hierfür extra Wiki-Syntax schreiben müssten.

Gliederung

Ein Inhaltsverzeichnis dient dem Leser zur Orientierung und zum gezielten Springen in den Text, ohne ihn durchlesen zu müssen. Folgende Empfehlungen gibt es zu Umfang und Bezeichnungen in einem Inhaltsverzeichnis:

Gliederungsebenen

Im Inhaltsverzeichnis werden alle als Überschrift markierten Texte angezeigt und der Ebene entsprechend eingerückt. Über einen Mausklick im Inhaltsverzeichnis gelangt man zum entsprechenden Abschnitt.

Diese Texte werden im Quelltext von je zwei oder mehr Gleichheitszeichen umgeben (== Überschrift ==).

Eine Untergliederungsebene sollte nur angelegt werden, wenn sie mindestens aus zwei Unterabschnitten besteht; es sollte also im Regelfall keinen Abschnitt 2.1 geben, ohne dass es auch einen Abschnitt 2.2 gibt. Eine Ausnahme kann ein standardisiertes Gliederungsschema sein, das einheitlich in mehreren Artikeln (oder mehreren Abschnitten eines Artikels) angewandt wird, falls einmal nur ein Unterabschnitt vorhanden ist.

Überschriften, die nicht im Inhaltsverzeichnis erscheinen sollen

Bei Überschriften, die nicht im Inhaltsverzeichnis erscheinen sollen, sind zwei Fälle zu unterscheiden, einerseits Wikipedia-interne Seiten und andererseits normale Artikeltexte („Artikelnamensraum“).

  • In Wikipedia-internen Seiten wie Diskussionsseiten oder Hilfeseiten wie dieser ergibt sich diese Anforderung typischerweise, wenn eine Überschrift nur zu Layoutzwecken angezeigt werden soll, ohne ein neues Thema einzuleiten. Hierzu ist die Vorlage Vorlage:Vorlage geschaffen worden. Sie soll in Artikeln nicht verwendet werden, weil sie nur das Design der Skin imitieren. Eingesetzt wird sie auch im Kopf von Unterseiten, die im Artikelnamensraum auch nicht vorkommen.
  • Im Artikelnamensraum ergibt sich diese Anforderung, wenn ein Kapitel eine große Zahl langer oder komplizierter Unterüberschriften besitzt, die aber nicht so bedeutend sind, dass sie im Inhaltsverzeichnis erscheinen müssten. Auch einzelne Unterteilungen, die kein zweites Unterkapitel derselben Gliederungsebene erlauben (s. o.), erzeugen ein solches Problem. In der Regel sollten alle Gliederungspunkte gleichermaßen im Text wie im Inhaltsverzeichnis aufgeführt werden.
    • Um bei langen Artikeln mit großer Gliederungstiefe arbeiten zu können, ohne dass das Inhaltsverzeichnis lang und unübersichtlich wird, steht die Vorlage:TOC limit zur Verfügung.
    • Optische Zwischenüberschriften, die nicht als Gliederungspunkte ausgewiesen werden, lassen sich durch Fettschrift erzielen.
      • Im Quelltext wird Fettschrift durch '''Überschrift''' generiert.
      • Falls mit normalem Text fortgesetzt wird, kann mit anschließender Leerzeile oder auf anderen Wegen der erforderliche Zeilenumbruch erreicht werden.
      • Folgt eine Aufzählung, Tabelle oder dergleichen, dann generieren diese ohnehin einen unabhängigen Block.
    • Bei einer Tabelle ist es ggf. sinnvoller, ihre Überschrift in die Tabelle einzubeziehen. Sie bleibt dann immer fest mit der nachfolgenden Tabelle verbunden. Im Quelltext ist das Syntaxelement |+ optimal.

Kapitelbezeichnungen

In Wikipedia:Wie schreibe ich gute Artikel, Wikipedia:Formatvorlage und Wikipedia:Formatierung ist indirekt beschrieben, welche Kapitelbezeichnungen gute Artikel verwenden sollten. Generell haben sich für die Kapitel am Ende eines Artikels folgende Kapitelbezeichnungen für die Verweise bewährt:

Von verschiedenen Seiten gibt es Bemühungen, eine weitergehende Standardisierung voranzutreiben und ggf. auch eine neue Gliederungsform einzuführen. Die Diskussion befindet sich noch am Anfang, sodass der Wikiautor sich weiterhin an den bisherigen gängigen Artikeln orientieren sollte, wie z. B. dem Artikel Baum.

Gleichlautende Abschnittsbezeichnungen

In einer hierarchischen Gliederung können sich Bezeichnungen der Abschnitte wiederholen, wenn gleichartig strukturierte Untergliederungen benutzt werden. Dann wäre die Verlinkung auf einen anderen als den ersten Abschnitt von außen nicht möglich. Zur Lösung dieses Problems siehe Hilfe:Überschrift #Anker und Sprungadresse.

Alternative Inhaltsverzeichnisse

Neben dem automatisch generierten Standard-Inhaltsverzeichnis lassen sich auch zusätzlich oder alternativ individuelle Inhaltsverzeichnisse einfügen.

  • Vorlage:Vorlage ist eine Vorlage und ermöglicht die Anzeige eines horizontalen alphabetischen Inhaltsverzeichnisses, die auch als Navigationsleiste verwendet werden kann. Für besonders viele, kurze Überschriften eignet sich die vertikale Darstellung des automatischen Inhaltsverzeichnisses nicht. Für vollständige alphabetische Listen (im Format == A ==, == B == … mit allen Buchstaben A–Z) gibt es diesen Baustein, der das automatisch generierte Inhaltsverzeichnis abschaltet und stattdessen eine horizontale Navigationsleiste mit allen Buchstaben des Alphabets einfügt.

Zu Varianten der Vorlage:TOC und anderen Methoden siehe Kategorie:Vorlage:TOC, und im Besonderen die Dokumentation zu Vorlage:TOC Artikel.

Darstellung

Die Darstellung eines Inhaltsverzeichnisses lässt sich in Wikipedia an drei verschiedenen Stellen beeinflussen: im Seitencode, in den Benutzereinstellungen und für PowerUser auch per CSS-Einstellungen.

Optionen im Seitencode

Die Standardeinstellung von Wikipedia ist, dass ein Inhaltsverzeichnis bei mehr als drei Überschriften automatisch generiert wird.

  • __FORCETOC__ oder __INHALTSVERZEICHNIS_ERZWINGEN__ erzwingt ein Inhaltsverzeichnis, auch wenn weniger als vier Überschriften vorhanden sind.
  • __TOC__ oder __INHALTSVERZEICHNIS__ ermöglicht, dass das Inhaltsverzeichnis an einer anderen Stelle im Text als standardmäßig vor der ersten Abschnittsüberschrift angezeigt wird.
  • __NOTOC__ oder __KEIN_INHALTSVERZEICHNIS__ hingegen schaltet die Anzeige des Inhaltsverzeichnisses ab.
  • Vorlage:Vorlage und Vorlage:Vorlage bewirken, dass das Inhaltsverzeichnis an dieser Stelle rechts bzw. links in den Text eingegliedert wird. Dadurch kann Platz gespart werden. Diese Vorlagen sollten nicht im Artikelnamensraum verwendet werden.
  • Vorlage:Vorlage beschränkt die Gliederungstiefe des Inhaltsverzeichnisses, so bleibt auch in stark gegliederten Artikeln das Inhaltsverzeichnis übersichtlich.

Optionen in den Benutzereinstellungen

In den persönlichen Einstellungen können angemeldete Benutzer veranlassen, dass Überschriften automatisch bei ihrem Auftreten in der Seite nummeriert werden und so auch im Inhaltsverzeichnis erscheinen. Vorlage:Hilfe/pref

Optionen per CSS

Als angemeldeter Benutzer kannst du mittels CSS das Inhaltsverzeichnis visuell deinen Bedürfnissen anpassen. Deine persönlichen CSS-Seiten – etwa common.css für Skin-übergreifende Anpassungen oder vector.css, um das Standard-Skin Vector anzupassen – dienen diesem Zweck. Unter Wikipedia:Technik/Skin/CSS findest du weitere Beispiele. Beachte dabei, dass in MediaWiki:Common.css und MediaWiki:Vector.css etc. bereits Anpassungen stehen, die für alle Benutzer gelten.

Inhaltsverzeichnis …

/* … ausblenden */
.toc {
   display: none;
}

/* … farblich absetzen */
.toc {
   background-color: #FFFFF0;
}

Beschriftung „Inhaltsverzeichnis“ an dessen Kopfende …

/* … ausblenden */
.toctitle {
   display: none;
}

/* … halb so groß */
.toctitle {
   font-size: 0.5em;
}

Abschnittsnummern im Inhaltsverzeichnis …

/* … ausblenden */
.tocnumber {
   display: none;
}

/* … farblich absetzen */
.tocnumber {
   background-color: #E0FFFF;
}

Einrückung

/* Kein Umbruch zwischen Abschnittsnummern und Abschnittstitel, innerhalb Abschnittstitel aber schon; 
 * bewirkt, dass umbrochene Abschnittstitel links bündig sind */
.toc li		{ white-space: nowrap; }
.toc .tocnumber	{ display: inline-block; vertical-align: top; }
.toc .toctext	{ display: inline-block; vertical-align: top; white-space: normal; }

/* Einrückung bei unteren Ebenen veringern */
.toc>ul ul { margin-left:.2rem !important; }

Mehrspaltiges Inhaltsverzeichnis

(+) spart Raum in der Höhe
(−) nur moderne Browser.
/* Beschriftung „Inhaltsverzeichnis“ spannt über alle Spalten */
.toc .toctitle { column-span: all; }
/* Spaltenanzahl */
.toc>ul { column-count: 5; column-width: auto; column-gap: 1em; }
/* Spaltenanzahl nach Fensterbreite; Breitenwerte anpassen!  */
@media (max-width: 1540px)	{	.toc>ul	{ column-count: 4; }	}
@media (max-width: 1340px)	{	.toc>ul	{ column-count: 3; }	}
@media (max-width: 1140px)	{	.toc>ul	{ column-count: 2; }	}
@media (max-width: 940px)	{	.toc>ul	{ column-count: 1; }	}
/* Zeilen ab 3. Ebenen zusammenhalten */
.toc>ul>ul ul,
.toc>ul ul>li	{ column-break-inside: avoid; }

Fehler finden

Überschriften der ersten Gliederungsebene = Überschrift = mit nur einem Gleichheitszeichen sind unerwünscht; diese Ebene steht oberhalb der gesamten Seite. Ausgenommen sind bestimmte Projektseiten, die auf dieser Ebene nach Datum usw. eine übergeordnete Struktur festlegen. Um irrtümliche Angaben sofort finden zu können, gibt es spezielle CSS-Angaben.

VisualEditor

Menüpunkt Seitenoptionen

Mit der Bearbeitungsumgebung VisualEditor können die drei Darstellungsarten für das Inhaltsverzeichnis ebenfalls beeinflusst werden. Hilfe:Inhaltsverzeichnis/VisualEditor

Barrierefreiheit

Überschriften und das daraus gebildete Inhaltsverzeichnis helfen blinden Benutzern. Diese semantischen Elemente werden von Screenreadern erkannt und bevorzugt dargestellt. Damit wird ein Überblick über die Seite und die Navigation darin erleichtert.

Anmerkungen