Vorlage:Commonscat/Doku

Zuordnung unseres gesamten Artikels (im Abschnitt „Weblinks“) zu einer Kategorie auf Wikimedia Commons – mehr unter Wikipedia:Textbausteine/Schwesterprojekte: WP:TB/S

Vorlagenparameter

Parameter		Beschreibung	Typ	Status
Commons-Kategorie	`1`	Titel der zuzuordnenden Commons-Kategorie Standard Titel der aktuellen Wikipedia-Seite	Seitenname	optional
Linktext	`2`	alternativer Linktext, z. B. Name der Kategorie auf Deutsch Standard (Parameter 1)	Einzeiliger Text	optional
Beschreibung	`suffix`	alternativer Beschreibungstext bzw. `-` (oder veraltet `X`), um diesen zu deaktivieren Standard Sammlung von Bildern, Videos und Audiodateien	Einzeiliger Text	optional
Audio	`audio`	Audiodateien erwähnen (alternative Vereinbarung zur suffix-Beschreibung) Standard `1` Beispiel `0`	Wahrheitswert	optional
Video	`video`	Videodateien erwähnen (alternative Vereinbarung zur suffix-Beschreibung) Standard `1` Beispiel `0`	Wahrheitswert	optional
3	`3`	Hinweis	Wikitext	veraltet audio= video= suffix= verwenden

{{Commonscat}}

{{Commonscat|||audio=0|video=0}}

Die nachstehenden Quelltext-Beispiele liefern das jeweilige Ergebnis, wobei es eine solche Kategorie auf Commons nicht gibt.

{{Commonscat}}

Commons: Commonscat/Doku – Sammlung von Bildern, Videos und Audiodateien

{{Commonscat|audio=0|video=0}}

Commons: Commonscat/Doku – Sammlung von Bildern

{{Commonscat|suffix=Diese Kategorie gibt es nicht}}

Commons: Commonscat/Doku – Diese Kategorie gibt es nicht

Historisch wurde im Quelltext die Beschreibung über 3=S verkürzt – eine Vereinbarung von kryptischer Unverständlichkeit.

Zu einer Zeit, als es einige Hundert Vorlagen gab, diese mit nur wenigen Parametern ausgestattet waren, die Bearbeiter den Quelltext sahen und sich noch alle Vorlagen und Parameter auswendig merken konnten, war das einmal üblich gewesen.
Heutzutage wird zu einem nennenswerten Anteil mit VisualEditor gearbeitet, insbesondere von neuen Benutzern. Für diese ist eine solche Notation unzugänglich.
Weil die Parameter 1 und 2 nicht angegeben werden müssten, tritt häufiger die Situation auf, dass die Option für den Beschreibungstext durch Abzählen von Pipe-Symbolen festgelegt werden soll – ein fehlerträchtiges und unanschauliches Vorgehen. Deshalb wurde strategisch wie bei vielen anderen Vorlagen auch für typische Optionen nach und nach auf den benannten Parameter suffix bzw. audio=0 und video=0 migriert.
Für die Bedienung mit dem VisualEditor sind ankreuzbare Parameter günstiger; sie lassen sich schnell im Formular entscheiden. Deshalb liefern derartige Parameter audio=0 und video=0 die gleiche Aussage wie 3=S. Es lässt sich aber zusätzlich intuitiv nach Audio und Video differenziert vereinbaren.
Ein - ist globaler Standard (auch in verschiedenen unserer Vorlagen), wenn weder der Standardtext bei fehlendem Parameterwert aber auch kein anderer Text angegeben werden soll.
Die neuen Parameterwerte hinterlassen im Quelltext selbsterklärende Aussagen, die auch ohne Kenntnis der Dokumentation oder nach Transfer in ein anderes Wiki verständlich sind.

Wird diese Vorlage in einem Artikel im ANR verwendet, dem kein Datenobjekt bei Wikidata zugeordnet ist, wird die Kategorie:Wikipedia:Artikel ohne Wikidata-Datenobjekt gesetzt.