Vorlage:Kategorie-via-Vorlage/Doku
Die ist die Dokumentation für die Vorlage:Kategorie-via-Vorlage. Sie wird dort ebenfalls angezeigt, weil die Dokumentation wie eine eigene Vorlage funktioniert und daher einfach eingebunden werden kann.
Was macht diese Vorlage?
Mit dieser Vorlage läßt sich über die Einbindung einer Vorlage gleichzeitig eine Kategorie setzen.
Wie verwendet man diese Vorlage?
Die Vorlage verwendet Parameter, welche mit Standardwerten versehen werden, falls man nichts weiter angibt.
Im einfachsten Fall reicht es also aus, folgenden Code in eine Seite einzufügen:
{{Kategorie-via-Vorlage}}
Ein Beispiel für den umgekehrten Extremfall, dass alle Parameter angegeben werden:
{{Kategorie-via-Vorlage|Kategorie=Drakensang|SortierschlüsselManuell={{{Sortierschlüssel|}}} }}
- Man kann jeden Parameter unabhängig von den anderen verwenden, also auch nur einen angeben und den anderen weglassen.
- Es spielt keine Rolle, in welcher Reihenfolge man die Parameter angibt.
Parameter:
- Kategorie - Standardwert ist der Name der Vorlage, in der diese Vorlage eingebunden wird. Dabei wird sowohl "Vorlage:" als auch das Wort "Navigationsvorlage" aus dem Namen gefiltert.
- SortierschlüsselManuell {{{Sortierschlüssel|}}} - Hiermit kann der Artikel, welcher die Vorlage verwendet, ausdrücklich nach einem bestimmten Schlüssel in der Kategorie einsortiert werden. Das empfiehlt sich für Leitartikel einer Kategorie: "Drakensang (Computerspiel)" sollte in der Kategorie:Drakensang nicht unter "D" einsortiert werden, sondern ganz am Anfang, also wie üblich unter "!". Also wird die {{Navigationsleiste Drakensang}} im Artikel so eingebunden: {{Navigationsleiste Drakensang|Sortierschlüssel=!}}. In der Vorlage selbst kann theoretisch ein anderes Wort als "Sortierschlüssel" für den Parameter angegeben werden; es empfiehlt sich nur nicht, da die Endnutzer dann je nach Vorlage auf verschiedene Parameternamen achten müssten. Wichtig ist in jedem Fall die Abfrage als Variable (durch {{{ |}}}). Ohne das würde allen Artikeln, die die Vorlage verwenden, ein fester Sortierschlüssel zugeordnet, was dem Sinn einer Sortierung zuwiderläuft.
Einsatzzweck
Wann immer es darum geht, eine Kategorie zusammen mit einer Vorlage zu setzen! Einige Ideen:
- Kandidaten sind Vorlagen aus den Kategorien Statische Navigation und Wiki-Element.
- Insbesondere für Navigationsvorlagen und Infokästen liegt es auf der Hand, wenn es für sie bereits eine Kategorie gibt.
Technische Dokumentation
Absolut unwichtig für normale Benutzer, nur relevant für Vorlagen-Programmierer. Daher folgt reichlich technisches Vokabular!