41.613
Bearbeitungen
Änderungen
Die Seite wurde neu angelegt: „{{Portal/Hilfe}}'''Vorlagen''' werden hier im KingWiki in den unterschiedlichsten Varianten genutzt. Von kleinen Textersetzungen wie der <nowiki>{{SKU|2000}}</…“
{{Portal/Hilfe}}'''Vorlagen''' werden hier im KingWiki in den unterschiedlichsten Varianten genutzt. Von kleinen Textersetzungen wie der <nowiki>{{SKU|2000}}</nowiki>-Vorlage bis hin zum kompletten Aufbau der Portale und der Hauptseite. Dieser Hilfe-Artikel soll darstellen, wie Vorlagen verwendet werden und welche wichtigen Vorlagen bei uns angelegt wurden. Die genaue Nutzung der Vorlagen sollte jeweils dort im Detail beschrieben werden.
== Allgemeines zu Vorlagen ==
Vorlagen dienen hauptsächlich der Arbeitserleichterung für uns Autoren. Mann kann theoretisch bei jedem Werk von Stephen King die Infobox einzeln hinzufügen. Das zieht jedoch einen hohen Aufwand nach sich, um diese einheitlich und vor allem komplett in alle Artikel einzufügen. Außerdem muss jeder Artikel mit der Infobox überarbeitet werden, wenn sich etwas am Layout ändern sollte. Der einfachere Weg ist über die Vorlage.
Die gleiche Motivation steht hinter den ''weiterführend''-Vorlagen am Ende der meisten Artikel. Ergänzungen zu den dort gelisteten Artikeln müssen ohne Vorlage in jedem einzelnen Artikel nachgetragen werden. Mit der Vorlage ist das mit einer Bearbeitung getan.
Für Programmierer oder Entwickler sind Vorlagen nichts anderes als eine Funktion. Und genauso verhalten sie sich auch.
== Einbinden von Vorlagen in Artikeln ==
Das Einbinden ist einfach. Am schnellsten versteht man die Logik, wie eine Vorlage eingebunden werden soll, in dem man sich den Quelltext eines Artikels anschaut, in der die Vorlage bereits eingebunden wurde. Im groben gibt es zwei Möglichkeiten:
# Normalerweise werden Vorlagen im Quelltext als <code><nowiki>{{Vorlage}}</nowiki></code> eingefügt. Wird der Artikel angezeigt, holt sich die Wiki-Software den Inhalt der Vorlage und stellt ihn an genau diese Stelle im Quelltext. Jede Änderung der Vorlage wird also auch an dieser Stelle angezeigt.
# Will man nur den Inhalt der Vorlage in den Artikel bringen, kann man die Vorlage auch ersetzen, oder ''substituieren''. Das wird durch <code><nowiki>{{subst:Vorlage}}</nowiki></code> erreicht. In diesem Fall wird die Stelle im Quelltext des Artikels mit dem Inhalt der Vorlage ersetzt, wenn man das Bearbeiten speichert. Die Vorlage selbst wird aber nicht mehr aufgerufen. Besonders hilfreich für Fälle, in denen wir den Artikelnamen mit <code><nowiki>{{subst:PAGENAME}}</nowiki></code> einbinden.
Mit Hilfe der geschweiften Klammern können auch komplette Artikel eingebunden werden. <code><nowiki>{{Portal:Hilfe}}</nowiki></code> würde beispielsweise das komplette Hilfe-Portal an dieser Stelle erscheinen lassen. Auch normale Artikel funktionieren. Die benötigen aber einen Doppelpunkt davor. <code><nowiki>{{:Testseite}}</nowiki></code> fügt den gesamten Artikel [[Testseite]] hinzu.
=== Vorlagen mit Variablen ===
Wir sehen schon an unserer kleinsten Vorlage, dass nicht nur reine Artikel eingebunden werden. Mit Hilfe von '''Variablen''' können wir innerhalb der Vorlage Dinge anzeigen und steuern, die nicht bei jeder Verwendung gleich aussehen sollen. <code><nowiki>{{SKU|1947}}</nowiki></code> ist daher ein gutes Beispiel, wie Vorlagen mit Variablen verwendet werden. Dabei gibt es wieder zwei Varianten:
# ''Variablen ohne Bezeichner'' werden einfach durch eine Pipe, <code><nowiki>|</nowiki></code>, getrennt. Wie bei der Vorlage SKU, die direkt hinter ihrem Namen die Jahreszahl erwartet um {{SKU|1947}} zu erstellen.
# ''Variablen mit Bezeichner'' werden angegeben, um vorrangig größere und komplexere Vorlagen zu nutzen. Auch diese Variablen werden mit <code><nowiki>|</nowiki></code> getrennt, jedoch steht nach der Pipe an erster Stelle der Name der Variable und ein <code><nowiki>=</nowiki></code>. So geben wir der Infobox unter anderem den deutschen und englischen Titel eines Werkes mit, indem wir <code><nowiki>{{Infobox|DT=Deutscher Titel|OT=Originaltitel}}</nowiki></code> verwenden. Die komplette Liste der Variablen befindet sich auf der [[Vorlage:Infobox|Dokumentationsseite der Vorlage]].
Variablen können hintereinanderweg oder untereinander geschrieben werden. Bei kleinen Vorlagen macht ein Zeilenumbruch wahrscheinlich nicht viel Sinn, vor allem, wenn sie in Fließtext eingebunden wird. Zur besseren Übersicht sollten aber bei größeren Vorlagen die Variablen in einer einzelnen Zeile stehen. Die Infobox für ''[[Carrie]]'' sieht zur Zeit (Dezember 2015) beispielsweise so aus:
<pre><nowiki>{{Infobox
|Titel=Roman
|isbn=3-8044-1655-1
|Bild=Carrie Bastei Kindle 2013
|Bild-Unterschrift=Cover der deutschen Taschenbuchausgabe
|DT=Carrie
|OT=Carrie
|SATZ=Notiz in der Wochenzeitung Enterprise vom 19. August 1966: STEINREGEN GEMELDET.
|VO=Double Day
|HO=[[04. April]] [[1974]]
|VD=Schneekluth
|NACHN=[[Brennen muß Salem]]
|NACHJ=1975
|HD=[[1977]]
|UE=Elisabeth Epple
|L=61.000
|HP=<ul><li>[[Carrie White]]</li><li>[[Sue Snell]]</li><li>[[Billy Nolan]]</li></ul>
}}</nowiki></pre>
Vermischungen dieser beiden Techniken sind theoretisch möglich, sollten aber nicht verwendet werden.
==Vorlagen erstellen==
{{weiterführend Hilfe}}
== Allgemeines zu Vorlagen ==
Vorlagen dienen hauptsächlich der Arbeitserleichterung für uns Autoren. Mann kann theoretisch bei jedem Werk von Stephen King die Infobox einzeln hinzufügen. Das zieht jedoch einen hohen Aufwand nach sich, um diese einheitlich und vor allem komplett in alle Artikel einzufügen. Außerdem muss jeder Artikel mit der Infobox überarbeitet werden, wenn sich etwas am Layout ändern sollte. Der einfachere Weg ist über die Vorlage.
Die gleiche Motivation steht hinter den ''weiterführend''-Vorlagen am Ende der meisten Artikel. Ergänzungen zu den dort gelisteten Artikeln müssen ohne Vorlage in jedem einzelnen Artikel nachgetragen werden. Mit der Vorlage ist das mit einer Bearbeitung getan.
Für Programmierer oder Entwickler sind Vorlagen nichts anderes als eine Funktion. Und genauso verhalten sie sich auch.
== Einbinden von Vorlagen in Artikeln ==
Das Einbinden ist einfach. Am schnellsten versteht man die Logik, wie eine Vorlage eingebunden werden soll, in dem man sich den Quelltext eines Artikels anschaut, in der die Vorlage bereits eingebunden wurde. Im groben gibt es zwei Möglichkeiten:
# Normalerweise werden Vorlagen im Quelltext als <code><nowiki>{{Vorlage}}</nowiki></code> eingefügt. Wird der Artikel angezeigt, holt sich die Wiki-Software den Inhalt der Vorlage und stellt ihn an genau diese Stelle im Quelltext. Jede Änderung der Vorlage wird also auch an dieser Stelle angezeigt.
# Will man nur den Inhalt der Vorlage in den Artikel bringen, kann man die Vorlage auch ersetzen, oder ''substituieren''. Das wird durch <code><nowiki>{{subst:Vorlage}}</nowiki></code> erreicht. In diesem Fall wird die Stelle im Quelltext des Artikels mit dem Inhalt der Vorlage ersetzt, wenn man das Bearbeiten speichert. Die Vorlage selbst wird aber nicht mehr aufgerufen. Besonders hilfreich für Fälle, in denen wir den Artikelnamen mit <code><nowiki>{{subst:PAGENAME}}</nowiki></code> einbinden.
Mit Hilfe der geschweiften Klammern können auch komplette Artikel eingebunden werden. <code><nowiki>{{Portal:Hilfe}}</nowiki></code> würde beispielsweise das komplette Hilfe-Portal an dieser Stelle erscheinen lassen. Auch normale Artikel funktionieren. Die benötigen aber einen Doppelpunkt davor. <code><nowiki>{{:Testseite}}</nowiki></code> fügt den gesamten Artikel [[Testseite]] hinzu.
=== Vorlagen mit Variablen ===
Wir sehen schon an unserer kleinsten Vorlage, dass nicht nur reine Artikel eingebunden werden. Mit Hilfe von '''Variablen''' können wir innerhalb der Vorlage Dinge anzeigen und steuern, die nicht bei jeder Verwendung gleich aussehen sollen. <code><nowiki>{{SKU|1947}}</nowiki></code> ist daher ein gutes Beispiel, wie Vorlagen mit Variablen verwendet werden. Dabei gibt es wieder zwei Varianten:
# ''Variablen ohne Bezeichner'' werden einfach durch eine Pipe, <code><nowiki>|</nowiki></code>, getrennt. Wie bei der Vorlage SKU, die direkt hinter ihrem Namen die Jahreszahl erwartet um {{SKU|1947}} zu erstellen.
# ''Variablen mit Bezeichner'' werden angegeben, um vorrangig größere und komplexere Vorlagen zu nutzen. Auch diese Variablen werden mit <code><nowiki>|</nowiki></code> getrennt, jedoch steht nach der Pipe an erster Stelle der Name der Variable und ein <code><nowiki>=</nowiki></code>. So geben wir der Infobox unter anderem den deutschen und englischen Titel eines Werkes mit, indem wir <code><nowiki>{{Infobox|DT=Deutscher Titel|OT=Originaltitel}}</nowiki></code> verwenden. Die komplette Liste der Variablen befindet sich auf der [[Vorlage:Infobox|Dokumentationsseite der Vorlage]].
Variablen können hintereinanderweg oder untereinander geschrieben werden. Bei kleinen Vorlagen macht ein Zeilenumbruch wahrscheinlich nicht viel Sinn, vor allem, wenn sie in Fließtext eingebunden wird. Zur besseren Übersicht sollten aber bei größeren Vorlagen die Variablen in einer einzelnen Zeile stehen. Die Infobox für ''[[Carrie]]'' sieht zur Zeit (Dezember 2015) beispielsweise so aus:
<pre><nowiki>{{Infobox
|Titel=Roman
|isbn=3-8044-1655-1
|Bild=Carrie Bastei Kindle 2013
|Bild-Unterschrift=Cover der deutschen Taschenbuchausgabe
|DT=Carrie
|OT=Carrie
|SATZ=Notiz in der Wochenzeitung Enterprise vom 19. August 1966: STEINREGEN GEMELDET.
|VO=Double Day
|HO=[[04. April]] [[1974]]
|VD=Schneekluth
|NACHN=[[Brennen muß Salem]]
|NACHJ=1975
|HD=[[1977]]
|UE=Elisabeth Epple
|L=61.000
|HP=<ul><li>[[Carrie White]]</li><li>[[Sue Snell]]</li><li>[[Billy Nolan]]</li></ul>
}}</nowiki></pre>
Vermischungen dieser beiden Techniken sind theoretisch möglich, sollten aber nicht verwendet werden.
==Vorlagen erstellen==
{{weiterführend Hilfe}}