Hilfe:Vorlagen

aus Freepedia, der freien Wissensdatenbank

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. Sie sollte nur in wenigen, gut begründeten Fällen verwendet werden, beispielsweie für Portale, in denen ein Abschnitt häufig aktualisiert werden muss, und möglichst in Artikeln vermieden werden.

Vorlagen erzeugen und bearbeiten

Eine Vorlage wird wie jede andere Wiki-Seite erzeugt, indem man einen Link [[Vorlage:Name]] 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: 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 auch weitere Vorlagen verwendet werden.

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

Vorlagen verwenden

Um eine einfache Vorlage in einem Artikel zu verwenden gibt es drei Möglichkeiten: Im Hauptanwendungsfall fügst du eine Vorlage mit {{Titel}} ein. Beim Anzeigen der Seite ersetzt die MediaWiki-Software dies dann durch den Inhalt der Vorlage "Titel". Ändert jemand die Vorlage, ändert sich dadurch auch die Darstellung.

{{subst:Titel}} fügt ebenfalls den Inhalt der Vorlage ein, ersetzt den Text jedoch direkt beim Speichern. Auf diese Art werden zum Beispiel neue Benutzer begrüßt, die anschließend auf ihrer Seite auch beim Bearbeiten den Text der Begrüßung vorfinden sollen und kein verwirrendes {{Hallo}}.

{{msgnw:Titel}} zeigt im Artikel den Quellcode der Vorlage an. Diese Funktion wird selten, eigentlich nur zur Erklärung von Vorlagen, gebraucht.

Seiten, die nicht im Namensraum Vorlage stehen, lassen sich ebenfalls als Vorlage verwenden, wenn man einen Doppelpunkt davorsetzt. So würde {{:Hauptseite}} beispielsweise die gesamte Hauptseite als Vorlage einbinden. Das funktioniert allerdings offenbar nicht beim Wikipedia-Namensraum.

Seit Mediawiki 1.6 lassen sich zwei neue Tags in Vorlagen verwenden:

• Alles, was in einer Vorlage zwischen <includeonly> und </includeonly> steht, wird nur dann angezeigt, wenn die Vorlage auf einer anderen Seite eingebunden ist. Mit <includeonly> lassen sich alle Seiten, die eine bestimmte Vorlage enthalten, einer Kategorie hinzufügen.
• Alles, was in einer Vorlage zwischen <noinclude> und </noinclude> steht, wird dagegen nur dann angezeigt, wenn die Vorlage direkt betrachtet wird. Mit <noinclude> lassen sich so Vorlagen kategorisieren, mit entsprechenden Vorlagen in anderen Sprachen verlinken oder eine Erklärung anfügen, wie die Vorlage verwendet wird.

Achtung: Dies funktioniert nicht, wenn die Vorlage mit {{subst:Vorlage}} benutzt wird. In einem solchen Fall kann man nur {{interwiki|"Interwikis"}} auf der Diskussionseite einfügen. (Problem Lösung). Siehe auch Bugzilla Nr 3298.

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:

Nach Angaben von Wikipedianer {{{1}}} ist diese Seite kopiert von {{{2}}}
Nach Angaben von Wikipedianer {{{wikipedianer}}} ist diese Seite kopiert von {{{quelle}}}

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

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

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

Die zweite Schreibweise empfiehlt sich bei Vorlagen, die mehrere, leicht verwechselbare Parameter enthalten.

Daneben existieren in MediaWiki auch einige vordefinierte Variablen, die als Parameter nützlich sind, zum Beispiel der Name der aktuellen Seite ({{PAGENAME}}).

Achtung: Parameter im MediaWiki-Namensraum werden anders verwendet ($1, $2 …).

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 {{{DS}}} 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. Um dieses Problem zu umgehen, muss man lediglich 1= (die entsprechende Zahl einsetzen) schreiben.

Beispiel:
statt: {{Beispielvorlage|a<span style="font-size:1.5em">b</span>c}}
folgendes: {{Beispielvorlage|1=a<span style="font-size:1.5em">b</span>c}}

„Vorlage:Phoninfo“ verwendet es zum Beispiel, da die Seiten, die die Vorlage „Phoninfo“ benutzen, den Text durch HTML-Tags vergrößern.

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:Commons1.
• 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 sogenannten 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 ToDo-Listen 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.

Vorlagen erklären

Wenn eine Vorlage nicht intuitiv verständlich ist, solltest du oben auf der Diskussionsseite in einem Kasten beschreiben, wozu die Vorlage dient, wie man sie verwendet und was die einzelnen Parameter der Vorlage bedeuten. Ein Beispiel für Vorlage:Löschantrag:

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

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

<div style="margin:1em; padding:1em; border:solid 1px #FF0040; background-color:#FFFFFF"> {{Überschriftensimulation 2|Funktion}} Diese Vorlage tut das und das. {{Überschriftensimulation 2|Parameter}} ; Parameter 1 : Dies. ; Parameter 2 : Das. </div>

Der Code erzeugt das Folgende:

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.

Vorlagen testen

Um Vorlagen zu testen, kannst du die dafür vorgesehene Vorlage:SpielwiesenVorlage benutzen. Bitte denke daran, bei längeren Tests {{inuse}} einzufügen und nach dem Spielen wieder zu entfernen. Teste die Vorlage nur auf der Spielwiese.

Siehe auch

• meta:Help:Template
• Wikipedia:Datenbanklinks
• Wikipedia:Formatvorlagen