Compare Revisions
Wie Vorlagen verwendet werden
Revision 15576:
Revision 15576 by ThomasLendo on
Revision 307796:
Revision 307796 by SumoBot on
Keywords:
Search results summary:
Wie Vorlagen verwendet werden
Wie Vorlagen verwendet werden
Content:
Vorlagen sind eine Möglichkeit, Textbausteine in der Wissensdatenbank wiederzuverwenden. Anstatt einen Text mehrmals zu schreiben, kannst du ihn an einer Stelle erstellen und aktualisieren und in einer anderen Seite darauf verweisen. Die andere Seite wird immer aktuell bleiben, da sich die Änderungen der Vorlage automatisch übertragen!
__TOC__
= Was sind Vorlagen =
Eine Vorlage ist einfach eine besondere Wikiseite, deren Name mit „Template:“ beginnt. Es besitzt all die Eigenschaften einer normalen Wikiseite: Es kann übersetzt werden, hat eine Versionsgeschichte und versteht die Wiki-Syntax.
= Wie erstelle ich eine Vorlage =
{note}Eine Liste aller existierenden Vorlagen findest du in der [https://wiki.mozilla.org/Support/Article_Tracking#Templates Übersicht für englische Vorlagen] bzw. in der [https://support.mozilla.com/de/kb/category/60 Kategorieübersicht für deutschsprachige Vorlagen].{/note}
#[https://support.mozilla.com/de/kb/new Erstelle einen neuen Wissensdatenbank-Artikel].
#Stelle sicher, dass der Name mit „Template:“ (mit einem großen '''T''') beginnt – z.B. [https://support.mozilla.com/de/kb/Template:aboutconfig Template:aboutconfig].
#Füge den Artikel der Kategorie „Vorlagen“ hinzu.
#Schreibe den Inhalt der Vorlage genau so, wie du einen normalen Wissensdatenbank-Artikel schreiben würdest.
= Wie eine Vorlage in einem Artikel eingebunden wird =
Um eine Vorlage in einer Wikiseite einzubinden, musst du nichts weiter tun als einen „Verweis“ auf die Vorlage zu setzen. Beispiel:
<code><nowiki>[[Template:Eine Vorlage]]</nowiki></code>
oder
<code><nowiki>[[T:Eine Vorlage]]</nowiki></code>
Anstatt damit eine Verknüpfung zu erzeugen, wird der Inhalt von '''Template:Eine Vorlage''' in die aktuelle Seite eingebunden. Jede Wiki-Syntax in der Vorlage wird wie in einer Wikiseite verarbeitet und dargestellt.
= Vorlagen und nummerierte Listen =
Meistens funktionieren nummerierte Listen in Vorlagen genau so, wie sie es auch in jedem anderen Wissensdatenbank-Dokument tun. Es gibt aber eine wichtige Ausnahme – '''wenn deine Vorlage eine nummerierte Liste ist, die als Teil einer größeren nummerierten Liste fungiert, wird keine durchgehende Nummerierung möglich sein.'''
'''Notlösung:'''<br/>
Verwende '''nicht''' „#“ in irgend einem Listenpunkt, sondern '''nutze''' <nowiki><li></nowiki> <nowiki></li></nowiki> vor und hinter dem zweiten und allen folgenden Listenpunkten wie hier:
<code>Dies ist der erste Schritt.<br>
<nowiki><li></nowiki>Dies ist der zweite.<nowiki></li></nowiki><br>
<nowiki><li></nowiki>Dies ist der dritte.<nowiki></li></nowiki><br></code>
Wenn du dann die Vorlage in einem Artikel verwendest, füge das „#“ vor der Vorlage ein:
<code><nowiki>#</nowiki><nowiki> [[</nowiki>T:Liste]]<br>
<nowiki>#</nowiki> Dies ist ein anderer Schritt, der nicht Teil der Vorlage ist.</code>
Das wird dann so aussehen:
# Dies ist der erste Schritt.
# Dies ist der zweite.
# Dies ist der dritte.
# Dies ist ein anderer Schritt, der nicht Teil der Vorlage ist.
= Argumente in einer Vorlage verwenden =
Vorlagen können Argumente übergeben werden, um „fast“ gleiche Inhalte wiederzuverwenden.
Wenn z.B. ein Hinweis dem Benutzer mitteilt, dass ein Dokument nur auf Firefox 4 zutrifft, kann eine andere Version des Hinweises aussagen, dass das Dokument nur auf Firefox 3.6 zutrifft. Der Text dieser Hinweise darf identisch sein mit Ausnahme der Firefox-Versionsnummer: ein perfekter Anwendungsfall für eine Vorlage!
'''Template:OnlyVersionX''':
{<!-- -->note}Dieses Dokument oder dieser Abschnitt bezieht sich nur auf <nowiki>'''Firefox {{{1}}}'''</nowiki>!{<!-- -->/note}
Damit kannst du in einer Wikiseite folgendes tun:
<nowiki>[[Template:OnlyVersionX|4]]</nowiki>
Und in einer anderen Seite kannst du schreiben:
<nowiki>[[Template:OnlyVersionX|3.6]]</nowiki>
Du kannst auch mehrere Argumente verwenden oder das selbe Argument zweimal!
'''Template:XmagY''':
<pre><nowiki># {{{2}}} mag {{{1}}}.
# {{{3}}} mag {{{2}}}.
# Super! Niemand mag {{{2}}}!</nowiki></pre>
So kannst du es dann verwenden:
<nowiki>[[Template:XmagY|Lisa Simpson|Milhouse|Janey]]</nowiki>
Das würde dann so aussehen:
<blockquote>
# Milhouse mag Lisa Simpson.
# Janey mag Milhouse.
# Super! Niemand mag Milhouse!
</blockquote>
Diese ganzen Nummern richtig zuzuweisen, kann verwirrend sein, darum kannst du auch ''Namen'' für Argumente einer Vorlage verwenden:
'''Template:XgehtYvoraus''':
Zuerst kommt {{{first}}}, dann folgt {{{second}}}.
Verwende es so:
<nowiki>[[Template:XgehtYvoraus|first=Liebe|second=Heirat]]</nowiki>
{note}Hinweis des Übersetzers: Was für ein blödes Beispiel, aber die US-Amerikaner mögen es halt pathetisch.{/note}
Mit Namensargumenten brauchst du dir auch keine Sorgen um die Reihenfolge in der Vorlage zu machen:
<nowiki>[[Template:XgehtYvoraus|second=Heirat|first=Liebe]]</nowiki>
Beide Beispiele für '''Template:XgehtYvoraus''' bringen das selbe Ergebnis.
Vorlagen sind eine Möglichkeit, Inhaltsteile in Wissensdatenbank-Artikeln wiederzuverwenden. Anstatt eine Reihe von Anweisungen mehrmals zu schreiben, kannst du sie an einem Ort erstellen und aktualisieren und dann auf anderen Seiten darauf verweisen. Die anderen Seiten werden bei Änderungen an der Vorlage automatisch auf dem neuesten Stand gehalten!
{warning}'''An die Übersetzer''': Wenn du Vorlagen lokalisierst, übersetze nicht den Namen der Seite – verwende einfach den ursprünglichen Namen! Wenn die Vorlage also ''Template:browsersettings'' heißt, übersetze keine der Elemente im Namen – verwende einfach ''Template:browsersettings'' in deiner Locale. Dies ist wichtig, damit die Vorlagen ordnungsgemäß funktionieren.{/warning}
__TOC__
= Was sind Vorlagen =
Eine Vorlage ist einfach eine besondere Wikiseite, deren Name mit „Template:“ beginnt. Es besitzt all die Eigenschaften einer normalen Wikiseite: Es kann übersetzt werden, hat eine Versionsgeschichte und versteht die Wiki-Syntax.
{note}Vorlagen sind auf [/de/contributors/kb-overview?category=60 dieser Seite] aufgelistet. Eine alphabetische Liste der vorhandenen Vorlagen findest du [/de/kb/category/60 hier].{/note}
=Wie erstelle ich eine Vorlage=
#[/de/kb/new Erstelle einen neuen Wissensdatenbank-Artikel]. Probiere es aus, indem du [https://support.allizom.org/de/kb/new einen neuen Wissensdatenbank-Artikel auf unserem Testserver erstellst].
#Stelle sicher, dass der Name mit „Template:“ beginnt – zum Beispiel [/de/kb/Template:aboutconfig Template:aboutconfig].
#Stelle die Kategorie auf „Vorlagen“ ein.
#Schreibe den Inhalt der Vorlage genau so, wie du einen normalen Wissensdatenbank-Artikel schreiben würdest.
= Wie eine Vorlage in einem Artikel eingebunden wird =
Um eine Vorlage in einer Wikiseite einzubinden, musst du nichts weiter tun als einen „Verweis“ auf die Vorlage zu setzen.
Zum Beispiel:
<code><nowiki>[[Template:Some Template]]</nowiki></code>
oder
<code><nowiki>[[T:Some Template]]</nowiki></code>
Anstatt damit eine Verknüpfung zu erzeugen, wird der Inhalt von '''Template:Some Template''' in die aktuelle Seite eingebunden. Jede Wiki-Syntax in der Vorlage wird wie in einer Wikiseite verarbeitet und dargestellt.
=Vorlagen und nummerierte Listen=
In den meisten Fällen funktioniert die Verwendung einer nummerierten Liste in einer Vorlage genauso wie in jedem anderen Wissensdatenbank-Dokument. Es gibt eine wichtige Ausnahme – '''wenn deine Vorlage eine nummerierte Liste ist, die als Teil einer größeren nummerierten Liste verwendet wird, funktioniert die Nummerierung nicht mehr.'''
'''Problemumgehung:'''<br>
Verwende '''nicht''' das Zeichen „#“ für die Listeneinträge und füge stattdessen <nowiki><li></nowiki> und <nowiki></li></nowiki> um den zweiten und die nachfolgenden Einträge hinzu, so wie hier:
<code>Dies ist der erste Schritt in deiner Liste<br>
<nowiki><li></nowiki>Dies ist der zweite Schritt<nowiki></li></nowiki><br>
<nowiki><li></nowiki>Dies ist der dritte Schritt<nowiki></li></nowiki><br></code>
Wenn du die Vorlage dann in einen Artikel einfügst, füge das Zeichen „#“ vor der Vorlage ein:
<code><nowiki>#</nowiki><nowiki>[[</nowiki>T:List]]<br>
<nowiki>#</nowiki>Dies ist ein weiterer Schritt, der nicht Teil der Vorlage ist</code>
Das sieht dann so aus:
#Dies ist der erste Schritt in deiner Liste
#Dies ist der zweite Schritt
#Dies ist der dritte Schritt
#Dies ist ein weiterer Schritt, der nicht Teil der Vorlage ist
Ein weiterer wichtiger Punkt: Du kannst in diesen Vorlagen kein [[Anleitung zur Verwendung von For#w_inline-and-block-level-contexts|{for} auf Blockebene]] verwenden. Zum Beispiel:<br>
'''Falsch:'''<br>
<code><nowiki>{</nowiki>for not fx10}<br>
Erster Schritt – Firefox 9 und niedriger<br>
<nowiki>{</nowiki>/for}<br>
<nowiki>{</nowiki>for fx10}<br>
Erster Schritt – Firefox 10 und höher<br>
<nowiki>{</nowiki>/for}<br>
<nowiki><li></nowiki>Dies ist der zweite Schritt<nowiki></li></nowiki></code>
'''Richtig:'''<br>
<code><nowiki>{</nowiki>for not fx10}Erster Schritt – Firefox 9 und niedriger<nowiki>{</nowiki>/for}<nowiki>{</nowiki>for fx10}<br>
Erster Schritt – Firefox 10 und höher<nowiki>{</nowiki>/for}<br>
<nowiki><li></nowiki>Dies ist der zweite Schritt<nowiki></li></nowiki></code>
= Argumente in einer Vorlage verwenden =
Vorlagen können Argumente übergeben werden, um „fast“ gleiche Inhalte wiederzuverwenden.
Wenn z.B. ein Hinweis dem Benutzer mitteilt, dass ein Dokument nur auf Firefox 4 zutrifft, kann eine andere Version des Hinweises aussagen, dass das Dokument nur auf Firefox 3.6 zutrifft. Der Text dieser Hinweise darf identisch sein mit Ausnahme der Firefox-Versionsnummer: ein perfekter Anwendungsfall für eine Vorlage!
'''Template:OnlyVersionX''':
{<!-- -->note}Dieses Dokument oder dieser Abschnitt bezieht sich nur auf <nowiki>'''Firefox {{{1}}}'''</nowiki>!{<!-- -->/note}
Damit kannst du in einer Wikiseite folgendes tun:
<nowiki>[[Template:OnlyVersionX|4]]</nowiki>
Und in einer anderen Seite kannst du schreiben:
<nowiki>[[Template:OnlyVersionX|3.6]]</nowiki>
Du kannst auch mehrere Argumente verwenden oder das selbe Argument zweimal!
'''Template:XmagY''':
<pre><nowiki># {{{2}}} mag {{{1}}}.
# {{{3}}} mag {{{2}}}.
# Super! Niemand mag {{{2}}}!</nowiki></pre>
So kannst du es dann verwenden:
<nowiki>[[Template:XmagY|Lisa Simpson|Milhouse|Janey]]</nowiki>
Das würde dann so aussehen:
<blockquote>
# Milhouse mag Lisa Simpson.
# Janey mag Milhouse.
# Super! Niemand mag Milhouse!
</blockquote>
Diese ganzen Nummern richtig zuzuweisen, kann verwirrend sein, darum kannst du auch ''Namen'' für Argumente einer Vorlage verwenden:
'''Template:XgehtYvoraus''':
Zuerst kommt {{{first}}}, dann folgt {{{second}}}.
Verwende es so:
<nowiki>[[Template:XgehtYvoraus|first=Liebe|second=Heirat]]</nowiki>
{note}Hinweis des Übersetzers: Was für ein blödes Beispiel, aber die US-Amerikaner mögen es halt pathetisch.{/note}
Mit Namensargumenten brauchst du dir auch keine Sorgen um die Reihenfolge in der Vorlage zu machen:
<nowiki>[[Template:XgehtYvoraus|second=Heirat|first=Liebe]]</nowiki>
Beide Beispiele für '''Template:XgehtYvoraus''' bringen das selbe Ergebnis.
= Richtlinien für die Wissensdatenbank =
Weitere Richtlinien zur Mitarbeit an der Wissensdatenbank erhältst du [https://support.mozilla.org/de/products/contributor/kb hier].