Qualitätswoche: Artikel verbessern und Crunchyroll-Premium-Abo gewinnen!
Verbessere im Rahmen der Qualitätswoche einen Artikel deiner Wahl und gewinne mit etwas |
Hilfe:Vorlagen: Unterschied zwischen den Versionen
Rikku (Diskussion | Beiträge) K (- test hilfe vorlagen;) |
Rikku (Diskussion | Beiträge) K (+param zaehler_beispiele; -inuse;) |
||
(Eine dazwischenliegende Version desselben Benutzers wird nicht angezeigt) | |||
Zeile 1: | Zeile 1: | ||
− | {{ |
+ | {{Hilfe}} |
− | |||
<!-- |
<!-- |
||
Definierte Variablen in dieser Hilfeseite: |
Definierte Variablen in dieser Hilfeseite: |
||
Zeile 30: | Zeile 29: | ||
Eine dritte Gruppe von Vorlagen sind sogenannte Funktionen. Funktionen führen eine Berechnung oder eine Transformation zu an sie übergebene Daten durch. Ein Beispiel für diese Kategorie von Vorlagen ist die [[Vorlage:KB]], die zu einem mitgegebenen Kapitel aus ''[[Detektiv Conan]]'' berechnet, in welchem Manga-Band es veröffentlicht wurde. Da diese Berechnung im Wiki häufig und in ganz verschiedenen Artikeln benötigt wird, wurde eine entsprechende Vorlage angelegt. Auch erfolgt eine mögliche Aktualisierung zentral, beispielsweise, wenn das Kapitel von den [[Freie Kapitel|Freien Kapiteln]] in einen Manga-Band wandert. Die Wiki-Autoren müssen sich nicht manuell um diese Aktualisierung in den von ihnen erstellten Artikeln kümmern. |
Eine dritte Gruppe von Vorlagen sind sogenannte Funktionen. Funktionen führen eine Berechnung oder eine Transformation zu an sie übergebene Daten durch. Ein Beispiel für diese Kategorie von Vorlagen ist die [[Vorlage:KB]], die zu einem mitgegebenen Kapitel aus ''[[Detektiv Conan]]'' berechnet, in welchem Manga-Band es veröffentlicht wurde. Da diese Berechnung im Wiki häufig und in ganz verschiedenen Artikeln benötigt wird, wurde eine entsprechende Vorlage angelegt. Auch erfolgt eine mögliche Aktualisierung zentral, beispielsweise, wenn das Kapitel von den [[Freie Kapitel|Freien Kapiteln]] in einen Manga-Band wandert. Die Wiki-Autoren müssen sich nicht manuell um diese Aktualisierung in den von ihnen erstellten Artikeln kümmern. |
||
− | |||
== {{#var:refVorlageVerwenden}} == |
== {{#var:refVorlageVerwenden}} == |
||
Zeile 38: | Zeile 36: | ||
== {{#var:refVorlageErstellen}} == |
== {{#var:refVorlageErstellen}} == |
||
<!--Hinweis: Um die Abschnittsüberschrift zu ändern, bitte die Variable "refVorlageErstellen" am Anfang dieser Hilfeseite ändern!--> |
<!--Hinweis: Um die Abschnittsüberschrift zu ändern, bitte die Variable "refVorlageErstellen" am Anfang dieser Hilfeseite ändern!--> |
||
− | {{Hilfe:Vorlagen/Erstellung| refVorlageVerwenden = {{#var:refVorlageVerwenden}} | refVorlageDokumentieren = {{#var:refVorlageDokumentieren}} }} |
+ | {{Hilfe:Vorlagen/Erstellung| refVorlageVerwenden = {{#var:refVorlageVerwenden}} | refVorlageDokumentieren = {{#var:refVorlageDokumentieren | zaehler_beispiele = {{#var:countExample}} }} }} |
== {{#var:refConanWikiVorlagen}} == |
== {{#var:refConanWikiVorlagen}} == |
||
+ | <!--Hinweis: Um die Abschnittsüberschrift zu ändern, bitte die Variable "refConanWikiVorlagen" am Anfang dieser Hilfeseite ändern!--> |
||
− | <!-- Aufbau der Kategorie:Vorlage erläutern -> Infotexte sollten als Doku-Bausteine erstellt werden; diese können dann auch auf den jeweiligen Kategorie:Seiten eingebunden werden--> |
||
{{Hilfe:Vorlagen/ConanWiki}} |
{{Hilfe:Vorlagen/ConanWiki}} |
||
Zeile 47: | Zeile 45: | ||
{{Hilfeseite Fragen|Namensraum=Vorlage}} |
{{Hilfeseite Fragen|Namensraum=Vorlage}} |
||
− | [[Kategorie:Hilfe]] |
+ | [[Kategorie:Hilfe]] |
Aktuelle Version vom 10. April 2015, 22:26 Uhr
Allgemeines
Artikelgestaltung
Artikeltypen
- Charakter-Artikel
- Detektivlexikon-Artikel
- Episoden-Artikel
- Fall-Artikel
- Film-Artikel
- Kapitel-Artikel
- Ort-Artikel
Dateien
Wiki-Gemeinschaft
Auf dieser Hilfeseite sind wichtige Hinweise für das Erstellen oder Verwenden von Vorlagen zusammengefasst. Nach einer kurzen Erläuterung was Vorlagen sind, folgt eine Beschreibung der notwendigen Schritte, um eine Vorlage auf einer Seite einzubinden. Anschließend sind Hinweise zur Erstellung von Vorlagen zusammengefasst, gefolgt von einem kommentierten Überblick über die Vorlagen hier im ConanWiki.
Ziel dieser Hilfeseite ist es, Wiki-Autoren beim Verfassen und Gestalten von Artikeln zu Unterstützen, denn es existiert bereits eine Vielzahl an Vorlagen, die in einigen speziellen Artikeltypen obligatorisch oder optional einzubinden ist. Die Seite kann ganzheitlich wie ein Artikel gelesen werden. Es empfiehlt sich jedoch, vorab einen Schwerpunkt zu setzen und die entsprechenden Abschnitte im Detail zu betrachten.
- Neueinsteigern, die wenig bis keine Erfahrungen im Wiki haben, werden daher zunächst besonders die beiden Abschnitte Was ist eine Vorlage und Vorlage verwenden empfohlen.
- Erfahrene Benutzer können sich gezielt mit den Vorlagen im Wiki auseinandersetzen. Dies ist insbesondere für die Qualitätssicherung wichtig und für Vorlagen-Entwickler, um neue oder überarbeitete Vorlagen korrekt zu dokumentieren und zu kategorisieren.
Was ist eine Vorlage[Quelltext bearbeiten]
Eine Vorlage ist eine Seite, die die Einbindung häufig verwendeter Elemente in andere Seiten erleichtert. Im einfachsten Fall handelt es sich dabei um einen vorformulierten Textbaustein. Ein Beispiel hierfür ist die Vorlage:Willkommen, die einige grundlegende Informationen zur Mitarbeit im ConanWiki enthält. Jeder neu registrierte Benutzer bekommt sie auf seiner Diskussionsseite eingebunden und der Willkommenstext wird dadurch beliebig oft wiederverwendet.
Vorlagen helfen auch dabei, ein gewisses Coorporate Design einzuhalten oder unterstützen bei komplexen Formatierungen. Ein Beispiel hierfür sind die sogenannten Infoboxen, die sich in Kapitel-, Episoden- oder anderen Artikeln zu Inhalten der verschiedenen in diesem Wiki betrachteten Serien finden. Der Autor des jeweiligen Artikels trägt die relevanten Daten zusammen und übergibt diese an die entsprechende Infobox-Vorlage. Die Vorlage übernimmt die Formatierung der Daten, sucht ein passendes Bild und stellt alles in einer kompakten tabellarischen Übersicht da. Der Autor muss sich demnach um die Präsentation seiner Daten und die dafür nötige Wiki-Syntax nicht weiter kümmern.
Eine dritte Gruppe von Vorlagen sind sogenannte Funktionen. Funktionen führen eine Berechnung oder eine Transformation zu an sie übergebene Daten durch. Ein Beispiel für diese Kategorie von Vorlagen ist die Vorlage:KB, die zu einem mitgegebenen Kapitel aus Detektiv Conan berechnet, in welchem Manga-Band es veröffentlicht wurde. Da diese Berechnung im Wiki häufig und in ganz verschiedenen Artikeln benötigt wird, wurde eine entsprechende Vorlage angelegt. Auch erfolgt eine mögliche Aktualisierung zentral, beispielsweise, wenn das Kapitel von den Freien Kapiteln in einen Manga-Band wandert. Die Wiki-Autoren müssen sich nicht manuell um diese Aktualisierung in den von ihnen erstellten Artikeln kümmern.
Vorlage verwenden[Quelltext bearbeiten]
Einbinden von Vorlagen auf anderen Seiten[Quelltext bearbeiten]
Grundsätzlich gibt es zwei Möglichkeiten, eine Vorlage in einem Artikel oder einer anderen Seite zu verwenden:
- Der Seitenname der Vorlage wird an der Textstelle, an der die Vorlage eingebunden werden soll, in zwei geschweiften Klammern angegeben:
{{<Name der Vorlage>}}
. Beim Anzeigen der Seite ersetzt die Wiki-Software diesen Code dann durch den Inhalt der Vorlage. Ändert jemand die Vorlage, werden die Änderungen automatisch auf allen Seiten sichtbar, auf denen die Vorlage eingebunden ist. - Der Vorlageninhalt wird substantiviert eingebunden. Hierbei wird dem Seitenname der Vorlage das Schlüsselwort
subst:
(für Substitution) oder auchers:
(für Ersetzen) vorangestellt:{{subst:<Name der Vorlage>}}
bzw.{{ers:<Name der Vorlage>}}
. Wird eine Vorlage auf einer Seite substantiviert eingebunden, so wird nach dem Speichern der Seite der Code durch den aktuellen Inhalt der Vorlage ersetzt. Anders formuliert, der Text aus der Vorlage wird in die Seite, auf der die Vorlage eingebunden wurde, hineinkopiert. Werden danach Änderungen an der Vorlage vorgenommen, so haben diese keine Auswirkungen auf Artikel oder andere Seiten, auf denen die Vorlage substantiviert eingebunden wurde.
Vorlagen, die ausschließlich substantiviert eingebunden werden sollen, sind in der Kategorie:Vorlage:nur Subst enthalten. Ein weiteres Beispiel ist die Vorlage:Willkommen, die bei der Begrüßung neuer Benutzer ebenfalls substantiviert eingebunden werden sollte, damit diese auf ihrer Seite auch beim Bearbeiten den Text der Begrüßung vorfinden und kein ggf. verwirrendes {{Willkommen|~~~~}}
.
Weiterhin ist zu beachten, dass der Namensraum aus dem Seitenname der Vorlage nicht mit angegeben wird, sofern die Seite im Namensraum für Vorlagen erstellt wurde. Beispielsweise ist der volle Name der o. g. Willkommen-Vorlage "Vorlage:Willkommen", wobei das Präfix Vorlage: den Namensraum kennzeichnet. Es können aber auch beliebige andere Seiten wie Vorlagen eingebunden werden. Nachfolgend ein Überblick, wie Seiten als Vorlagen eingebunden werden können:
- Liegt die Seite im Vorlagen-Namensraum, wird beim Einbinden als Vorlage der Seitenname ohne Namensraum-Präfix angegeben:
{{<Name der Vorlage>}}
. - Liegt die Seite im Artikel-Namensraum, wird beim Einbinden als Vorlage der Seitenname mit vorangestelltem Doppelpunkt angegeben:
{{:<Name der Vorlage>}}
. - Sonst: das Präfix für den Namensraum muss ebenfalls mit angegeben werden:
{{<Namensraum>:<Name der Vorlage>}}
.
Dass eine Seite als Vorlage verwendet wird, obwohl sie nicht im Vorlagen-Namensraum liegt, kann bei Vorlagen-Tests sinnvoll sein, wenn ein Benutzer eine neue Vorlage zunächst in seiner persönlichen Sandbox entwickelt und testet. Textbausteine, Formatierungshilfen oder Funktionen, die als Vorlage in Seiten in ConanWiki eingebunden und aktiv verwendet werden sollen, sind jedoch im Vorlagen-Namensraum zu erstellen bzw. nach den persönlichen Tests dorthin zu verschieben.
Verwenden von Parametern[Quelltext bearbeiten]
In dem vorangegangenen Abschnitt "Was ist eine Vorlage" wurde bereits angesprochen, dass Vorlagen nicht nur statische Textbausteine enthalten müssen. Dass eine Vorlage in einem gewissen Rahmen individualisiert und an den Inhalt der Seite angepasst werden kann, auf der sie eingebunden wird, wird über Parameter erreicht. Ein Parameter ist hierbei ein definierter Platzhalter innerhalb der Vorlage, der beim Einbinden der Vorlage mit einem Wert belegt werden kann. Ein Beispiel hierfür ist erneut die Willkommen-Vorlage, mit der ein neu angemeldeter Benutzer wie folgt begrüßt werden kann: {{subst:Willkommen|~~~~}}
.
In diesem Beispiel trägt die Vorlage selbst den Namen "Willkommen" und wird substantiviert eingebunden. Als Parameter wird die eigene Signatur mitgegeben. Der neu angemeldete Benutzer bekommt dadurch, neben dem Willkommenstext aus der Vorlage, angezeigt, wann und von wem er begrüßt wurde.
Ob eine Vorlage parametrierbar ist oder nicht, kann auf der Vorlagen-Seite nachgeschaut werden. Dort sind in der Regel Beispiele angegeben, wie die Vorlage verwendet werden soll und welche Parameter möglich sind. Dort ist auch angegeben, wenn Parameter dediziert über einen Namen angesprochen werden können. Hierzu nachfolgend zwei Beispiele zu Vorlagen, die im Rahmen der Wiki-Arbeit recht häufig verwendet werden.
Vorlagen mit anonymen Parametern
Die Vorlage:K wird gemäß ihres Verwendungshinweises wie folgt eingebunden: {{K|XXX}}
, wobei XXX der Nummer eines beliebigen Kapitels aus dem Detektiv Conan-Manga entspricht. Bei dieser Vorlage handelt es sich um eine sogenannte Formatierungshilfe, die für das mitgegebene Kapitel einen Verweis auf den entsprechenden Wiki-Artikel erstellt.
{{K|1}}
-> Band 1: Kapitel 1{{K|2|3|4|5}}
-> Band 1: Kapitel 2, 3, 4 & 5{{K|2|5|4|3}}
-> Band 1: Kapitel 2, 5, 4 & 3
Die Nummern der Kapitel, auf die verwiesen werden soll, sind hierbei als Parameter an die Vorlage:K übergeben, indem sie durch einen senkrechten Strich („|“) getrennt hintereinander nach dem Vorlagennamen angegeben sind. Innerhalb der Vorlage werden die Parameter anhand der Reihenfolge, in der sie mitgeben sind, voneinander unterschieden und die Reihenfolge der Parameter wirkt sich auf die Darstellung durch die Vorlage aus.
Vorlagen mit ausgezeichneten Parametern
Die Vorlage:Infobox Kapitel kann gemäß ihres Verwendungshinweises wie folgt eingebunden werden: {{Infobox Kapitel|Kapitel=XXX}}
, wobei XXX der Nummer eines beliebigen Kapitels aus dem Detektiv Conan-Manga entspricht. Bei dieser Vorlage handelt es sich um eine sogenannte Infobox, die in Kapitel-Artikeln verwendet wird.
Die Nummer des Kapitels wird hierbei explizit über den Parameter "Kapitel" an die Vorlage übergeben. Innerhalb der Vorlage wird dieser Parameter anhand seines Namens von anderen Parametern unterschieden und die Reihenfolge der Parameter wirkt sich nicht auf die Darstellung durch die Vorlage aus.
Vorlage erstellen[Quelltext bearbeiten]
Namensraum[Quelltext bearbeiten]
Analog zu Benutzerseiten, Dateien oder Kategorien, werden Vorlagen von gewöhnlichen Wiki-Artikeln unterschieden. In ConanWiki steht hierfür der Namensraum Vorlage zur Verfügung. Seiten, die eine Vorlage repräsentieren, sind in diesem Namensraum anzulegen.
Eine Seite wird in einem bestimmten Namensraum angelegt, indem dieser als Präfix dem Titel der Seite vorangestellt wird: {{<Namensraum>:<Titel der Seite>}}
. Um eine Seite als Vorlage anzulegen, ist diese demnach wie folgt zu benennen: {{Vorlage:<Name der Vorlage>}}
.
Sichtbarkeit definieren[Quelltext bearbeiten]
Zu einer Vorlage kann die Sichtbarkeit einzelner Textblöcke aus der Vorlage definiert werden. Hierbei wird unterschieden, ob ein Textblock
- nur auf der Vorlagenseite selbst sichtbar ist,
- nur auf Seiten sichtbar ist, auf der die Vorlage eingebunden ist oder
- sowohl auf der Vorlagenseite als auch auf den Seiten die die Vorlagen einbinden sichtbar ist.
- <onlyinclude>
- Wenn die Vorlage direkt betrachtet wird, haben
<onlyinclude>
und</onlyinclude>
keine Wirkung auf alles, was dazwischen steht. Wenn die Vorlage jedoch auf einer anderen Seite eingebunden ist, wird ausschließlich angezeigt, was zwischen diesen beiden Tags steht. Außerhalb von<onlyinclude>
können Dokumentationen und Kategorien in Vorlagen eingefügt werden, ohne dass diese in den Artikeln auftauchen. Es können auch mehrere nicht-verschachtelte<onlyinclude>
-Blöcke in einer Vorlage stehen. - <includeonly>
- Alles, was in einer Vorlage zwischen
<includeonly>
und</includeonly>
steht, wird nur dann angezeigt, wenn die Vorlage auf einer anderen Seite eingebunden wird. Mit<includeonly>
lassen sich zum Beispiel alle Seiten, die eine bestimmte Vorlage enthalten, automatisch einer Kategorie hinzufügen.<includeonly>
kann auch innerhalb von<onlyinclude>
-Blöcken stehen. - <noinclude>
- Alles, was in einer Vorlage zwischen
<noinclude>
und</noinclude>
steht, wird nur dann angezeigt, wenn die Vorlage selbst betrachtet wird und nicht auf einer Seite, auf der die Vorlage eingebunden ist.<noinclude>
kann auch innerhalb von<onlyinclude>
-Blöcken stehen.<onlyinclude>
sollte zum Abgrenzen des eigentlichen Vorlagentextes von der Dokumentation, den Kategorien und Interwikilinks bevorzugt werden.
Sind in der Vorlage keine Vorgaben zur Sichtbarkeit definiert, ist standardmäßig der komplette Text der Vorlage immer sichtbar, also sowohl auf der Vorlagenseite als auch auf den Seiten, die die Vorlage einbinden.
Nachfolgend einige Beispiele für mögliche sinnvolle Vorgaben zur Sichtbarkeit:
Tag-Kombination | Auf der Vorlagenseite | Auf der einbindenden Seite | Bemerkung |
---|---|---|---|
keine | sichtbar | sichtbar [1] | [1] Nur, wenn kein onlyinclude-Block in der Vorlage ist. |
<includeonly>…</includeonly> | nicht sichtbar | sichtbar [1] | [1] Nur, wenn kein onlyinclude-Block in der Vorlage ist. |
<noinclude>…</noinclude> | sichtbar [2] | nicht sichtbar | [2] Auch innerhalb eines onlyinclude-Blocks. |
<onlyinclude>…</onlyinclude> | sichtbar | sichtbar [3] | [3] Text außerhalb des onlyinclude-Blocks wird nicht eingebunden. |
Text 1 <onlyinclude>Text 2 <includeonly>Text 3</includeonly> <noinclude>Text 4</noinclude> </onlyinclude>Text 5 |
Text 1: sichtbar, Text 2: sichtbar, Text 3: nicht sichtbar, Text 4: sichtbar, Text 5: sichtbar |
Text 1: nicht sichtbar, Text 2: sichtbar, Text 3: sichtbar, Text 4: nicht sichtbar, Text 5: nicht sichtbar |
Nachfolgend einige Beispiele für nicht sinnvolle Kombinationen zur Sichtbarkeit:
Tag-Kombination | Auf der Vorlagenseite | Auf der einbindenden Seite | Bemerkung |
---|---|---|---|
<includeonly>Text 1</includeonly> <onlyinclude>Text 2</onlyinclude> |
Text 1: nicht sichtbar, Text 2: sichtbar |
Text 1: nicht sichtbar, Text 2: sichtbar |
Wenn onlyinclude-Blöcke enthalten sind, werden Textblöcke außerhalb dieser nicht auf anderen Seiten eingebunden. Der Text 1 wird niemals angezeigt und diese Tag-Kombination ist demnach nicht sinnvoll. |
<includeonly><onlyinclude>... </onlyinclude></includeonly> |
nicht sichtbar | sichtbar | Textblöcke innerhalb von includeonly-Blöcken werden außschließlich auf den einbindenden Seiten angezeigt. Der zusätzliche onlyinclude-Block macht demnach keinen Sinn und lediglich die Vorlage komplizierter. |
Einfache Dynamisierung: Parameter definieren[Quelltext bearbeiten]
In Abschnitt "Vorlage verwenden" wurde bereits angesprochen, dass Vorlagen parametrierbar sein können. Die Art und Weise der Parameterübergabe wird bei der Vorlagenerstellung definiert und kann im Nachhinein nur schwer geändert werden.
Innerhalb der Vorlage ist ein Platzhalter durch drei einschließende geschweifte Klammern gekennzeichnet; diese können entweder durchnummeriert oder durch frei gewählte Namen bezeichnet werden:
{{{Y}}}
, wobei Y eine fortlaufende Nummer beginnend bei Eins ist, kennzeichnet einen anonymen Parameter.{{{<Parametername>}}}
kennzeichnet einen ausgezeichneten Parameter, der bei der Verwendung der Vorlage dediziert über seinen Namen angesprochen werden kann.
Nachfolgend ein kleines Beispiel, wie sich die beiden Parameterdefinitionen unterscheiden:
Anonyme und ausgezeichnete Parameter definieren
Beispielvorlage1: Nach Auffassung {{{1}}}s ist der Täter {{{2}}}.
Beispielvorlage2: Nach Auffassung {{{Detektiv}}}s ist der Täter {{{Täter}}}.
Die beiden Beispielvorlagen können wie folgt verwendet werden:
{{Beispielvorlage1|Kogoro Mori|Yoshihito Kureko}}
-> Nach Auffassung Kogoro Moris ist der Täter Yoshihito Kureko.{{Beispielvorlage2|Detektiv=Kogoro Mori|Täter=Yoshihito Kureko}}
-> Nach Auffassung Kogoro Moris ist der Täter Yoshihito Kureko.
Das Ergebnis beider Vorlagen ist das gleiche. In Beispielvorlage1 ist jedoch implizit definiert, dass der Name des Detektivs immer als erster Parameter übergeben werden soll und der Name des Täters als zweiter Parameter. In Beispielvorlage2 hingegen ist über den zusätzlichen Parameternamen klar ersichtlich, welcher Parameter den Detektivnamen und welcher den Namen des Täters aufnimmt. In Beispielvorlage2 kann daher die Reihenfolge der Parameterübergabe ausgetauscht werden ohne die inhaltliche Aussage zu verändern, in Beispielvorlage1 geht dies nicht:
{{Beispielvorlage1|Yoshihito Kureko|Kogoro Mori}}
-> Nach Auffassung Yoshihito Kurekos ist der Täter Kogoro Mori.{{Beispielvorlage2|Täter=Yoshihito Kureko|Detektiv=Kogoro Mori}}
-> Nach Auffassung Kogoro Moris ist der Täter Yoshihito Kureko.
Ob ein Parameter besser anonym oder mit einem Namen ausgezeichnet ist, entscheidet der Vorlagenentwickler bei Einführung des Parameters. Nachfolgende Hinweise können bei der Entscheidung helfen:
- Anonyme Parameter bieten sich an, wenn
- die Übergabe-Reihenfolge egal ist
- die Anzahl der übergebenen Parameter beliebig ist / nicht von vornherein eingeschränkt sein soll
- alle übergebenen Parameter gleich behandelt werden sollen
Ein gutes Beispiel hierfür sind Formatierungsvorlagen, die auf alle an sie übergebenen Parameter die gleiche Formatierungsvorgaben anwenden, bspw. den Text des Parameters als Link darstellen. In einer solchen Vorlage wird der erste Parameter gleich dem letzten behandelt und je nach Anwendungskontext wird an die Vorlage nur ein Parameter übergeben und ein anderes Mal sind es zwei oder mehr.
- Ausgezeichnete Parameter bieten sich an, wenn
- die Übergabe-Reihenfolge nicht egal ist
- ein Parameter dediziert angesprochen oder ausgewertet werden soll
- die übergebenen Parameter unterschiedlich behandelt werden sollen
Ein gutes Beispiel hierfür sind die Infoboxen. Hier wird ein Wert einem bestimmten Parameter zugewiesen, der innerhalb der Vorlage dediziert ausgewertet werden soll. Beispielsweise soll in der Infobox für Manga-Kapitel die Kapitelnummer nicht in dem Datumsfeld für die deutsche Erstveröffentlichung angezeigt werden. Durch die Parameternamen wird einerseits der Vorlagencode selbst besser lesbar und andererseits die Verwendung der Vorlage einfacher; Verwechslungen zwischen einzelnen Parametern können besser vermieden werden.
Wird ein Parameter nachträglich in eine bestehende Vorlage eingefügt, bietet es sich an, diesen entsprechend der anderen bereits vorhandenen Parameter ebenfalls anonym bzw. ebenfalls ausgezeichnet mit einem Namen zu definieren.
Hinweis: Nachträglich eingeführte Parameter werden auf Seiten, die die Vorlage bereits eingebunden hatten nicht automatisch verwendet, sofern kein Standardwert definiert ist. Es müssen demnach entweder die verwendenden Seiten entsprechend geändert werden oder die Änderung der Vorlage hat zunächst keine Auswirkungen auf einbindende Seiten.
Parameter mit Vorbelegung[Quelltext bearbeiten]
Ein Parameter kann innerhalb der Vorlage mit einem Standardwert vorbelegt werden. Hierzu wird der Parameter wie folgt angegeben: {{{<Parametername>|<Standardwert>}}}
. Der senkrechte Strich („|“) trennt hierbei den Namen des Parameters und dessen Vorbelegung. Eine Vorbelegung kann zum Beispiel in Textbausteinen dazu verwendet werden, dass diese auch bei fehlender Parameterübergabe einen Sinn ergeben.
Parameter mit Vorbelegung
Beispielvorlage2: Nach Auffassung {{{Detektiv|des Detektiv}}}s ist der Täter {{{Täter|noch unbekannt}}}.
{{Beispielvorlage2|Detektiv=Kogoro Mori|Täter=Yoshihito Kureko}}
-> Nach Auffassung Kogoro Moris ist der Täter Yoshihito Kureko.{{Beispielvorlage2}}
-> Nach Auffassung des Detektivs ist der Täter noch unbekannt.
Hinweis: Wird ein Parameter an mehreren Stellen in der Vorlage verwendet, macht es Sinn, diesen entweder immer oder nie mit einem Standardwert zu belegen, es ist jedoch nicht erforderlich.
Leere Parameter[Quelltext bearbeiten]
Ein Parameter darf auch leer sein. Ein leerer Parameter ist aber nicht automatisch gleichbedeutend mit einer leeren Zeichenkette, also einem Leertext. Damit ein leerer Parameter bei Verwendung einer Vorlage auch als leerer Text angezeigt wird, wird dieser als Standardwert vorbelegt. Hierzu wird der Parameter wie folgt angegeben: {{{<Parametername>|}}}
.
Leere Parameter zulassen
Beispielvorlage4: Herzlich Willkommen {{{Benutzername}}}.
Beispielvorlage5: Herzlich Willkommen {{{Benutzername|}}}.
{{Beispielvorlage4}}
-> Herzlich Willkommen {{{Benutzername}}}.{{Beispielvorlage5}}
-> Herzlich Willkommen .
Erweiterte Dynamisierung: Funktionen[Quelltext bearbeiten]
Eine weitere Möglichkeit der Dynamisierung ist, komplexe Aufgabenstellungen in Teilaufgaben zu zerlegen und die Teilaufgaben zu lösen. Dadruch ist es umgekehrt möglich, die gelösten Teilprobleme in unterschiedlichen Kontexten zu verwenden. Die Lösung eines solchen Teilproblems kann als Funktion beschrieben werden.
Eine Funktion hat immer einen Namen, optional einen oder mehrere Eingabeparameter und genau einen Rückgabewert. Einige Funktionen, die Fragen zu einem Wiki-System beantworten, sind bereits Bestandteil der MediaWiki-Basisinstallation. Eine Übersicht über diese Basisfunktionen ist in der Wikipedia-Hilfe zu finden.
- Beispiel 1:
{{SORTIERUNG:<Sortierschlüssel>}}
: diese Funktion übernimmt die Sortierung der Artikel innerhalb einer Kategorie.
Funktionen können auch als Vorlagen beschrieben werden. Sie können in anderen Vorlagen oder direkt in Artikeln über ihren Namen aufgerufen werden. In ConanWiki sind Vorlagen, die eine Funktion beschreiben, in die Kategorie:Vorlage:Funktion eingeordnet.
- Beispiel 2: Vorlage:KB:Diese Vorlage bekommt als Eingabeparameter eine Kapitelnummer aus dem Detektiv Conan-Manga und gibt die Nummer des entsprechenden Manga-Bandes zurück, in dem das Kapitel zu finden ist.
Nachfolgend werden Erweiterungen vorgestellt, die bei der Erstellung von Vorlagen hilfreich sind. Da diese generell für Wiki-Systeme gültig und im Internet bereits gute dokumentiert sind, wird für die vertiefende Lektüre in der Regel auf entsprechende Dokumentationen verwiesen.
Erweiterung: Variablen[Quelltext bearbeiten]
Variablen sind, ähnlich wie Parameter, Platzhalter und bieten die Möglichkeit, eine Vorlage in einem gewissen Rahmen flexibel auf verschiedene Anwendungsfälle reagieren zu lassen. Wie die nachfolgenden beiden Beispiele zeigen, sind Variablen nicht auf den Einsatz in Vorlagen beschränkt.
- Beispiel 3: Auf dieser Hilfeseite sind die Überschriften als Variablen definiert. Damit ist es möglich sehr bequem auf einzelne Abschnitte der Hilfeseite zu referenzieren. Werden die Überschriften im Rahmen zukünftiger Bearbeitungen zu dieser Hilfeseite angepasst, so bleibt die Referenzierung weiterhin korrekt. Es ist nicht notwendig, die gesamte Hilfeseite manuell zu prüfen.
- Beispiel 4: Die Nummerierung der Beispiele auf dieser und anderen Hilfeseiten ist über eine Variable abgebildet, die die Anzahl der bisher im Dokument enthaltenen Beispiele als nummerischen Wert gespeichert hat. Wird irgendwo auf der Seite ein neues Beispiel hinzugefügt, wird zuvor der Wert dieser Zählervariable um eins erhöht. Wird irgendwo auf der Seite ein Beispiel entfernt, wird auch die zugehörige Inkrementation der Zählervariable entfernt. Auch können die Beispiele dadurch beliebig mit einander getauscht oder an andere Positionen der Hilfeseite verschoben werden. Es ist nicht notwendig, anschließend die gesamte Hilfeseite manuell auf eine korrekte Nummerierung der Beispiele zu prüfen.
Nachfolgend eine kleine Übersicht über ausgewählte Eigenschaften zu Parametern und Variablen:
Eigenschaft | Parameter | Variable |
---|---|---|
Funktion | dienen als Schnittstelle zur Vorlage, um Werte aus dem Kontext außerhalb der Vorlage an die Vorlage zu übergeben | dienen innerhalb der Vorlage dazu, Werte zu definieren und mehrfach zu verwenden oder sie zu verändern |
Veränderbarkeit | Werte werden innerhalb der Vorlage nicht verändern | Werte können innerhalb der Vorlage verändert werden |
Zugriff | werden außerhalb der Vorlage mit Werten belegt; Werte können innerhalb der Vorlage abgefragt werden |
werden innerhalb der Vorlage mit Werten belegt; Werte können innerhalb der Vorlage abgefragt werden |
Im Rahmen von MediaWiki-Systemen sind Variablen Bestandteil der Erweiterung Variables. Diese Erweiterung ist in ConanWiki installiert und kann verwendet werden.
Um eine Variable zu definieren oder mit einem Wert zu belegen, wird die folgende Syntax verwendet:
{{#vardefine:<Name der Variable>|<optionale Vorbelegung>}}
Um den Wert einer Variable abzurufen wir die folgende Syntax verwendet:
{{#var:<Name der Variable>}}
Erweiterung: Parser-Funktionen[Quelltext bearbeiten]
Als Parser-Funktionen werden die Funktionen der MediaWiki-Erweiterung ParserFunctions herausgehoben. Diese Erweiterung ist in ConanWiki installiert und kann verwendet werden.
Mit dieser Erweiterung ist es u. a. möglich, bedingte Abfragen, Existensprüfungen oder mathematische Berechnungen durchzuführen.
Automatisches Hochzählen der Beispiele in einer Hilfeseite
Im Abschnitt zun der MediaWiki-Erweiterung Variables wurde bereits angesprochen, dass für die Nummerierung der Beispiele auf den Hilfeseiten eine Zählervariable definiert ist, die mit jedem Beispiel um eins erhöht wird. Diese schrittweise Erhöhung ist mithilfe der Parser-Dunktion expr abgebildet.
- Syntax:
{{#vardefine:countExample|{{#expr:{{#var:countExample}} + 1}} }}
Die Variable selbst trägt den Namen countExample.
{{#vardefine:countExample
: die Variable soll mit einem neuen Wert belelgt werden{{#expr:{{#var:countExample}} + 1}}
: der neue Wert der Variable ist der Rückgabewert der expr-Funktion{{#var:countExample}}
: bisheriger Wert der Variable
Eine Übersicht über die Funktionen dieser Erweiterung finden sich in der Hilfe zur Erweiterung. Eine deutsche Erläuterung zu den Funktionen ist auch in der Wikipedia-Hilfe zur Vorlagenprogrammierung zu finden.
Erweiterung: Wiederholungen[Quelltext bearbeiten]
Mit der MediaWiki-Erweiterung Loops können Wiederholungen abgebildet werden. Diese Erweiterung ist in ConanWiki installiert und kann verwendet werden.
Dokumentation[Quelltext bearbeiten]
Vorlagen sind bei der Erstellung oder Bearbeitung immer entsprechend zu dokumentieren. Dies erhöht einerseits die Wartbarkeit der Vorlage selbst und andererseits wird damit der Anwender einer Vorlage bei der Einbindung auf einer Seite unterstützt.
- Beispiel 5: Vorlage:Infobox Kapitel: Neben den einleitenden Bemerkungen sind ein Abschnitt zur Verwendung mit Parameterübersicht und eine Kopiervorlage enthalten.
Bei Erstellung einer Vorlage sind die folgenden Informationen anzugeben:
- Beschreibung, was die Funktion und das Ziel der Vorlage ist
- Verwendungshinweis
- Wann ist die Vorlage einzusetzen bzw. wann nicht
- Wie kann die Vorlage verwendet werden
- Falls die Vorlage parametrierbar ist: Übersicht über die möglichen Parameter der Vorlage mit kurzer Erläuterung
- Vorschau / Anwendungsbeispiele (optional)
- Kopiervorlage (optional)
Bei Bearbeitung einer Vorlage sind folgende Änderungen zu dokumentieren:
- Neue Parameter sind in die Parameterübersicht mit einer kurzen Erläuterung aufzunehmen bzw. es ist eine Parameterübersicht anzulegen
- Entfallene Parameter sind in der Parameterübersicht als obsolet oder veraltet zu kennzeichnen
- Geänderte oder ergänzte Funktionsweisen sind zu beschreiben und ggf. mit einem Beispiel zu verdeutlichen
- Bereits vorhandene Anwendungsbeispiele oder Kopiervorlagen sind auf Korrektheit zu prüfen und ggf. an die durchgeführten Änderungen anzupassen
- Nach dem Speichern der durchgeführten Änderungen an der Vorlage ist die Vorschau zu prüfen (insbesondere bei Textbausteinen wichtig) und ggf. durch ein touch, ein erneutes Speichern ohne Änderungen zu tätigen, zu aktualisieren
Die Dokumentation kann in der Regel auf der Vorlagenseite selbst erfolgen. Damit sie nicht auf den einbindenden Seiten angezeigt wird, wird die Dokumentation in einen noinclude-Block eingeschlossen oder außerhalb der onlyinclude-Blöcke gesetzt.
Ausführliche oder sehr komplexe Dokumentationen können auch auf eine Unterseite zur Vorlage ausgelagert werden. Die Dokumentation soll in diesem Fall auf einer Seite mit dem Titel Vorlage:<Name der Vorlage>/Doku
erstellt werden. Eingebunden wird die Dokumentation dann wie eine Vorlage auf der Seite der Vorlage, die sie dokumentiert:
<noinclude>{{Vorlage:<Name der Vorlage>/Doku}}</noinclude>
.
Kategorisierung[Quelltext bearbeiten]
Abschließend ist die Vorlage zu kategorisieren. Hierfür sind eine oder mehrere passende Unterkategorien aus Kategorie:Vorlage anzugeben. Im Abschnitt "Vorlagen in ConanWiki" sind die einzelnen Unterkategorien in ConanWiki im Überblick dargestellt. Diese Kurzbeschreibungen finden sich auch auf den Seiten der jeweiligen Kategorien und sollen beim Einordnen oder Finden von Vorlagen unterstützen. Eine Einsortierung von Vorlagen in Artikelkategorien ist nicht erwünscht.
Bei der Kategorisierung von Vorlagen ist zu beachten, dass dies innerhalb von noinclude-Blöcken oder außerhalb von onlyinclude-Blöcken geschieht, damit nur die Vorlage der Kategorie zugeordnet wird und nicht alle Seiten, in denen die Vorlage verwendet wird: <noinclude>[[Kategorie:Vorlage:<Unterkategorie>]]</noinclude>
.
Soll eine Sortierung vorgegeben werden, ist der Sortierschlüssel direkt beim Setzen der Kategorie anzugeben: [[Kategorie:Vorlage:<Unterkategorie>|<Sortierschlüssel>]]
.
Vorlagen in ConanWiki[Quelltext bearbeiten]
In diesem Abschnitt geht es um die Vorlagen in ConanWiki. Da alle Vorlagen grundsätzlich kategorisiert sein sollen, beschränken sich die nachfolgenden Ausführungen auf den Aufbau der Kategorie:Vorlage und ihre Unterkategorien.
Zentrale Dimensionen bei der Kategorisierung sind als Unterkategorien abgebildet. Dabei kann eine Vorlage in mehreren Dimensionen kategorisiert werden und sollte immer so genau wie möglich eingeordnet werden. Die Dimensionen helfen dabei, Vorlagen wiederzufinden oder ähnliche Vorlagen zu finden.
Kategorien-Graph für Vorlagen[Quelltext bearbeiten]
- Kategorie:Vorlage
- Kategorie:Vorlage nach Artikeltyp
- Kategorie:Vorlage nach Eigenschaft
- Kategorie:Vorlage nach Namensraum
- Kategorie:Vorlage Baustein
- Kategorie:Vorlage Formatierungshilfe
- Kategorie:Vorlage:Funktion
- Kategorie:Vorlage Infobox
- Kategorie:Vorlage Lizenz
- Kategorie:Vorlage Navigationsleiste
- Kategorie:Vorlage Spoiler
Die Kategorie "Vorlage" bildet die Hauptkategorie für sämtliche Vorlagen. In ihr sollen keine Vorlagen direkt eingeordnet sein, da sie eine zu allgemeine Kategorie ist. Sind Vorlagen direkt dieser Kategorie zugeordnet, sind diese passend neu zu kategorisieren oder mithilfe der Korrektur-Vorlage wie folgt zu melden:
{{Korrektur|Bitte Vorlage passend kategorisieren. ~~~~}}
Vorlage nach Artikeltyp[Quelltext bearbeiten]
Die Kategorie Vorlage nach Artikeltyp enthält Vorlagen, die vorrangig in einzelnen speziellen Artikeln verwendet werden. Hierbei bezeichnet der Artikeltyp, was in dem Artikel thematisiert wird, ohne Bezug auf den konkreten Inhalt zu nehmen. Beispielsweise bezeichnet der Artikeltyp "Kapitel" einen Artikel, der sich mit dem Inhalt eines Manga-Kapitels befasst. Der konkrete Inhalt kann sowohl aus der Serie Detektiv Conan oder Kaito Kid oder einem anderen hier im Wiki akzeptierten Manga von Gosho Aoyama sein.
- Die Kategorie Vorlage:Band enthält Vorlagen, die vorrangig in Band-Artikeln Anwendung finden.
- Die Kategorie Vorlage:Charakter enthält Vorlagen, die vorrangig in Charakter-Artikeln Anwendung finden.
- Die Kategorie Vorlage:Episode enthält Vorlagen, die vorrangig in Episoden-Artikeln Anwendung finden.
- Die Kategorie Vorlage:Fall enthält Vorlagen, die vorrangig in Fall-Artikeln Anwendung finden.
- Die Kategorie Vorlage:Film enthält Vorlagen, die vorrangig in Film-Artikeln Anwendung finden.
- Die Kategorie Vorlage:Gegenstand enthält Vorlagen, die vorrangig in Gegenstand-Artikeln Anwendung finden.
- Die Kategorie Vorlage:Kapitel enthält Vorlagen, die vorrangig in Kapitel-Artikeln Anwendung finden.
- Die Kategorie Vorlage:Ort enthält Vorlagen, die vorrangig in Ort-Artikeln Anwendung finden.
Vorlage nach Eigenschaft[Quelltext bearbeiten]
Die Kategorie Vorlage nach Eigenschaft enthält Vorlagen, die spezielle Eigenschaften erfüllen. Hierbei kann eine Eigenschaft beispielsweise sein, dass die Vorlage bei Einbindung den entsprechenden Artikel automatisch kategorisiert.
- Die Kategorie Vorlage:mit Kategorie enthält Vorlagen, die bei Einbindung eine automatische Kategorisierung der entsprechenden Wiki-Seite vornehmen. Die Kategorisierung kann sichtbar oder versteckt sein.
- Die Kategorie Vorlage:mit Signatur enthält Vorlagen, die bei Einbindung automatisch eine Signierung vornehmen.
- Die Kategorie Vorlage:mit Überschrift enthält Vorlagen, die bei Einbindung automatisch eine Abschnitts-Überschrift erstellen.
- Die Kategorie Vorlage:nur Subst enthält Vorlagen, die nur substantiviert eingebunden werden sollen. Bei der Verwendung ist also darauf zu achten, dass sie nach folgendem Schema eingebunden werden:
{{subst:<Name der Vorlage>}}
. - Die Kategorie Vorlage:nur Test enthält Vorlagen, die von Benutzern zu Testzwecken angelegt wurden. Sie sind nicht für den Einsatz in der täglichen Wiki-Arbeit gedacht und sollten daher ausschließlich in dieser Kategorie stehen, damit sie zeitnah wieder verwaisen. Zudem sollte der Vorlagenersteller darüber informiert werden, dass er noch eine Vorlage im Test hat, mit der Bitte, die Tests zeitnah zu vollenden.
- Die Kategorie Vorlage:Veraltet enthält Vorlagen, die veraltet oder obsolet sind. Veraltete Vorlagen sollten ausschließlich in dieser Kategorie stehen, damit sie zeitnah verwaisen. Vollständig verwaiste Vorlagen dieser Kategorie können gelöscht werden.
Vorlage nach Namensraum[Quelltext bearbeiten]
Die Kategorie Vorlage nach Namensraum enthält Vorlagen, die vorrangig in einzelnen Namensräumen verwendet werden.
- Die Kategorie Vorlage Artikel enthält Vorlagen, die vorrangig im Artikel-Namensraum Anwendung finden.
- Die Kategorie Vorlage Benutzer enthält Vorlagen, die vorrangig im Benutzernamensraum Anwendung finden.
- Die Kategorie Vorlage Datei enthält Vorlagen, die vorrangig im Datei-Namensraum Anwendung finden.
- Die Kategorie Vorlage Diskussion enthält Vorlagen, die vorrangig im Diskussionsnamensraum Anwendung finden. In dieser Kategorie werden auch Vorlagen berücksichtigt, die im Namensraum Benutzer_Diskussion Anwendung finden.
- Die Kategorie Vorlage Hilfe enthält Vorlagen, die vorrangig im Hilfe-Namensraum Anwendung finden.
- Die Kategorie Vorlage Wiki enthält Vorlagen, die im Wiki-Namensraum Anwendung finden oder bei der aktiven Mitarbeit im Wiki unterstützen.
Vorlage Baustein[Quelltext bearbeiten]
Die Kategorie Vorlage Baustein enthält Vorlagen, die als universelle Bausteine in verschiedenen Bereichen des Wikis Anwendung finden.
- Die Kategorie Vorlage Diskussion enthält Vorlagen, die zur Begriffsklärung verwendet werden.
- Die Kategorie Vorlage Benutzer enthält Vorlagen, die vorrangig im Benutzernamensraum Anwendung finden.
- Die Kategorie Vorlage Bewertungsbaustein enthält Textbausteine, die in der Wiki-Mitarbeit Anwendung finden.
- Die Kategorie Vorlage Diskussion enthält Vorlagen, die vorrangig im Diskussionsnamensraum Anwendung finden. In dieser Kategorie werden auch Vorlagen berücksichtigt, die im Namensraum Benutzer_Diskussion Anwendung finden.
- Die Kategorie Vorlage Hinweisbaustein enthält standardisierte Hinweistexte, die auf verschiedensten Seiten im Wiki Anwendung finden.
- Die Kategorie Textbaustein enthält Texte, die in mehreren Artikeln oder Diskussionen eine wiederkehrende Verwendung finden. Die Texte wurden daher als Vorlage angelegt und können parametrierbar sein.
- Die Kategorie Vorlagen enthält Textbausteine, die in der Wiki-Wartung Anwendung finden.
Vorlage Formatierungshilfe[Quelltext bearbeiten]
Die Kategorie Vorlage Formatierungshilfe enthält Vorlagen, die bei Formatierung helfen. Mithilfe der Vorlagen wird auch eine einheitliche Formatierung von Spezialfällen, beispielsweise Referenzen oder Zitaten sichergestellt.
- Die Kategorie Vorlage:Quelleninformation enthält Formatierungshilfen zum Setzen von Quelleninformationen zu einzelnen Textaussagen. Eine Quelleninformation kann z. B. wichtig sein, wenn bestimmte Inhalte nur für den Anime gültig sind.
- Die Kategorie Vorlage Verweis enthält Formatierungshilfen beim Setzen spezieller Verweise.
- Die Kategorie Vorlage:Zitation enthält Formatierungshilfen zum Zitieren. Sowohl Vorlagen zur Referenzierung auf einen Beleg als auch zur Darstellung des Zitat-Textes gehören in diese Kategorie.
Vorlage Funktion[Quelltext bearbeiten]
Die Kategorie Vorlage:Funktion enthält Vorlagen, die als Funktion verwendet werden können. Eine Funktion hat dabei immer einen Rückgabewert, wobei ein leerer Rückgabewert ebenfalls ein gültiger Rückgabewert ist.
Ein Beispiel für eine Funktion ist die Vorlage:KB, die anhand eines gegebenen Kapitels ermittelt, in welchem Manga-Band es erschienen ist. Der Rückgabewert dieser Funktion ist hierbei die ermittelte Band-Nummer.
Weitere Vorlagen[Quelltext bearbeiten]
Die nachfolgenden Unterkategorien sind aufgrund der häufigen Verwendung dieser Vorlagen direkt in der Hauptkategorie zu den Vorlagen verlinkt. Die darin enthaltenen Vorlagen sind immer auch mindestens einer der o. g. Dimensionen zugeordnet.
- Die Kategorie Vorlage Infobox enthält Infoboxen, die in mehreren speziellen Artikeln verwendet werden. Die Infoboxen wurden daher als Vorlage angelegt. Vorlagen dieses Typs sollten mit dem Präfix
Infobox
beginnen. - Die Kategorie Vorlage Lizenz enthält Vorlagen, die zur Lizenzierung einer Mediendatei im Wiki dienen. Eine Mediendatei ist beispielsweise ein Bild oder eine Audioaufnahme, die zur Gestaltung eines Artikels in das Wiki hochgeladen wurden.
- Die Kategorie Vorlage Navigationsleiste enthält Navigationsleisten, die in an das Ende eines Artikels eingebunden werden können, um auf Artikel zu einem ähnlichen Thema hinzuweisen. Beispielsweise wird am Ende eines Filmartikels immer einer Navigationsleiste eingebunden, die auf die Artikel zu allen bisher existierenden Filmen verweist.
- Die Kategorie Vorlage Spoiler enthält Vorlagen, die zum Verspoilern von Artikeln oder Textstellen dienen.
Vorlagen finden[Quelltext bearbeiten]
Ist der Name der Vorlage bekannt, kann die Vorlage direkt über die Suchfunktionen für Seiten hier im Wiki gefunden werden. Ist der genaue Name der Vorlage nicht bekannt, jedoch mindestens eine Seite, auf der die Vorlage eingebunden ist, kann im Bearbeitungsmodus der Seite nach der Vorlage geschaut werden. Wurde diese nicht substantiviert eingebunden, dann steht im Seitentext der Code {{<Name der Vorlage>}}
. Anschließend kann die Vorlage mithilfe des Namens gesucht werden.
Nicht immer ist jedoch eine Seite bekannt auf der die gesuchte Vorlage verwendet wird oder aber die Vorlage wurde substantiviert eingebunden und damit lediglich der Inhalt der Vorlage kopiert. Oder es ist nicht bekannt, ob überhaupt bereits eine Vorlage existiert, die die gewünschte Aufgabe erfüllt. In diesem Fall kann über den Kategorien-Graph gesucht werden. Die nachfolgenden Fragen können für eine gezielte Suche helfen:
- Was macht die gesuchte Vorlage? -> (Text)Baustein, Formatierungshilfe, Funktion?
- Wo wird die Vorlage vornehmlich verwendet? -> Artikeltyp, Namensraum?
- Erfüllt die Vorlage bestimmte Eigenschaften? -> Eigenschaft?
Finden der Vorlage:Willkommen
Auf der Diskussionsseite von Beispielbenutzer wurde die Willkommen-Vorlage substantiviert eingebunden. Beispielbenutzer erkennt den Text auch auf Diskussionsseiten anderer Benutzer und vermutet daher, dass es sich um eine Vorlage handelt. Er möchte zukünftig ebenfalls neue Benutzer mit der Vorlage begrüßen.
- Was macht die Vorlage?
- Die Vorlage zeigt einen Begrüßungstext an. Beispielbenutzer vermutet daher, es handelt sich bei ihr um einen (Text)Baustein.
- Wo wird die Vorlage vornehmlich verwendet?
- Die Vorlage wird zur Begrüßung neuer Benutzer auf deren Diskussionsseite verwendet. Beispielbenutzer vermutet daher, die Vorlage wird vornehmlich im Namensraum Diskussion verwendet.
- Erfüllt die Vorlage bestimmte Eigenschaften?
- Hierüber hat Beispielbenutzer keine weiteren Informationen. Da die Vorlage substantiviert eingebunden wurde, weiß er nicht, ob beispielsweise die Signatur automatisch von der Vorlage erzeugt wurde oder beim Einbinden als Parameter mitgegeben wurde. Er weiß auch nicht, ob die Vorlage immer substantiviert eingebunden werden muss.
Beispielbenutzer entschließt sich daher, zunächst über die beiden Dimensionen "Vorlage nach Namensraum" und "Vorlage Baustein" zu suchen. In beiden Kategorien findet er die Unterkategorie "Vorlage Diskussion", die demnach nur Vorlagen enthält, die einen Diskussionsbaustein darstellen.
Finden der Vorlage:Inuse
Beispielbenutzer möchte einen bestehenden Artikel in ConanWiki gründlich überarbeiten. Er erinnert sich, schon einmal einen Artikel gesehen zu haben, bei dem ein anderer Benutzer angekündigt hat, dass der Artikel überarbeitet wird und möchte diesen Hinweistext ebenfalls setzen.
- Was macht die Vorlage?
- Die Vorlage zeigt einen Hinweistext an, dass ein Artikel derzeit gewartet wird. Beispielbenutzer vermutet daher, es handelt sich bei ihr um einen (Text)Baustein.
- Wo wird die Vorlage vornehmlich verwendet?
- Hierüber kann Beispielbenutzer keine genauen Angaben machen. Er kann sich vorstellen, dass sowohl Artikel, Hilfe-Seiten oder Vorlagen gewartet werden; eine Einsortierung nach Namensraum oder gar Artikeltyp vermutet er daher nicht.
- Erfüllt die Vorlage bestimmte Eigenschaften?
- Hierüber hat Beispielbenutzer ebenfalls keine weiteren Informationen. Er kann sich jedoch vorstellen, dass es ggf. eine Eigenschaft gibt, die "nur Wartung" heißt, die seiner Meinung nach ausdrückt, dass eine Vorlage nur zur Wartung dient.
In der Kategorie "Vorlagen nach Eigenschaft" findet Beispielbenutzer keine passende Unterkategorie, die auf seine vermutete Eigenschaft hinsichtlich "Wartung" hinweist. Er bricht die Suche über diese Dimension daher ab.
In der Kategorie "Vorlage:Baustein" findet Beispielbenutzer hingegen eine Unterkategorie für Wartungsbausteine, in der er die gesuchte Vorlage vermutet und findet.
Hinweis: die Kategorisierung ist kein alleiniges Mittel um Vorlagen in ConanWiki zu finden. Insbesondere können nicht alle Vorlagen über ihre Kategorie(n) gleichermaßen 'einfach' gefunden werden. Beispielsweise sind Vorlagen, die nur hinsichtlich einer Dimension kategorisiert sind ggf. nur über genau einen Pfad im Kategorien-Graph findbar. Vorlagen, die besonders genau kategorisiert werden können, rutschen automatisch in eine tiefergelegene Unterkategorie als Vorlagen die nur grob kategorisiert werden können.
Auch die Hilfe-Seiten können beim Finden von Vorlagen helfen. Hier sind oftmals zentrale Vorlagen gelistet, die für ein bestimmtes Thema wichtig sind. Beispielsweise wird auf der Hilfe zu Kapitel-Artikeln auf die obligatorischen und optionalen Vorlagen verwiesen, die in Kapitel-Artikeln verwendet werden können. Auch auf Vorlagen zur weiteren Artikel-Wartung wird verwiesen.
Vorlagen einsortieren[Quelltext bearbeiten]
Bei der Kategorisierung einer Vorlage in ConanWiki helfen ebenfalls die drei Fragen "Was macht die Vorlage?", "Wann oder Wo soll sie (vornehmlich) verwendet werden?" und "Gibt es zusätzliche Eigenschaften, die von der Vorlage erfüllt werden?". Dabei ist die Vorlage immer gemäß allen möglichen Dimensionen einzuordnen.
Vorlage, um auf einen nachfolgenden Band-Artikel zu verweisen
Beispielbenutzer hat eine neue Vorlage angelegt, mit der in einem Band-Artikel auf den Artikel des nachfolgenden Manga-Bandes verwiesen werden kann. Diese Vorlage ist in ihrer Funktionsweise an die Vorlage:Kapitel Ende angelehnt.
- Was macht die Vorlage?
- Die Vorlage formatiert mitgegebene Daten zu einem Verweis. Beispielbenutzer vermutet daher, die Vorlage ist eine sogenannte Formatierungshilfe; auch die Vorlage "Kapitel Ende", die ihm als Inspiration diente, ist eine solche Formatierungshilfe.
- Wo wird die Vorlage vornehmlich verwendet?
- Die Vorlage soll in Band-Artikeln verwendet werden. Beispielbenutzer kann daher ganz klar definieren, dass die Vorlage gemäß dem Artikeltyp Band kategorisiert werden kann. Zudem ergibt sich daraus, dass seine Vorlage vermutlich vornehmlich im Artikelnamensraum verwendet werden wird. Da die Vorlage aber noch neu und nicht als fester Bestandteil von Band-Artikeln etabliert ist, möchte er keine weitere Spezifizierung machen; anders als dies bei der bereits etablierten Vorlage "Kapitel Ende" der Fall ist.
- Erfüllt die Vorlage bestimmte Eigenschaften?
- Hierüber hat sich Beispielbenutzer keine weiteren Gedanken gemacht. Er prüft daher lediglich, nach welchen Eigenschaften derzeit bereits kategorisiert werden kann. Keine der Eigenschaften werden von seiner neuen Vorlage erfüllt.
Beispielbenutzer entschließt sich daher seine Vorlage in die Unterkategorie "Vorlage Verweis" einzusortieren, die nur die Formatierungshilfen enthält, die einen Verweis erstellen. Weiterhin kategorisiert er sie als "Vorlage:Band", womit seine Vorlage zukünftig gemeinsam mit anderen Vorlagen für Band-Artikel gefunden werden kann. Zum Schluss setzt er noch die Kategorie "Vorlage Artikel", mit dem Wissen, dass diese Einsortierung noch recht grob ist. Er startet daher zusätzlich eine Frage zum Wiki, um zu klären, ob seine Vorlage zukünftig obligatorischer Bestandteil von Band-Artikeln sein soll oder eher optional zur Textgestaltung verwendet werden darf. Damit nach Ablauf der Diskussion die Kategorisierung seiner Vorlage noch einmal geprüft und aktualisiert wird, setzt er zusätzlich den nachfolgenden Hinweis für eine Korrektur:
{{Korrektur|Bitte nach Ablauf dieser Diskussion die Kategorisierung der Vorlage erneut prüfen. ~~~~}}
.
Noch Fragen?[Quelltext bearbeiten]
Für Fragen stehen die erfahrenen Benutzer des Wiki gerne bereit. Alternativ können Fragen zum Verwenden oder Erstellen von Vorlagen auch auf der Diskussion dieser Hilfeseite oder auf der allgemeinen Seite für Fragen zum Wiki gestellt werden.