Fg68at: Muss noch überarbeitet werden

2006-12-10T04:10:21Z

Muss noch überarbeitet werden

← Nächstältere Version		Version vom 10. Dezember 2006, 04:10 Uhr
Zeile 1:		Zeile 1:
	~~{{shortcut\|[[WP:VOR]]}}~~
	~~{{MediaWiki-Hilfe}}~~
	Eine '''Vorlage''' ist eine Seite, die sich als Textbaustein verwenden lässt, d. h. als vorgefertigten Text, der in einen anderen Text eingefügt wird. Die Hilfebox rechts zeigt eine Übersicht über Vorlagen, die in Artikeln verwendet werden.		Eine '''Vorlage''' ist eine Seite, die sich als Textbaustein verwenden lässt, d. h. als vorgefertigten Text, der in einen anderen Text eingefügt wird. Die Hilfebox rechts zeigt eine Übersicht über Vorlagen, die in Artikeln verwendet werden.

	== Vorlagen erzeugen und bearbeiten ==		== Vorlagen erzeugen und bearbeiten ==

	Eine Vorlage wird wie jede andere Wiki-Seite erzeugt, indem man einen Link <nowiki>[[Vorlage:Name]]</nowiki> auf einer Seite anlegt, dem Link folgt und die neue Seite bearbeitet und mit dem gewünschten Inhalt füllt. Vergiss dabei nicht den Namensvorsatz „Vorlage:" vor dem Namen der Vorlage. Allgemeine Tipps hierzu siehe: [[Wikipedia:Neue Seite anlegen\|Neue Seite anlegen]].		Eine Vorlage wird wie jede andere Wiki-Seite erzeugt, indem man einen Link <nowiki>[[Vorlage:Name]]</nowiki> auf einer Seite anlegt, dem Link folgt und die neue Seite bearbeitet und mit dem gewünschten Inhalt füllt. Vergiss dabei nicht den Namensvorsatz „Vorlage:" vor dem Namen der Vorlage. Allgemeine Tipps hierzu siehe: [[w:Wikipedia:Neue Seite anlegen\|Neue Seite anlegen]].

	Eine Vorlage kann grundsätzlich so bearbeitet werden wie ein klassischer Text. Auch lassen sich		Eine Vorlage kann grundsätzlich so bearbeitet werden wie ein klassischer Text. Auch lassen sich
Zeile 13:		Zeile 11:

	== Vorlagen verwenden ==		== Vorlagen verwenden ==
	[[Bild:~~Crochets modèle~~.png\|right\|95px\|Geschweifte Klammern]]		[[Bild:Geschweifte Klammern.png\|right\|95px\|Geschweifte Klammern]]
	Um eine einfache Vorlage in einem Artikel zu verwenden gibt es drei Möglichkeiten:		Um eine einfache Vorlage in einem Artikel zu verwenden gibt es drei Möglichkeiten:

Zeile 190:		Zeile 188:
	* [[Wikipedia:WikiProjekt Vorlagen]]		* [[Wikipedia:WikiProjekt Vorlagen]]

	~~[[Kategorie:~~Wikipedia:~~Vorlage~~\|~~!]]~~		{{Aus der Wikipedia-Name\|Hilfe:Vorlagen\|Hilfe:Vorlagen}}
	~~[[Kategorie~~:~~Wikipedia:Hilfe\|~~Vorlagen]]

GLGerman: http://de.wikipedia.org/w/index.php?title=Hilfe:Vorlagen&action=edit

2006-12-07T03:50:48Z

http://de.wikipedia.org/w/index.php?title=Hilfe:Vorlagen&action=edit

Neue Seite

{{shortcut|[[WP:VOR]]}}
{{MediaWiki-Hilfe}}
Eine '''Vorlage''' ist eine Seite, die sich als Textbaustein verwenden lässt, d. h. als vorgefertigten Text, der in einen anderen Text eingefügt wird. Die Hilfebox rechts zeigt eine Übersicht über Vorlagen, die in Artikeln verwendet werden.

== Vorlagen erzeugen und bearbeiten ==

