Hilfe:Templates (Vorlagen)

This page is a translated version of the page Help:Templates and the translation is 84% complete.
Outdated translations are marked like this.
PD Hinweis: Wenn Du diese Seite bearbeitest, stimmst Du zu, dass Dein Beitrag unter der [CC0] veröffentlicht wird. Mehr Informationen findest du auf der Public Domain Hilfeseite. PD

Wenn du Standardtexte verwendest, die auf mehreren Seiten erscheinen sollen, kommt die MediaWiki-Funktion Template ins Spiel. Anders als Erweiterungen und Mediendateien gibt es keine zentrale Quelle für Templates. Templates können neu geschrieben oder, um doppelte Arbeit zu sparen, von einem anderen Wiki wie z.B. Wikipedia exportiert und dann ins Zielwiki importiert werden.

Grundlagen

Templates sind Standard-Wiki-Seiten, deren Inhalt so konzipiert ist, dass er in andere Seiten transkludiert (eingebunden) werden kann. Templates folgen einer Konvention, laut welcher dem Namen das Präfix „Template:“ vorangestellt wird, um sie diesem Namensraum zuzuweisen; abgesehen davon können sie wie jede andere Wiki-Seite erstellt werden.

Um ein Template einzufügen, verwende doppelte geschweifte Klammern, um den {{Template-Namen}} herum.

Die einfachste Verwendung von Templates ist die folgende: Erstelle eine Seite mit dem Namen Template:Welcome und folgendem Inhalt:

Hallo! Willkommen im Wiki.

Du hast dein erstes Template erstellt! Füge nun den unten stehenden Code in eine neue Seite ein:

{{Welcome}}

Wenn die neue Seite aufgerufen wird, erscheint der Text „Hallo! Willkommen im Wiki“ anstelle von {{Welcome}}. Der Inhalt des Templates wird in die andere Seite transkludiert, d.h. er wird in die Seite integriert.

Du kannst dann {{Welcome}} an jeder beliebigen Stelle einer Seite einfügen, auf der du jemanden begrüßen möchtest. Nehmen wir an, es wird auf 100 Seiten verwendet. Wenn dann der Inhalt des Templates in geändert wird:

Hallo zusammen! Willkommen in diesem wundervollen Wiki.

und man eine der 100 Seiten, in der die Vorlage verwendet wurde, erneut besucht, wirst du den neuen Text anstelle des ursprünglichen sehen. Auf diese Weise kann man die Inhalte von 100 Seiten ändern, ohne diese bearbeitet zu haben – und das nur, weil die Vorlage in diese Seiten eingebunden ist.

Dies ist die grundsätzliche Funktionsweise. Es gibt viele zusätzliche Funktionen, die diese Funktionsweise erweitern und die Verwendung von Vorlagen sehr nützlich machen.

Wie man eine Vorlage aufruft

Templates können in anderen Seiten auf diese Weise verwendet werden:

  • {{Name}} – Wie oben beschrieben, wird dieser Text (allgemein als „Template-Call“ bezeichnet) dynamisch durch den Inhalt der Seite mit dem Titel Template:Name ersetzt (ein Prozess, der "Transklusion" genannt wird), jedes Mal, wenn die Seite mit dem Template-Call geladen wird (d.h. aus Sicht eines Lesers des Wikis). Da der Template-Call im Quelltext der Seiten verbleibt, wird jede spätere Änderung an Template:Name auf der Seite sichtbar, die den Template-Call enthält. Außerdem wird die Seite unter den Seiten aufgelistet, die auf das Template „verweisen“.
  • {{subst:Name}} — wenn diese Art des Aufrufs einer Vorlage verwendet wird, wird sie durch eine statische Kopie des Inhalts von Vorlage:Name ab dem Zeitpunkt ersetzt, an dem die Seite, die den Vorlagenaufruf enthält, gespeichert wird. Das heißt, eine Kopie des Inhalts von Vorlage:Name wird für den Aufruf der Vorlage ersetzt. Es gibt keine Verknüpfung zwischen der Seite und dem Template, sodass beide unabhänig voneinander bearbeitet werden können. Tatsächlich besteht deshalb kaum ein Unterschied zwischen dieser Vorgehensweise und dem üblichen Weg, also den Text "manuell" in den Quelltext einzugeben. Für weitere Informationen siehe Hilfe:Substitution .
  • {{safesubst:Name}} — Dies wurde eingeführt, um rekursive Ersetzungen in Fällen zu ermöglichen, in denen Vorlagen Aufrufe anderer Vorlagen oder Parser-Funktionen enthalten. Für weitere Informationen siehe Hilfe:Substitution .
  • {{msgnw:Name}} — Dadurch wird der Inhalt der Vorlage als reine Wiki-Syntax (wie bei ‎<nowiki>) angezeigt, wenn die Seite, die sie enthält, angezeigt wird. Zum Beispiel zeigt {{msgnw:Template:Thankyou}}:

