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?

Diese Vorlage kann in anderen Vorlagen verwendet werden, um durch deren Einbindung in Artikeln gleichzeitig eine Kategorie zu setzen.

Das Besondere dabei:

• Die Sortierung aus automatisierten Vorlagen wird übernommen.
• Artikel können anders einsortiert werden, falls beabsichtigt.

Das erspart manuelles Setzen von Kategorien, erhält jedoch deren Möglichkeiten ebenso wie die Vorteile automatisierter Vorlagen.

Wie verwendet man diese Vorlage?

Im Prinzip reicht es aus, zur Einbindung in eine Vorlage folgenden Code einzufügen:

{{Kategorie-via-Vorlage}}

Es lohnt sich jedoch, sich mit beiden Parametern zu beschäftigen, da diese weitere Möglichkeiten bieten:

{{Kategorie-via-Vorlage|Kategorie=Drakensang|SortierschlüsselManuell={{{Sortierschlüssel|}}} }}

• Man kann die Parameter unabhängig voneinander verwenden, also auch nur einen angeben und den anderen weglassen.
• Es spielt keine Rolle, in welcher Reihenfolge man die Parameter angibt.

Parameter:

• Kategorie - Damit läßt sich die Kategorie angeben, die automatisch gesetzt werden soll.
  • 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.
  • Die Vorlage:Navigationsleiste Drakensang setzt bei Verwendung dieser Vorlage also automatisch die Kategorie:Drakensang.

• SortierschlüsselManuell mit der Angabe {{{Sortierschlüssel|}}} - So kann der Artikel, welcher die Vorlage verwendet, ausdrücklich anders einsortiert werden.
  • Beispiel: "Drakensang (Computerspiel)" soll in der Kategorie:Drakensang nicht unter "D" einsortiert werden, sondern ganz am Anfang, also wie üblich unter "!".
  • Im Artikel wird die {{Navigationsleiste Drakensang}} daher so eingebunden: {{Navigationsleiste Drakensang|Sortierschlüssel=!}}.
  • In der Vorlage, die diese Vorlage verwendet, kann für den Namen der Variable etwas anderes als "Sortierschlüssel" angegeben werden. Für die Endnutzer ist es jedoch leichter, einen einheitlichen Namen verwenden zu können.
  • Entscheidend ist die Abfrage als Variable (durch {{{ |}}}) in der Vorlage. Sonst wird allen Artikeln, die die Vorlage verwenden, derselbe feste Sortierschlüssel zugeordnet!

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!

Zuerst werden aus dem Artikel, in dem die Vorlage eingebunden ist, die Werte der Attribute Sortierschlüssel bzw. Kurzname ausgelesen. Dies geschieht mit den Abfragen {{#show: {{FULLPAGENAME}} | ?Sortierschlüssel }} und {{#show: {{FULLPAGENAME}} | ?Kurzname }}. Sortierschlüssel oder Kurzname werden in verschiedenen Vorlagen automatisch gesetzt und dienen dazu, die Artikel in ebenfalls automatisch gesetzten Kategorien einzusortieren. Die ermittelten Werte werden in zwei Variablen namens SortierschlüsselAutomatisch und KurznameAutomatisch gespeichert.

Darauf aufbauend wird die Variable SortierschlüsselStandard über eine verschachtelte if-Anweisung definiert. Die Idee dahinter ist folgende: Falls einer der automatisierten Werte gesetzt ist, soll dieser zur Sortierung dienen, ansonsten der vollständige Seitenname ({{FULLPAGENAME}}). Die Syntax "Falls Inhalt der Variable gleich leer dann Standardwert ansonsten Inhalt der Variable" ergibt damit "Falls Inhalt der Variable SortierschlüsselAutomatisch gleich leer dann (Falls Inhalt der Variable KurznameAutomatisch gleich leer dann Standardwert {{FULLPAGENAME}} ansonsten Inhalt der Variable KurznameAutomatisch) ansonsten Inhalt der Variable SortierschlüsselAutomatisch".

Im nächsten Schritt wird mit der Variable SortierschlüsselBerechnet der letztendliche Sortierschlüssel festgelegt. Falls die Vorlage den Parameter SortierschlüsselManuell verwendet und die entsprechende Variable im Artikel befüllt wurde, um die Sortierung manuell festzulegen, wird diese Angabe verwendet - ansonsten die soeben ermittelte Standardangabe.

Nun kommt die Kategorien-Angabe, um die es eigentlich geht. Falls der Parameter Kategorie in der Vorlage verwendet und befüllt wurde, wird dieser Wert verwendet. Ansonsten wird der Name der Vorlage verwendet, wobei das Wort "Navigationsleiste" aus dem Namen durch nichts ersetzt wird ({{#replace:{{PAGENAME}}|Navigationsleiste|}}).