Eine Vorlage wird wie jede andere Wiki-Seite erzeugt, indem man einen Link <nowiki>[[Vorlage:Name]]</nowiki> auf einer Seite anlegt, dem Link folgt und die neue Seite bearbeitet und mit dem gewünschten Inhalt füllt. Vergiss dabei nicht den Namensvorsatz „Vorlage:" vor dem Namen der Vorlage. Allgemeine Tipps hierzu siehe: [[Wikipedia:Neue Seite anlegen|Neue Seite anlegen]].

Eine Vorlage kann grundsätzlich so bearbeitet werden wie ein klassischer Text. Auch lassen sich
Vorlagen schachteln, d. h. innerhalb einer Vorlage können weitere Vorlagen verwendet werden. Vorlagen, die zur Verwendung in normalen Artikeln angelegt werden, benötigen eine Erklärung, die innerhalb von <noinclude> oder auf der Diskussionsseite angegeben werden kann.

Alle in eine Seite eingebundenen Vorlagen werden als Links unter dem Bearbeiten-Fenster aufgelistet.

== Vorlagen verwenden ==
[[Bild:Crochets modèle.png|right|95px|Geschweifte Klammern]]
Um eine einfache Vorlage in einem Artikel zu verwenden gibt es drei Möglichkeiten:

# Im Hauptanwendungsfall fügst du eine Vorlage mit '''<code><nowiki>{{Titel}}</nowiki></code>''' ein. Beim Anzeigen der Seite ersetzt die [[Hilfe:MediaWiki|MediaWiki-Software]] dies dann durch den Inhalt der Vorlage „Titel“. Ändert jemand die Vorlage, ändert sich dadurch auch die Darstellung.
# <tt><nowiki>{{subst:Titel}}</nowiki></tt> fügt ebenfalls den Inhalt der Vorlage ein, ersetzt den Text jedoch direkt beim Speichern. Auf diese Art werden zum Beispiel neue Benutzer [[Wikipedia:Begrüßung|begrüßt]], die anschließend auf ihrer Seite auch beim Bearbeiten den Text der Begrüßung vorfinden sollen und kein verwirrendes <tt><nowiki>{{Hallo}}</nowiki></tt>. Andere Vorlagen sind extra so konstruiert, dass man sie mit <tt><nowiki>{{subst:Titel}}</nowiki></tt> einbindet, z.B. die Vorlage Löschantrag.
# <tt><nowiki>{{msgnw:Titel}}</nowiki></tt> zeigt im Artikel den Quellcode der Vorlage an. Diese Funktion wird selten, eigentlich nur zur Erklärung von Vorlagen, gebraucht.

Seiten, die nicht im [[Wikipedia:Namensraum|Namensraum]] Vorlage stehen, lassen sich ebenfalls als Vorlage verwenden, wenn man den Namensraum angibt. Zum Beispiel würde <nowiki>{{Wikipedia:Fragen zur Wikipedia}}</nowiki> die Seite [[Wikipedia:Fragen zur Wikipedia]] als Vorlage einbinden. Will man eine Seite aus dem Artikelnamensraum einbinden, muss man einen Doppelpunkt vor den Namen setzen: So würde <nowiki>{{:Test}}</nowiki> beispielsweise den Artikel [[Test]] als Vorlage einbinden.

Seit Mediawiki 1.6 lassen sich zwei neue Tags in Vorlagen verwenden:
* Alles, was in einer Vorlage zwischen <tt><nowiki><includeonly></nowiki></tt> und <tt><nowiki></includeonly></nowiki></tt> steht, wird nur dann angezeigt, wenn die Vorlage auf einer anderen Seite eingebunden ist. Mit <tt><nowiki><includeonly></nowiki></tt> lassen sich alle Seiten, die eine bestimmte Vorlage enthalten, einer Kategorie hinzufügen.
* Alles, was in einer Vorlage zwischen <tt><nowiki><noinclude></nowiki></tt> und <tt><nowiki></noinclude></nowiki></tt> steht, wird dagegen nur dann angezeigt, wenn die Vorlage direkt betrachtet wird. Mit <tt><nowiki><noinclude></nowiki></tt> lassen sich so Vorlagen [[Wikipedia:Kategorien|kategorisieren]], mit entsprechenden Vorlagen in [[Wikipedia:Internationalisierung|anderen Sprachen verlinken]] oder eine Erklärung anfügen, wie die Vorlage verwendet wird.