<noinclude> <languages/> </noinclude> '''Ein kleines Dankeschön...''' für {{{reason|{{{1}}}}}}. Grüße, {{{signature|{{{2}}}}}} <noinclude> [[Category:Template examples{{#translation:}}|{{PAGENAME}}]] </noinclude>

Jede Wikiseite kann als Vorlage verwendet werden. Einfach, indem man den Namensbereich angibt, dem sie angehört.

  • {{Template:Pagename}} bindet [[Template:Pagename]] ein (identisch zu {{Pagename}})
  • {{Talk:Pagename}} bindet Talk:Pagename ein
  • {{:Pagename}} bindet die Seite Pagename ein (im Hauptnamensraum)
    • {{subst::Pagename}} ersetzt den Inhalt der Seite mit dem Titel Pagename

Wenn kein solcher Namensraum vorhanden ist, wird angenommen, dass der vollständige Titel der Vorlagenname ist.

  • {{Foo:Bar}} transkludiert Template:Foo:Bar

Unabhängig davon, welche Syntax verwendet wird, kann der Name der Vorlage relativ zur aktuellen Seite sein Wenn z.B. {{/bar}} auf Seite foo aufgerufen wird, wird die Seite foo/bar transkludiert.

Sie kann auch dynamisch erzeugt werden. Zum Beispiel ruft {{ {{foo}} }} Template:foo auf und interpretiert das Ergebnis als den Namen einer anderen aufzurufenden Vorlage.

Parameter

Um die Funktionalität von Templates zu erweitern erlaubt es MediaWiki, Parameter an die Vorlage zu übergeben, wenn sie eingebunden wird. Parameter ermöglichen es dem Template, unterschiedliche Inhalte zu erzeugen oder sich unterschiedlich zu verhalten.

Angenommen, du möchtest auf der Talk-Seite anderer Benutzer ein kleines Dankeschön einfügen, wie z. B.:


Ein kleines Dankeschön... für für all deine Bemühungen. Grüße, Ich


Die Dankesnote wird einen Grund (in diesem Fall, für all deine Bemühungen) und eine Unterschrift (Ich) enthalten. Dein Ziel ist es, dass jeder Benutzer jedem anderen Benutzer danken kann, aus einem beliebigen Grund.

Damit die Notiz überall, wo sie verwendet wird, ähnlich aussieht, kann beispielsweise eine Vorlage namens Template:Thankyou definiert werden. Obwohl die Notiz überall, wo sie verwendet wird, ähnlich aussehen soll, wenn ein User einem anderen dankt, wird der genaue Inhalt (d.h. der Grund un die Signatur) unterschiedlich sein. Aus diesem Grund sollten diese als Parameter übergeben werden. Wenn wir die verbleibenden Elemente zur Formatierung der Box und zum Platzieren des Bildes ignorieren, lautet der Kerninhalt der Vorlage wie folgt:

'''Ein kleines Dankeschön...'''
für {{{1}}}.
Grüße, {{{2}}}

Die Verwendung von {{{1}}} und {{{2}}} muss beachtet werden. Auf diese Weise können innerhalb von Vorlagen die Parameter identifiziert werden, die bei der Verwendung der Vorlage angegeben werden. Beachte, dass jeder Parameter der Vorlage von drei Klammern umgeben ist: {{{ }}}. Dies unterscheidet sich von der normalen Verwendung des Namens der Vorlage.

Bei der Verwendung einer Vorlage auf einer Seite werden die Parameterwerte durch ein "Pipe"-Zeichen getrennt (|). MediaWiki erlaubt Parameter auf drei Arten an Vorlagen zu übergeben: Anonym, nummeriert und benannt.

Anonyme Parameter

Um anonyme Parameter zu übergeben, müssen die Werte der Parameter der Reihe nach aufgelistet werden:

F{{Thankyou/de|deine Bemühungen|Ich}}

In diesem Fall erhält die Vorlage {{Thankyou/de}} die Parameter {{{1}}}=deine Bemühungen und {{{2}}}=Ich, was folgendes erzeugt:


Ein kleines Dankeschön... für deine Bemühungen. Grüße, Ich


Die Reihenfolge, in der anonyme Parameter übergeben werden, ist entscheidend für ihr Verhalten. Das Tauschen der Parameter wie folgendend:

{{Thankyou/de|Ich|deine Bemühungen}}

würde dieses Ergebnis erzeugen:


Ein kleines Dankeschön... für Ich. Grüße, deine Bemühungen


Das Identifizieren von Parametern nach Reihenfolge (mit {{{1}}} usw.) funktioniert nur mit anonymen Parametern. Alle namentlich identifizierten Parameter, wie unten gezeigt, sind für die Vorlage nicht über Ordnungszahlen zugänglich.
Wenn ein Gleichheitszeichen innerhalb des Arguments eines anonymen Parameters einer Vorlage vorkommt, wird dieser Parameter möglicherweise als ein Benannter Parameter (was weiter unten in diesem Dokument erläutert wird) falsch interpretiert, wodurch der Text vor dem Gleichheitszeichen als Parametername und der Text danach als der Wert des Arguments. Dies ist ein häufiges Problem, wenn du einen externen Link oder ein HTML-Element mit Attributen erfasst (siehe T16235). Um das Problem zu umgehen, können benannte oder nummerierte Parameter verwendet werden, wie im folgenden Abschnitt erläutert wird.

Nummerierte Parameter

Um Parameter nummeriert zu übergeben, werden alle Parameter beim Übergeben identifiziert:

{{Thankyou/de|2=Ich|1=deine Freundschaft}}

Dieses Mal erhält die Vorlage {{Thankyou/de}} die Parameter {{{1}}}=deine Freundschaft und {{{2}}}=Ich, was folgendes erzeugt, obwohl die Parameter in umgekehrter Reihenfolge übergeben wurden:


Ein kleines Dankeschön... für deine Freundschaft. Grüße, Ich


Dies kann auch nützlich sein, wenn einer der nummerierten Parameter ein "="-Zeichen erhält.
Beispiele
{{Thankyou|1=Hinzufügen von „=“|2=Ich}}

erzeugt:


Ein kleines Dankeschön... für hinzufügen von "=". Grüße, Ich

  Warnung: Dies setzt voraus, dass jeder zusätzliche Parameter nummeriert wird.

Benannte Parameter

Der dritte Weg, um Parameter zu übergeben, ist mit Namen statt mit Nummern. In diesem Fall würde der Inhalt der Vorlage zu folgendem geändert werden:

'''Ein kleines Dankeschön...'''
for {{{reason}}}.
hugs, {{{signature}}}

Innerhalb der Vorlage werden {{{reason}}} und {{{signature}}} statt Nummern verwendet, um jeden Parameter zu identifizieren. Um Parameter benannt zu übergeben, werden alle Parameter beim Übergeben identifiziert:

{{Thankyou/de|signature=Ich|reason=sein, wer du bist}}

In diesem Fall erhält die Vorlage {{Thankyou/de}} die Parameter {{{reason}}}=sein, wer du bist und {{{signature}}}=Ich und erzeugt:


Ein kleines Dankeschön... für sein, wer du bist. Grüße, Ich


Benannte Parameter beachten Groß- und Kleinschreibung, weswegen:

{{Thankyou/de|signature=Ich|Reason=sein, wer du bist|reason=Beachtung der Groß- und Kleinschreibung}}

folgendes erzeugt:


Ein kleines Dankeschön... für Beachtung der Groß- und Kleinschreibung. Grüße, Ich


Der Vorteil der Verwendung von benannten Namensräumen in einer Vorlage ist, neben der Flexibilität der Reihenfolge der Parameter bei der Übergabe, dass der Code der Vorlage leichter zu verstehen ist, wenn viele Parameter vorkommen.

Leerzeichen und Zeilenumbrüche werden automatisch am Anfang und Ende von benannten Parameternamen und -werten entfernt, bleiben aber bei unbenannten Parametern erhalten.

Benannte und unbenannte Parameter mischen

Falls die Vorlage dies unterstützt, können beide Arten von Parametern in einem Aufruf verwendet werden.

Zum Beispiel führt {{Thankyou|die Unterstützung beider Parametertypen|signature=Ich}} zu:


Ein kleines Dankeschön... für die Unterstützung beider Parametertypen. Grüße, Ich


Gehen Sie dabei vorsichtig vor, da dies zu kontraintuitiven Ergebnissen führen kann, da die Anzahl der unbenannten Parameter nur auf den unbenannten Parametern und nicht auf den benannten Parametern basiert. Zum Beispiel führt {{Thankyou|Ich|reason=die Unterstützung beider Parametertypen}} zu:


Ein kleines Dankeschön... für die Unterstützung beider Parametertypen. Grüße, {{{2}}}


Die Vorlage ist so codiert, dass aus diesem Grund der benannte Parameter dem unbenannten Parameter vorgezogen wird, was dazu führt, dass das "Ich" verloren geht und keine Signatur angegeben wird. Dies führt dazu, dass ein Standardwert von {{{2}}} angezeigt wird, wie unten erläutert.

Standardwerte

Beim Einsetzen einer Vorlage, die Parameter erwartet, ohne Argumente bereitzustellen, wie folgend:

{{Thankyou/de}}

würde bei nummerierten Parametern, wie im oberen Beispiel, folgendes Ergebnis erzeugt werden:


Ein kleines Dankeschön... für {{{1}}}. Grüße, {{{2}}}


Da keine Argumente übergeben wurden präsentiert die Vorlage die bloßen Parameter statt der repräsentierten Werte. In diesem Fall wäre es hilfreich, Standardwerte für Parameter zu erzeugen, d.h. Werte, die benutzt werden, wenn keine Werte übergeben werden. Zum Beispiel, wenn die Werte der Vorlage zu folgendem geändert werden:

'''Ein kleines Dankeschön...'''
für {{{reason|alles}}}.
Grüße, {{{signature|Ich}}}

dann definiert {{{reason|alles}}}, dass, wenn keine Argumente übergeben werden, für den Parameter {{{reason}}}, der Wert alles verwendet. Genauso definiert {{{signature|Ich}}} den Standardwert des Parameters {{{signature}}} als den Wert Ich. Wenn jetzt die Vorlage eingesetzt wird, ohne Argumente zu übergeben, wird folgendes Ergebnis erzeugt:


Ein kleines Dankeschön... für alles. Grüße, Ich


Der Wert eines Parameters kann eine leere Zeichenkette sein. Beispielsweise betrachtet die Vorlage foo in {{foo|bar=}} oder {{foo|bar=|baz=qux}} den Parameter bar als "". Dies ist etwas anderes als das Weglassen des Parameters, wodurch er undefiniert bleibt und der oben beschriebene Mechanismus des Standardwerts ausgelöst wird.
Wenn Sie eine leere Zeichenfolge genauso behandeln müssen wie einen fehlenden Parameter, können Sie einen bedingten Operator über eine Erweiterung wie ParserFunctions verwenden. Beispielsweise gibt {{#if:{{{1|}}}|{{{1|}}}|undefined}} „undefined“ zurück, wenn der Parameter entweder undefiniert oder leer ist, während {{{1|undefined}}} dies nur tut, wenn der Parameter undefiniert ist.

Häufig werden Standardwerte verwendet, um alternative Namen von Parametern anzugeben. Wenn du beispielsweise {{{a|{{{b|}}} }}} hast, sucht die Vorlage zuerst nach einem Parameter namens "a". Wenn es nicht gesetzt ist, wird es den Parameter namens "b" verwenden. Wenn weder "a" noch "b" gesetzt ist, wird nichts ausgegeben.

Parameter an andere Vorlagen übergeben

Wenn durch den obigen Vorlagenaufruf eine unformatierte Parametersyntax generiert und anschließend an eine andere Vorlage übergeben wird, wird diese nicht als Parameter interpretiert. Dies bedeutet, dass {{Thankyou2 }}, das lediglich {{Thankyou }} ohne Parameter aufruft, nicht funktioniert: {{thankyou2|everything|me}}Ein kleines Dankeschön... für {{{1}}}. Grüße, {{{2}}}


Sie müssen stattdessen den Parameter explizit an die andere Vorlage übertragen, d. h. wenn {{Thankyou3 }} enthält

{{thankyou|{{{1}}}|{{{2}}}}}

dann funktioniert es ordnungsgemäß: {{thankyou3|everything|me}}Ein kleines Dankeschön... für everything. Grüße, me


In diesem Beispiel wird die Leere vs. Undefiniertheit in Parameterwerten nicht beibehalten – dazu wäre eine kompliziertere Syntax erforderlich.

Leere vs. undefinierte Parameter

Das {{t2demo|| a }} (siehe {{T2demo }} ) mit einem doppelten Pipe setzt den ersten Parameter auf eine leere Zeichenkette, anstatt ihn undefiniert zu lassen. Es erzeugt die Ausgabe von start--middle- a -end, ähnlich wie {{t2demo|1=|2= a }} in start--middle- a -end. Wenn Sie hingegen den Parameter „2“ explizit auf „a“ setzen, bleibt der erste unbenannte Parameter „undefined“ (undefiniert):

{{t2demo|2= a }} ergibt start-{{{1}}}-middle- a -end

Wenn der zweite Parameter nicht getrimmt werden soll, muss er unbenannt sein.

Daher können Sie dem ersten Parameter eine leere Zeichenfolge zuweisen, ihn jedoch nicht undefiniert lassen.

Leere und Unbestimmtheit gleichsetzen

Gute Programmierpraktiken für Vorlagen führen dazu, dass eine leere Zeichenfolge an einen Parameter übergeben wird, was genauso funktioniert, als würde kein Wert zugewiesen werden. Dies vereinfacht die Handhabung und sorgt für mehr Konsistenz.

Beispielsweise kann die Verwendung von p= zeigen, dass ein Vorlage einen Parameter "p" hat, der noch keinen Wert hat.

Um eine leere Zeichenfolge und ein unbestimmtes Wertäquivalent zu erstellen, verwenden Sie folgende Ansätze:

  • Verwenden Sie {{{p|}}} ausschließlich anstelle von {{{p}}} oder q, wo "q" ein nicht leerer Wert ist.
  • Verwenden Sie bedingte Prüfungen wie {{#if:{{{p|}}}|..{{{p}}}..|..}}, um sicherzustellen, dass {{{p}}} nur verwendet wird, wenn es einen Wert hat.

Wenn Sie aus irgendeinem Grund unbestimmte Parameter anders als leere Parameter oder einen anderen möglichen Wert behandeln möchten, können Sie den gleichen Parameter zweimal mit verschiedenen Standardwerte vergleichen, d.h. {{#ifeq:{{{foo|bar}}}|{{{foo|baz}}}|parameter is defined|parameter is undefined}}.

Verwendung von Gleichheitszeichen in unbenannten Parametern

Unbenannte Parameter können Gleichheitszeichen enthalten, dies muss jedoch indirekt erfolgen. Hier sind einige Methoden, bei denen template:T1demo verwendet wird:

Standardwert für einen nicht definierten Parameter

Weisen Sie einem undefinierten Parameter einen Standardwert zu:

{{T1demo|{{{1| a=b }}}}}

Dies wird wie folgt dargestellt: start a=b end.

Verwendung der {{=}}-Parser-Funktion

Verwenden Sie eine Parser-Funktion, die ein Gleichheitszeichen sicher einfügt:

{{T1demo| a{{=}}b }}

Dies wird wie folgt dargestellt: start a=b end.

HTML-Entitäten

Ersetzen Sie das Gleichheitszeichen durch eine HTML-Entität für die Anzeige:

{{T1demo| a&#61;b }}

Dies wird wie folgt dargestellt: start a=b end.

Dies wird korrekt gerendert, ohne die anderen Parameter zu beeinflussen.

Umgang mit nicht geschlossenen geschweiften und eckigen Klammern

Nicht geschlossene geschweifte Klammern ({{, }}) oder eckige Klammern ([[, ]]) müssen innerhalb von nowiki-Tags stehen oder HTML-Entitäten verwenden:

  • Für die Darstellung von geschweiften Klammern gibt es zwei Optionen:
    • 1 $ oder 2 $ für 3 $ verwenden
    • Verwende <nowiki>}}</nowiki> oder &#125; für }.
  • Verwende &#91; für [ und &#93; für ].

Hier sind einige Beispiele:

Nicht geschlossene geschweifte Klammern
{{T1demo| <nowiki>{{</nowiki>content<nowiki>}}</nowiki> }}

Dadurch werden die geschweiften Klammern korrekt dargestellt, ohne die Vorlage zu zerstören.

Nicht geschlossene eckige Klammern
{{T1demo| text [link] more text }}

Dadurch werden die Klammern korrekt dargestellt, ohne die Vorlage zu zerstören.

Dies wird wie folgt dargestellt: start text [link] more text end

Nicht in nowiki-Tags gesetzte ungleiche Paare verhindern entweder die Erweiterung der Vorlage oder werden als schließende Klammern für den Vorlagenaufruf genommen.

Hier sind einige Beispiele:

{{T1demo|abc]]def[[ghi}}

Das wird wegen nicht geschlossener Klammern nicht richtig funktionieren.

Die richtige Verwendung:

{{T1demo|abc<nowiki>]]</nowiki>def<nowiki>[[</nowiki>ghi}}

Dies wird wie folgt dargestellt: startabc]]def[[ghiend

Mit Vorlagen erstellte Klammern

Eine andere Möglichkeit, Argumente mit nicht zusammenpassenden Klammern zu übergeben, besteht darin, sie in eine andere Vorlage zu setzen. In diesem Fall (was bei {{(( }} und {{)) }}) in diesem Wiki der Fall ist) werden die nicht zusammengehörigen Klammern einfach so angezeigt und nicht als weiterer Vorlagenaufruf entschlüsselt. Zum Beispiel:

{{t1demo|{{((}}t1demo{{))}}}}

ergibt: start{{t1demo}}end

Beim Ersetzen einer Vorlage werden Vorlagen einmal beim Ersetzen (mit den oben genannten Einschränkungen) und dann noch mal beim Rendern des resultierenden Wikitextes analysiert. Zum Beispiel:

{{subst:((}}t1demo|foo}}

wird beim Speichern erweitert zu:

{{t1demo|foo}}

was wird dann so angezeigt wird:

startfooend

Wenn der durch das erste subst erzeugte Wikitext selbst die Syntax „subst:“ enthält, wird er beim Speichern nicht verarbeitet, aber vielleicht beim nächsten Speichern. Diese Technik kann verwendet werden, um rekursive Ersetzungen zu implementieren, deren Evaluation mehrere Speichervorgänge erfordert.

Pipes in Parameterwerten verwenden

Ein Parameterwert darf kein Pipe-Zeichen (|) enthalten, weil es sonst als Ende des Parameters und Anfang des nächsten Parameters gesehen wird. Das kannst du umgehen, indem du die Parser-Funktion {{!}} oder die HTML-Entität &124; verwendest. Die beiden Methoden, dies zu tun, verhalten sich leicht unterschiedlich, was in einigen seltenen Fällen relevant sein kann, beispielsweise wenn eine Vorlage die Syntax wikitable erzeugt.

Beispiel: {{T1demo|abc|def}} erzeugt: startabcend

Das „def“ wird nicht angezeigt, weil es als Teil eines anderen unbenannten Parameters behandelt wird, den die Vorlage nicht verwendet.

{{T1demo|abc{{!}}def}} erzeugt: startabc|defend

Das „def“ wird richtig angezeigt.

{{T1demo|abc&#124;def}} erzeugt: startabc|defend

Das „def“ wird wieder richtig angezeigt.

Formatierung von Vorlagenaufrufen mit zusätzlichen Parametern

Da Vorlagen übergebene Parameter ignorieren und nicht speziell verarbeiten, kannst du sie verwenden, um dem Vorlagenaufruf zusätzliche Leerzeichen oder nicht verwendete Inhalte hinzuzufügen.

Zum Beispiel:

{{template name|foo|bar|baz|mumble|quux}}

ist gleichbedeutend mit, vorausgesetzt, die Vorlage erkennt SPACEN nicht als Parametername:

{{template name|SPACE1=
|foo|SPACE2=
|bar|SPACE3=Random stuff
|baz|SPACE4=
   |mumble|SPACE5=
  quux
}}

Es ist auch möglich, für jeden Spacer denselben Namen zu verwenden (oft die leere Zeichenfolge), aber dadurch wird Category:Pages using duplicate arguments in template calls gefüllt, was viele Wikis lieber leer lassen, um Benutzerfehler zu erkennen.

Damit kannst du die Vorlage so rendern lassen, dass sie ähnlich wie ihre Ausgabe aussieht, z. B. indem jede Zeile von w:Template:Chess position einzeln angezeigt wird, sodass der Wikitext auch wie ein Schachbrett aussieht.

Auslastung der Tracking-Parameter verfolgen


Es kann sinnvoll sein, einer Vorlage einen Link oder eine Kategorie zu einer Seite hinzuzufügen, wenn ein bestimmter Parameter oder eine Kombination von Parametern verwendet wird, um möglichst einfach feststellen zu können, welche Seiten einen bestimmten Parameter verwenden und welche Auswirkungen eine Änderung dieses Parameters in der Vorlage hätte.

Evaluationsprozess

Dies ist ein Thema für Fortgeschrittene, das du überspringen kannst, sofern du es nicht benötigst.

Im Allgemeinen werden Vorlagenparameter nach der Tokenisierung in die Vorlage eingesetzt, aber so wie sie sind. Sie werden erst ausgewertet, wenn sie verwendet werden.

Dies hat einige Konsequenzen.

  1. Wenn Sie ein Template:Start haben, das {{mytemplate enthält, und ein Template:End, das |foo=bar}} enthält, und {{start}}{{end}} auf eine Seite setzen, wird mytemplate nicht transkludiert, weil Token wie "|" nicht durch ein Template hinzugefügt werden können und ihre spezielle Bedeutung in Templates behalten. Du kannst weiterhin Vorlagen verwenden, um den Namen eines Parameters oder einer Vorlage zu steuern, aber du kannst einen Vorlagenaufruf nicht auf mehrere Vorlagen aufteilen.
  2. Entfernen von totem Code: Wenn du einen Vorlagenaufruf wie {{foo|{{DISPLAYTITLE:Bar}} }} machst und Template:Foo kein {{{1}}} enthält, wird DISPLAYTITLE nicht verwendet, da es nur bei Bedarf evaluiert wird und es keinen Parameter gibt, in den es ersetzt werden könnte, sodass es nie evaluiert wird. Dies kommt in der Regel bei der Verwendung von Erweiterung:ParserFunctions zum Tragen und kann besonders in Verbindung mit dem Magischen Wort int: auffallen, das je nach Benutzersprache variiert. Das ist nicht perfekt, und in manchen Fällen kann der Prozess der Evaluation sogar dann Template:W haben, wenn das Ergebnis der Erweiterung einer Vorlage nicht verwendet wird (z. B. weil es Teil einer if-Anweisung ist). Zum Beispiel werden alle erzeugten Links oder andere Vorlagen, die verwendet werden, trotzdem zu Special:WhatLinksHere hinzugefügt, auch wenn sie nicht angezeigt werden.

Vorlagenparameter werden als Template:W übergeben, was bedeutet, dass eine Vorlage ihre Argumente nicht ändern kann. Parameter werden wie eine Template:W behandelt, und Parameternamen werden vor den Parameterwerten ausgewertet. Wenn derselbe Parametername mehrmals angegeben wird (entweder mit oder ohne Namen), wird nur die letzte Instanz verwendet und die Seite zu Category:Pages using duplicate arguments in template calls hinzugefügt.

Template-Aufrufe, die mit dem magischen Wort subst: oder safesubst: beginnen, werden in einem separaten ersten Durchgang ausgewertet, der zur Zeitersparnis erfolgt, zusammen mit ~~~~ und Links, die den Pipe-Trick verwenden. Wenn diese beim ersten Durchlauf nicht ausgewertet werden können, werden subst:-Aufrufe ignoriert und safesubst: wie ein normales Template behandelt.

Viele, aber nicht alle Parser-Funktionen, Parser-Tags und transklusierte Sonderseiten werden nicht wie Templates direkt eingebunden, sondern durch einen "Strip-Marker" ersetzt. Das bedeutet, dass Sie die Ergebnisse nicht mit Parser-Funktionen wie padleft: oder ähnlichen Funktionen von Erweiterungen manipulieren können, da diese die Streifenmarkierung anstelle des Ergebnisses der Parser-Funktion sehen.

Rekursion in Vorlagen

Wenn eine Vorlage in sich selbst eingebunden wird, wirft das MediaWiki nicht in eine endlose Rekursion. MediaWiki stoppt die Einbindung, indem der Name der Vorlage in fetter Schrift erscheint. Wenn der Inhalt von Template:Aaaa zum Beispiel a {{Aaaa}} z ist, wird „a a Template loop detected: Template:Aaaa z z“ angezeigt.

Diese Schutzmaßnahme verhindert einen potenziell nützlichen Template-Ausdruck, bei dem ein Template seine eigenen Aufrufargumente selbst normalisiert. In diesem unzulässigen Beispiel kann template:d entweder als {{d|20200311}} oder {{d|y=2020|m=3|d=11}} bezeichnet werden. Bei der ersten Methode erfolgt ein Rückgriff auf die zweite Argumentstruktur (die mit Hilfe der String-Parser-Funktionen ermittelt wird), die dann einem einheitlichen Verarbeitungspfad folgt.

{{#if:{{{1|}}}|{{d|y={{#sub:{{{1}}}|0|4}}|m={{#sub:{{{1}}}|4|2}}|d={{#sub:{{{1}}}|6|2}}}}|<!-- processing path with arguments y,m,d regardless of original call pattern -->}}

Falls template:d modifiziert wird, um nach template:d/2 zu springen und template:d/2 eine „identische manuelle Kopie“ von template:d ist, so funktioniert dieses Verfahren gut, da die Absicherung der automatischen Rekursion dynamisch und nicht statisch funktioniert.

Ein gangbarer Weg für die MediaWiki-Software, die Regel der Selbstrekursion zu lockern, wäre es, zu verlangen, dass jeder rekursive Aufruf eine unterschiedliche Anzahl von Argumenten haben muss, die sich von allen vorherigen aktiven Aufrufen unterscheiden und höchstens einmal rekursiv sein darf, wobei die Anzahl der Argumente nicht abnehmen darf. Das würde eine solide Sicherheit gegen endlose automatische Rekursion bieten und gleichzeitig nützliche Ausdrücke, wie den hier beschriebenen, auf flexible Weise ermöglichen.

Ist der Verarbeitungspfad von geringer Komplexität, kann eine einfache Lösung mit nur einem Template darin bestehen, jeden Aufruf in einer separaten if/else Verzweigung zu verarbeiten und die Logik des Prozesses in jedem Fall zu duplizieren. Wenn der Verarbeitungspfad komplexer ist, kann jeder Fall einer Aufrufstruktur an eine Vorlage zur Implementierung mit einer einheitlichen Aufrufstruktur delegiert werden, die das endgültige Template-Verhalten bereitstellt.

Tabellen in Parametern

Da das Pipe-Zeichen (|) und das Gleichheitszeichen (=) in Template-Aufrufen und Wikitables unterschiedliche Bedeutungen haben, muss man, um Tabellenauszeichnungen im Wert eines Template-Parameters zu verwenden, diese Zeichen in der Regel mit Hilfe spezieller Sequenzen „umgehen“ (d.h. sie vor der Interpretation als Template-Auszeichnungen schützen):

  • das eingebaute magische Wort {{!}} bietet seit MediaWiki 1.24 eine „umgangene“ Version von |
  • das eingebaute magische Wort {{=}} bietet eine „umgangene“ Version von = seit MediaWiki 1.39

Vor der Einführung dieser magischen Worte verwendeten viele Wikis Vorlagen, um das Gleiche zu erreichen. In einem solchen Wiki haben die magischen Wörter Vorrang vor den gleichnamigen Vorlagen.

Beispiel-Tabelle

A B C
A1 B1 C1
A2 B2 C1

Tabellencode:

{| class=wikitable
!A!!B!!C
|-
|A1||B1||C1
|-
|A2||B2||C1
|}

Umgangenen (escaped) Tabellencode:

{{{!}} class{{=}}wikitable
!A!!B!!C
{{!}}-
{{!}}A1{{!}}{{!}}B1{{!}}{{!}}C1
{{!}}-
{{!}}A2{{!}}{{!}}B2{{!}}{{!}}C2
{{!}}}

Beachten, dass die erste linke Klammer ({) als wörtliches Zeichen für die linke Klammer interpretiert wird, da sie unmittelbar vor dem magischen Wort {{!}} steht. Ebenso wird die letzte rechte Klammer (}) als wörtliches Zeichen für eine rechte Klammer interpretiert, da ihr das gleiche magische Wort unmittelbar vorangestellt ist. In einigen Fällen können diese Klammerzeichen jedoch Probleme verursachen, weshalb einige Wikis auch Vorlagen für die Umgehung dieser Zeichen anbieten:

  • der Vorlagenaufruf {{(}} könnte eine "umgangene" Version von { darstellen
  • der Vorlagenaufruf {{)}} könnte eine "umgangene" Version von } darstellen

Einige Wikis gehen sogar noch weiter und bieten andere praktische Vorlagen wie {{(!}} ({|), {{!)}} (|}), {{!!}} (||). In einem solchen Wiki kann der Code in dieser Form etwas vereinfacht werden:

{{(!}} class{{=}}wikitable
!A!!B!!C
{{!}}-
{{!}}A1{{!!}}B1{{!!}}C1
{{!}}-
{{!}}A2{{!!}}B2{{!!}}C2
{{!)}}

Steuern der Vorlageneinbindung

Standardmäßig wird der Inhalt einer Vorlage vollständig angezeigt, sowohl bei direkter Betrachtung, als auch wenn sie in einer anderen Seite inkludiert wird. Die Seite der Vorlage sieht direkt aufgerufen genauso aus, wie die Vorlage ohne Parameter aussehen würde. Wenn die Vorlage Parameter braucht, um richtig zu funktionieren, führt das zu unformatiertem Wikitext oder Fehlern, weil die Parameter fehlen. Zum Beispiel:

  • Wenn ein Parameter keinen Standardwert hat, wird er als Literaltext {{{1}}} angezeigt, was bedeutet, dass die Vorlage einen Parameter benötigt.
  • Wenn ein Parameter einen leeren Standardwert hat (er wird als {{{1|}}} geschrieben), wird nichts angezeigt, was zwar den gewünschten Effekt hat, aber für die Selbstdokumentation nicht so klar ist. Die Verwendung eines nicht leeren Standardwerts wie {{{1|image}}} könnte die Rolle eines Parameters verdeutlichen, insbesondere bei Vorlagen, die Bilder enthalten.
  • Wenn ein Parameter ohne Standardwert an die Parser-Funktion #expr übergeben wird, kommt es zu einer Fehlermeldung: „Expression error: unrecognized punctuation character '{'.“
  • Wenn eine Vorlage eine Tabelle erstellt, ist es hilfreich, wenn die Vorlagenseite die Struktur der Tabelle anzeigt und nicht den Wikitext, mit dem sie erstellt wurde. Dafür wird die Tabellensyntax nicht in Tags eingeschlossen, und jedes Tabellenelement enthält bei Bedarf sowohl ‎<noinclude>...‎</noinclude>- als auch ‎<includeonly>...‎</includeonly>-Teile.

Du kannst aber mit den Tags ‎<noinclude>, ‎<includeonly> und ‎<onlyinclude> festlegen, welche Teile einer Vorlage angezeigt und eingefügt werden.

Alles zwischen ‎<noinclude> und ‎</noinclude> wird nur verarbeitet und angezeigt, wenn die Seite direkt angesehen wird und nicht, wenn sie in einer anderen Seite eingefügt ist. Das ist nützlich, wenn man Text oder Code in einer Vorlage einbinden will, diesen jedoch nicht für alle Seiten übernehmen will, die die Vorlage verwenden, zum Beispiel:

Das Gegenteil ist ‎<includeonly>. Text zwischen ‎<includeonly> und ‎</includeonly> wird nur verarbeitet und angezeigt, wenn die Seite eingefügt wird. Der offensichtliche Anwendungsfall ist das Hinzufügen aller Seiten, die eine vorgegebene Vorlage beinhalten, zu einer Kategorie.

  • Kategorisierung-Seiten, die die Vorlage enthalten. Hinweis: Wenn die Kategorien, die von einer Vorlage angewendet werden, auf diese Weise geändert werden, wird die Kategorisierung der Seiten, die diese Vorlage enthalten, möglicherweise erst einige Zeit später aktualisiert: Dies wird von der Jobwarteschlange erledigt. Um die Neukategorisierung einer bestimmten Seite zu erzwingen, öffne diese Seite zur Bearbeitung und speicher sie ohne Änderungen.
  • Stelle sicher, dass der Code der Vorlage beim Anzeigen der Vorlagenseite selbst nicht ausgeführt wird. Typischerweise liegt dies daran, dass er Parameter erwartet, und seine Ausführung ohne Parameter hat ein unerwünschtes Ergebnis.

Alles außerhalb von ‎<noinclude> und ‎<includeonly> wird normal verarbeitet und angezeigt, d.h. sowohl, wenn die Vorlagenseite direkt angezeigt wird, als auch, wenn die Vorlage in eine andere Seite eingebunden wird. Der Schwerpunkt liegt auf dem, was sich innerhalb dieser beiden Tags befindet.

Alles außerhalb der ‎<onlyinclude>-Tags wird bei der Einbindung verworfen. Sogar Abschnitte, die nur als includeonly gekennzeichnet sind, werden bei der Einbeziehung verworfen, es sei denn, sie sind ebenfalls als onlyinclude gekennzeichnet. Der Fokus liegt nur auf dem, was in diesem Tag steht.

Wenn zum Beispiel eine Seite wie Help:Templates/onlyinclude demo folgenden Wikitext hat:

abc<onlyinclude>def</onlyinclude>ghi<includeonly>jkl</includeonly>

Das Ergebnis der Transkludierung ist def.

Eine Verschachtelung dieser Tags ist ebenfalls möglich.

Die drei Tags für partielle Transklusion ermöglichen alle möglichen Kombinationen dessen, was verarbeitet und gerendert wird. Auch Kommentare spielen eine Rolle. Inklusion-Tags werden bei der Verwendung von {{subst:templatename}} beachtet, aber sie werden bei der Verwendung von {{msgnw:templatename}} nicht beachtet, da dabei der unformatierte Wikitext ohne jegliche Verarbeitung angezeigt wird.

Transklusion von Abschnitten

To transclude different sections of a template on different pages, you can wrap the content in onlyinclude tags and use an if statement on parameters to select which section.

Betrachten Sie "Template:Example" mit diesem Wikitext:

== Section 1 ==
{{#ifeq:{{{1|1}}}|1|
Content of section one.
}}
{{#ifeq:{{{1|2}}}|2|
== Section 2 ==
Content of section two.
}}

Dies wird beide Abschnitte auf der Beispielseite selbst darstellen und es anderen Seiten ermöglichen, den ersten Abschnitt mit {{example|1}} und den zweiten Abschnitt mit {{example|2}} zu überschließen.

Ein anderer Ansatz ist, stattdessen die wörtliche Parameter-Syntax zu verwenden:

{{{section1|
== Section 1 ==
Content of section one.
}}}
{{{section2|
== Section 2 ==
Content of section two.
}}}

Transclude the first section with {{example|section2=}} and the second section with {{example|section1=}}. Wenn keine der beiden Parameter verwendet wird, werden beide Abschnitte angezeigt.

Ein dritter Ansatz ist, Labeled Section Transclusion .

Organisation von Vorlagen

Damit Vorlagen effektiv sein können, müssen Nutzer sie schnell finden können und dazu in der Lage sein, sie zu nutzen.

Um Vorlagen zu finden können Benutzer:

  1. auf Spezialseiten > Alle Seiten klicken.
  2. in der Namensraum:-Liste Vorlage auswählen und auf Anwenden klicken.

Eine einfache Technik ist die Integration eines Beispiels auf der Vorlagenseite. Zum Beispiel:

<noinclude>
== Verwendung ==
Benutzer begrüßen:
{{Thankyou|reason=deine Begründung|signature=deine Signatur}}
</noinclude>

Ein Redakteur kann einfach das Beispiel kopieren und einfügen, um eine ähnliche Seite zu erzeugen. Das Beispiel ist trivial, doch ein funktionstüchtiges Beispiel, das demonstriert, wie Vorlagen verwendet werden können, spart in aufwändigen Umgebungen zu speziellen Themen leichter Zeit.

Während der Bearbeitung einer Seite ist eine Liste aller verwendeten Vorlagen unter dem Bearbeitungsformular in einem ausklappbaren Abschnitt mit dem Titel „Folgende Vorlagen werden auf dieser Seite verwendet:“ (je nach Kontext auch „Folgende Vorlagen werden von dieser Seitenvorschau verwendet:“ oder „Folgende Vorlagen werden in diesem Abschnitt verwendet:“ genannt) verfügbar. Diese Liste enthält einen praktischen Link zur Seite der Vorlage sowie Informationen über ihren Schutzstatus. Umgeleitete Vorlagen werden kursiv dargestellt, wobei das Umleitungsziel als separates Listenelement hinzugefügt wird.

Verlinkung zu einer Vorlage

Eine Vorlagenseite kann wie jede andere Wiki-Seite verlinkt werden. Zum Beispiel wird der Link Template:Navbar mit dem Wikicode [[Template:Navbar]] erzeugt.

In vielen Wikis kann Template:Tl verwendet werden, um einen Link zu einer Vorlage bereitzustellen, die so formatiert ist, dass der Wikicode „double curly-braces” angezeigt wird, der erforderlich ist, um die Vorlage zu transkludieren, ohne den Tranklusionsvorgang tatsächlich durchzuführen. Zum Beispiel kann der Code {{tl|Navbar}} verwendet werden, um den Link {{Navbar }} zu erstellen.

Dieses Konstrukt wird häufig verwendet, wenn auf Vorlagen in der Vorlagendokumentation, auf Hilfeseiten und auf Diskussionsseiten verwiesen wird. Der gleiche Effekt kann mit {{[[Template:Navbar|Navbar]]}} erzielt werden, aber der {{Tl }}-Ansatz erfordert viel weniger Eingaben. In jedem gegebenen Wiki kann die Tl-Vorlage, falls vorhanden, den Text in einem "Code"-Element oder als Monospace-Schrift wiedergeben oder nicht. Wenn nicht (wie in diesem Wiki), kann eine andere ähnlich benannte Vorlage dies tun. Siehe zum Beispiel den Abschnitt "Siehe auch" unserer Template:Tl-Dokumentation.

Vorlagenbenennung

The name of a template is case-sensitive excluding the first character.

You make redirects for alternate capitalizations. For example, if a template is named "AdminAbbr", you can create a redirect named "Adminabbr". This way, the template can be called with either {{AdminAbbr}} or {{adminabbr}}. If an editor prefers a mix of upper and lower case for clarity, they can use functions like lc or uc. For instance, instead of {{CURRENTINTERNETTIME}}, they could use {{ {{uc:CurrentInternetTime}} }}

Because template names are interpreted in the same way to the names of other pages, underscores are replaced with spaces, and any text after a number sign (what would be a anchor in a standard link) is ignored.

An underscore _ can be alternative to a blank space.

Possible uses of templates

Templates can be used for any situation in which one wants two or more pages to contain identical or similar content that is edited together rather than independently. They can be used to:

  • Provide structured elements on many pages, like infoboxes, maintenance templates, navigational boxes, etc.
  • Perform calculations used as a programming tool on various pages, like w:Template:Sum.
  • Build composite pages that display the content of multiple existing pages together, like w:WP:Village pump (all) which includes content from each section of the village pump. The content of these pages can either be shown individually, or together, but the revision history, watchlist, etc. will only pick up changes to the transcluded pages and the raw wikitext of the composite page itself, not implicit changes to the composite page.
  • Share some content between a few related pages. For example, the list at Help:Preferences#Beta features is duplicated at Beta Features#Current Beta Features. While on MediaWiki.org that is built using Extension:LabeledSectionTransclusion instead, it could have been done using a template.
  • Store content referenced multiple times on the same page, so it only has to be written and calculated once. For example w:Template:Cite Monumentenregister/URL is called twice by w:Template:Cite Monumentenregister in two different places, and using another template means the URL pattern only has to be written once in the base template.
  • Use templates as a programming element to generate a loop: if Template:A calls Template:B 10 times with different parameters, then that crudely simulates a for loop. If Template:B calls Template:C 10 times, then you have a nested loop of 100 calls of Template:C. But keep in mind that it is easy to run into the template limits when using templates as advanced programming constructs, and using Scribunto is generally clearer and easier to follow.

Kopie von einem Wiki zu einem anderen

It is possible, if allowed by the wiki configuration to transclude templates from other wikis. This configuration setting is disabled on Wikimedia wikis. Otherwise, you need to manually copy the template and its dependencies from the source wiki to the destination wiki to use it.

Vorlagen erfordern oft CSS oder andere Vorlagen, sodass Benutzer häufig Probleme haben, Vorlagen von einem Wiki in ein anderes zu kopieren. Die folgenden Schritte sollten für die meisten Vorlagen funktionieren.

The steps below should work for most templates.

MediaWiki Code

If you have import rights (specifically importupload) on the new wiki:

  1. Gehe im Urspungs-Wiki/im originalen Wiki auf Special:Export und downloade .xml-Datein mit den gesamten Versionsgeschichten aller notwendigen Vorlagen. Verfahre dazu wie folgt:
    • Gebe den Namen der Vorlage in das große Textfeld ein, z. "Vorlage:Willkommen". Achte besonders auf Großschreibung und Sonderzeichen – wenn der Vorlagenname nicht genau richtig ist, wird der Export möglicherweise trotzdem ausgeführt, aber die .xml-Datei enthält nicht die erwarteten Daten.
    • Wähle das Kästchen "Inklusive Vorlagen".
    • Wähle in dem Kästchen "Nur die aktuelle Version der Seite exportieren".
    • Klicke auf Seiten exportieren.
  2. Gehe im neuen Wiki auf Special:Import und lade dort die .xml-Datei hoch.

Falls man keine Importrechte auf dem neuen Wiki hat:

  1. Gehe zu der Vorlage, die du aus dem ursprünglichen Wiki kopieren möchtest. Gehe zur Bearbeitungsseite und kopiere den gesamten Wikitext.
  2. Gehe im neuen Wiki zu der Seite mit dem gleichen Namen wie die kopierte Vorlage. Klicke auf Erstellen/Bearbeiten und füge den kopierten Wikitext ein. Verlinke in der Bearbeitungszusammenfassung jeder Vorlage zur Zuordnung auf die Originalseite.
  3. Zurück im Original-Wiki im Bearbeitungsfenster, unterhalb des Bearbeitungsfeldes, sehe dir die Liste der Folgende Vorlagen werden auf dieser Seite verwendet: an. Befolge für jede aufgeführte Vorlage diese Anweisungen. Tu dies auch für jede Vorlage, die von einer dieser Vorlagen verwendet wird, und so weiter.

Dadurch wird der gesamte erforderliche Code kopiert, was für einige Vorlagen ausreicht. Beachte, dass nur Seitenelemente, die beim Rendern der Seite ausgewertet werden, exportiert werden, d.h. Unterseiten der Dokumentation werden dabei nicht exportiert. Wenn es nicht funktioniert, suche auch nach roten Links, die unter "In die aktuelle Version dieser Seite übernommene Seiten:" unterhalb des Bearbeitungsfeldes aufgeführt sind. Wenn es welche gibt, wiederhole die obigen Schritte auch für diese und kopiere auch den Code in die Module. If there are any repeat the above steps for these as well and also copy the code in the modules.

Nachdem du die Vorlage und alle verknüpften Vorlagen erfolgreich aus dem anderen Wiki importiert hast, bearbeite sie, um die Anpassungen an dein Wiki anzupassen. Zum Beispiel, um ein Logo zu ändern, überflüssige Kategorien oder rote Links zu entfernen.

Erweiterungen

Eine häufig in Vorlagen verwendete Erweiterung ist ParserFunctions. Besuche die Seite Erweiterung:ParserFunktionen und prüfe, ob eine der dort aufgeführten Funktionen in den von Ihnen kopierten Vorlagen verwendet wird. Wenn ja, musst du die ParserFunctions -Erweiterung installieren. Um es zu installieren, benötigst du Systemadministrator-Zugriff auf den Server deiner MediaWiki-Installation.

Eine weitere Abhängigkeit, die in Vorlagen verwendet werden kann, insbesondere in Wikipedia, ist Lua. $invoke im Vorlagencode zu haben, ist ein gutes Zeichen dafür. Falls es verwendet wird, musst du die Scribunto -Erweiterung installieren, und der Systemadministratorzugriff ist ebenfalls erforderlich. Auf dieser Seite findest du weitere Anweisungen zur Installation und Verwendung der Erweiterung.

CSS und JavaScript-Code

Neben dem MediaWiki-Code verwenden viele Vorlagen CSS und einige verlassen sich auf JavaScript, um vollständig zu funktionieren. Wenn sich die kopierten Vorlagen nicht wie erwartet verhalten, kann dies die Ursache sein. Um das erforderliche CSS und JavaScript in dein Wiki zu kopieren, benötigst du normalerweise Administratorrechte, da du Systemmeldungen im Namensraum "MediaWiki:" bearbeitest.

  1. Achte auf die Verwendung von CSS-Klassen (Text wie class="foobar") im Vorlagentext. Wenn diese Klassen in „MediaWiki:Common.css“ oder „MediaWiki:Monobook.css“ im ursprünglichen Wiki erscheinen, kopiere diese Klassen in „MediaWiki:Common.css“ im neuen Wiki und prüfe, ob die Vorlage jetzt in Ordnung ist.

If those classes appear in MediaWiki:Common.css or MediaWiki:Vector.css on the original wiki, copy those classes to MediaWiki:Common.css on the new wiki and check if the template is now fine.

  1. Wenn die kopierte Vorlage immer noch nicht wie erwartet funktioniert, prüfe, ob sich Code in "MediaWiki:Common.js" oder "MediaWiki:Monobook.js" im Original-Wiki befindet. Wenn dies der Fall ist, kannst du versuchen, es im neuen Wiki nach "MediaWiki:Common.js" zu kopieren. Normalerweise ist es eine gute Idee, nur Code aus vertrauenswürdigen Quellen zu kopieren und zuerst den Code zu durchsuchen, um die relevanten Teile zu identifizieren und auszuwählen. Möglicherweise findest du Kommentare, die als Anhaltspunkte dienen können, um die Funktionalität der einzelnen Teile zu identifizieren.

If so, you can try copying it to MediaWiki:Common.js on the new wiki. Normally, it is a good idea to only copy code from trusted sources, and browse the code to identify and select the relevant parts. You may find comments that can serve as clues to identify the functionality of each part.

Redirection

If a page uses a redirect as a template, the redirect is resolved before processing the template and the target is used instead. This won't work if the target doesn't exist (a broken redirect), or is itself a redirect (a double redirect).

A page that just includes another page as a template might look like a redirect, but there are several differences between them:

  • The header of the result displays the title of the page it came from.
  • No "Redirected from" message is shown.
  • Buttons like edit, watch, talk, history, "what links here," and "last modified" point to the referring page. To access the target page, use a section edit link and navigate from there.
  • Unless includeonly and/or noinclude tags are used, the referring page shares the same categories as the target page.
  • "Double redirects" work when one or both are this type of pseudo-redirect.
Embedding works on pages that support redirects and doesn't work on pages without it.

Parser functions

MediaWiki also supports parser functions, which function similarly to templates but follow slightly different syntax:

  • Parser functions utilize a ":" instead of the initial "|".
  • An edit page does not display parser functions used on that page.
  • There is no "What links here" feature for parser functions to identify the pages where they are utilized.
  • Parser functions templates do not generally accept named parameters, so equal signs generally have no special significance. For example:
{{ #if: not blank | x=abc }} gives x=abc

Siehe auch

Allgemeine Template-Verwendung

Spezielle Konstrukte, die in Vorlagen verwendet werden

Andere einschlägige Informationen