== Parameter einfügen und verwenden ==

Oft sollen in einer Vorlage noch Inhalte auftauchen, die sich von Seite zu Seite ändern, zum Beispiel eine Unterschrift oder der Name des Bildes auf den Commons in der [[Vorlage:NowCommons]]. Das geschieht mit Parametern.

In der Vorlage kennzeichnet man durch drei geschweifte Klammern Stellen als Platzhalter, die entweder durchnummeriert oder frei benannt werden:

<nowiki>Nach Angaben von Wikipedianer {{{1}}} ist diese Seite kopiert von {{{2}}}</nowiki>
<nowiki>Nach Angaben von Wikipedianer {{{wikipedianer}}} ist diese Seite kopiert von {{{quelle}}}</nowiki>

Ein Parameter kann auch als Wikilink anklickbar erscheinen, wenn er mit zwei eckigen Klammern umgeben ist, wie zum Beispiel: <nowiki>[[{{{1}}}]]</nowiki>.

Wenn du eine solche Vorlage mit Parametern verwenden willst, gibst du nach dem Namen der Vorlage, getrennt mit einem senkrechten Strich, die Werte an:

<nowiki>{{Titel|wikiwichtel|http://www.irgendwo.de/}}</nowiki>
<nowiki>{{Titel|wikipedianer=wikiwichtel|quelle=http://www.irgendwo.de/}}</nowiki>

Hierbei ist zu beachten, dass die erste Schreibweise nur für nummerierte Parameter gilt und nicht auch für benannte. Die zweite Schreibweise empfiehlt sich bei Vorlagen, die mehrere, leicht verwechselbare Parameter enthalten.

Wenn ein Parameter nicht mit Inhalt befüllt wird, so erscheint er leer. In den Schwesterprojektvorlagen wird mit diesen Umstand sehr trickreich das Anlegen von mehreren Vorlagen für verschiedene Varianten vermieden, vgl. [[:Vorlage:Wiktionary]] und die verschiedenen Schreibweisen in [[Wikipedia:Textbausteine/Schwesterprojekte]].

Daneben existieren in MediaWiki auch einige [[Hilfe:Variablen|vordefinierte Variablen]], die als Parameter nützlich sind, zum Beispiel der Name der aktuellen Seite (<tt><nowiki>{{PAGENAME}}</nowiki></tt>).

''Achtung:'' Parameter im [[Hilfe:MediaWiki-Namensraum|MediaWiki-Namensraum]] werden anders verwendet ($1, $2 …).

=== Standardparameter definieren ===
Man kann einen Parameter so definieren, dass eine Eingabe optional ist, ohne Eingabe wird ein vorher definierter Parameter eingesetzt. Bei <nowiki>{{{1|</nowiki>'''<nowiki>{{PAGENAME}}</nowiki>'''<nowiki>}}}</nowiki> wird der erste eingegebene Parameter ausgegeben, ansonsten der Name des Artikels. Diese Konstruktionen belasten den Server nicht so stark wie fest definierte Parameter. Siehe auch [[meta:Help:Parameter default]].

=== Problem: Aufzählungszeichen ===
* Will man Aufzählungszeichen, wie am Anfang dieser Zeile, als Parameter benutzen, so sollte in der Vorlage vor dem Parameter eine neue Zeile begonnen werden, wie dies z. B. in der [[Vorlage:Infobox Film]] beim Parameter <nowiki>{{{DS}}}</nowiki> für Darsteller der Fall ist.

=== Problem: Gleichheitszeichen in Parametern ===
Wenn man einer Vorlage als einen Parameter, der nur durch eine Zahl im Vorlagencode eingebunden ist, Text übergibt, der ein Gleichheitszeichen enthält, „denkt“ die MediaWiki-Software, man wolle den Parameter mit der Bezeichnung des Textes vor dem Gleichheitszeichen nehmen.

Dieses Problem taucht beispielsweise auf, wenn man eine URL, in welcher ein Gleichheitszeichen enthalten ist (<nowiki>http://de.wikipedia.org/w/index.php?title=Hilfe:Vorlagen&action=edit&section=3</nowiki>), mit einem Parameter verlinken will.

Um dieses Problem zu umgehen, muss man lediglich dem Parameter, in dem das "=" vorkommt, beispielsweise dem <code>x</code>-ten Parameter, <code>x=</code> voranstellen (wobei <code>x</code> durch die entsprechende Zahl zu ersetzen ist und der Name der Vorlage nicht mitzählt).

{|
|Statt:
|<code><nowiki>{{Beispielvorlage|http://.../index.php?title=...&action=edit&section=3}}</nowiki></code><br />
|-
|Folgendes:
|<code><nowiki>{{Beispielvorlage|</nowiki><span style="color:#0000ff;">'''1='''</span><nowiki>http://.../index.php?title=...&action=edit&section=3}}</nowiki></code>
|}

Ein weiteres Beispiel, wenn man dem Parameterinhalt einen ''Style'' zuweisen möchte:<br />
{|
|Statt:
|<code><nowiki>{{Beispielvorlage|erster Parameter|a<span style="font-size:1.5em">b</span>c}}</nowiki></code><br />
|-
|Folgendes:
|<code><nowiki>{{Beispielvorlage|erster Parameter|</nowiki><span style="color:#0000ff;">'''2='''</span><nowiki>a<span style="font-size:1.5em">b</span>c}}</nowiki></code>
|}

=== Problem: Senkrechter Strich in Parametern ===
Da das Zeichen „|“ zur Trennung von Parametern eingesetzt wird, kann es nicht direkt in Parameterwerten vorkommen; somit kann beispielsweise nicht die normale Tabellensyntax in Parameterwerten verwendet werden. Aus diesem Grund gibt es folgende spezielle Vorlagen, die ausschließlich in Parameterwerten eingesetzt werden sollten:

{| {{prettytable}}
! {{highlight2}} | Vorlage
| <tt><nowiki>{{!}}</nowiki></tt>
| <tt><nowiki>{{!-}}</nowiki></tt>
| <tt><nowiki>{{!!}}</nowiki></tt>
| <tt><nowiki>{{!-!}}</nowiki></tt>
| <tt><nowiki>{{!+}}</nowiki></tt>
| <tt><nowiki>{{!~}}</nowiki></tt>
|-
! {{highlight2}} | Inhalt
| <tt><nowiki>|</nowiki></tt>
| <tt><nowiki>|-</nowiki></tt>
| <tt><nowiki>||</nowiki></tt>
| <tt><nowiki>|-</nowiki><br /><nowiki>|</nowiki></tt>
| <tt><nowiki>|+</nowiki></tt> 
| <tt><nowiki>|-</nowiki><br /><nowiki>!</nowiki></tt>
|}

== Einsatzmöglichkeiten ==

Vorlagen sind nur dann sinnvoll für Wikipedia, wenn es von ihnen nur eine überschaubare Anzahl gibt, die sich Benutzer auch merken können. Insbesondere sollten Vorlagen nicht doppelt oder sehr ähnlich entstehen. Um dies zu verhindern, sollten Vorlagen von allgemeiner Relevanz gefördert werden, indem sie in eine spezielle Liste in alphabetischer Reihenfolge eingetragen werden: [[Wikipedia:Textbausteine]] und/oder [[Wikipedia:Bewertungsbausteine]] bzw. [[Wikipedia:Textvorlagen]].

Vorlagen dienen in Wikipedia zur:
* '''Konsistenzmaximierung:''' Mit Vorlagen lässt sich ein einheitliches Erscheinungsbild erreichen. Bekannte Beispiele sind etwa die [[Vorlage:Begriffsklärung]] oder [[Vorlage:Commons]].
* '''Redundanzminimierung:''' Wenn der Inhalt zentral nur an einer Stelle festgelegt wird (d. h. in einer Vorlage), dann erscheint der Inhalt in allen Artikeln gleich, auch bei einer nachträglichen Änderung. Das mühselige und fehlerträchtige Übertragen einer Änderung in jeden Artikel entfällt. Bekannte Beispiele sind hier die so genannten [[Wikipedia:Navigationsleisten|Navigationsbausteine]].
* '''Workflowoptimierung:''' Mit einer Vorlage kann ein Wikiautor prägnant anderen Wikiautoren mitteilen, in welche Richtung ein Artikel verbessert werden sollte. Bekannte Beispiele sind: [[Vorlage:URV]] (Urheberverletzung), [[Vorlage:Überarbeiten]] oder [[Vorlage:Löschantrag]]. Bei der Verwendung der Vorlagen wird der Artikel automatisch in spezielle [[Aufgabenliste]]n (''to-do list'') für andere Wikiautoren oder Administratoren eingetragen.
* '''Codeoptimierung:''' Manche schöne Darstellung lässt sich nur mit einem unschönen Mix aus Wikibefehlen und HTML- bzw. CSS-Befehlen erreichen. Der Artikelquellcode wird dann schnell unübersichtlich und verschreckt Wikianfänger sich auch an der weiteren Verbesserung eines Artikels zu beteiligen. Hier kann eine Vorlage helfen, den Artikelquellcode lesbarer zu gestalten. Ein bekanntes Beispiel ist [[Vorlage:Gesprochene Wikipedia]].

Sie sollten nicht dienen als:
* '''Benutzersignaturen:''' Die Idee, Vorlagen für die eigene Benutzersignatur zu verwenden, mag ja gut klingen: man muss nur die Vorlage ändern und alle Signaturen, die man irgendwann mal hinterlassen hat, werden „aktualisiert“. Dabei sollte man aber die nicht ganz offensichtliche Tatsache bedenken, dass jede Benutzung einer Vorlage eine zusätzliche Anfrage an die Datenbank bedeutet und somit die Wikipedia belastet, ohne zum eigentlichen Zweck derselben beizutragen. Daher werden Signaturvorlagen nicht so gern gesehen. Man sollte lieber zu seinen alten Signaturen stehen.
* '''Abkürzung der Wikisyntax:''' Die Abkürzung von regelmäßig vorkommenden Textbausteinen durch Vorlagen mag praktisch sein (beispielsweise <tt><nowiki>{{BND}}</nowiki></tt> statt <tt><nowiki>[[Bundesnachrichtendienst]] der Bundesrepublik Deutschland</nowiki></tt>. Im normalen Fließtext haben Vorlagen jedoch nichts zu suchen, da sie die Bearbeitung für Außenstehende erschweren und die Artikeltexte so nicht mehr für sich verständlich sind.

== Vorlagen dokumentieren ==

Vorlagen, die in normalen Artikeln verwendet werden, sollten so einfach gestaltet sein, dass Zweck und Anwendung unmittelbar verständlich sind. In jedem Fall ist eine Beschreibung ihrer Funktion notwendig, vorzugsweise auf der Diskussionsseite. Insbesonders bei häufig eingebundenen Vorlagen bewirkt eine Änderung der Vorlage selbst, dass alle davon abhängigen Seiten bei einem erneuten Aufruf neu generiert werden müssen, anstatt sie aus dem Cache laden zu können. Diese Serverlast sollte vermieden werden. Befindet sich die Dokumentation auf einer Projektseite, so ist ein Hinweis auf diese mittels <nowiki><noinclude>...</noinclude></nowiki> innerhalb der Vorlage selbst möglich.

=== Hinweis mit noinclude ===
Unter- oder oberhalb einer Vorlage kann mit den Befehl <code><nowiki><noinclude></nowiki></code> eine Kurzerklärung gegeben werden. Eine Kurzerklärung bietet sich an, wenn ein Parameterbeispiel ausreicht wie etwa in [[:Vorlage:Link-Bild]]. Besser ist es aber, wenn auf eine Erklärungsseite unter [[Wikipedia:Textbausteine]] verwiesen wird, wie es vorbildlich bei der [[:Vorlage:Commons]] der Fall ist.

=== Ausführliche Dokumentation auf der Diskussionsseite ===
Für eine ausführliche Dokumentation eignet sich die Diskussionsseite einer Vorlage besser, insbesondere wenn Überschriften verwendet werden. Es wird folgende Gliederung mit Layout empfohlen. Ein Beispiel für [[Vorlage:Löschantrag]]:

<div class="hintergrundfarbe2 rahmenfarbe3" style="margin:1em; padding:1em; border-style:solid;">
* '''Funktion:''' Diese Vorlage dient dazu, einen Artikel zum Löschen vorzuschlagen
* '''Verwendung:'''
<tt><nowiki>{{subst:Löschantrag}} ''Deine Begründung'' --~~~~
----
</nowiki></tt>
</div>

<small><pre>
<nowiki><div style="margin:1em; padding:1em; border:solid 1px #FF0040; background-color:#FFFFFF">
* '''Funktion:''' Diese Vorlage dient dazu, ...
* '''Verwendung:'''
</div></nowiki>
</pre></small>

Um eine Reihe an Parametern zu erklären, ist es praktisch, den folgenden Code als Grundlage zu nehmen:

<pre><nowiki><div style="margin:1em; padding:1em; border:solid 1px #FF0040; background-color:#FFFFFF">
{{Überschriftensimulation 2|Funktion}}

Diese Vorlage tut dies und das.

{{Überschriftensimulation 2|Parameter}}

; Parameter 1: Dies.

; Parameter 2: Das.

</div></nowiki></pre>

Der Code erzeugt das Folgende:

<div class="hintergrundfarbe2 rahmenfarbe3" style="margin:1em; padding:1em; border-style:solid;">
{{Überschriftensimulation 2|Funktion}}

Diese Vorlage tut dies und das.

{{Überschriftensimulation 2|Parameter}}

; Parameter 1: Dies.

; Parameter 2: Das.
</div>

Falls noch weitere Punkte zur Vorlage erläutert werden müssen, kannst du sie nach dem Schema, wie es hier zu erkennen ist, erstellen.

Auf „[[Vorlage Diskussion:Phoninfo]]“ siehst du ein Beispiel zur Verwendung dieses Systems.

=== Kategorisierung ===

Jede Vorlage sollte in eine Kategorie eingeordnet werden. Dabei ist zu beachten, dass dies innerhalb von <tt><nowiki><noinclude>...</noinclude></nowiki></tt> geschieht, damit nur die Vorlage der Kategorie zugeordnet wird und nicht alle Seiten, in denen die Vorlage verwendet wird. Das [[Wikipedia:WikiProjekt Vorlagen|WikiProjekt Vorlagen]] erarbeitet eine [[Wikipedia:WikiProjekt Vorlagen/Projekt:Kategorisierung der Vorlagen|Systematik zur Kategorisierung aller Vorlagen]].

== Vorlagen testen ==

Vorlagen können auf der Spezialseite „[[Spezial:ExpandTemplates|ExpandTemplates]]“ getestet werden.

== Siehe auch ==
* [[Hilfe:Vorlagenprogrammierung]]
* [[meta:Help:Template]]
* [[Wikipedia:Textbausteine]]
* [[Wikipedia:Datenbanklinks]]
* [[Wikipedia:Formatvorlagen]]
* [[Wikipedia:Babel]]
* [[Wikipedia:WikiProjekt Vorlagen]]

[[Kategorie:Wikipedia:Vorlage|!]]
[[Kategorie:Wikipedia:Hilfe|Vorlagen]]

Hilfe:Vorlagen - Versionsgeschichte

Fg68at: Muss noch überarbeitet werden

GLGerman: http://de.wikipedia.org/w/index.php?title=Hilfe:Vorlagen&action=edit