Help:De:Erstellen einer Vorlage
Haftungsausschluss: Dies ist eine inoffizielle Übersetzung. Die englischsprachigen Versionen sind die offiziellen Hilfeseiten.
Übersetzt: D. Lewerenz, Geprüft: I. Caruso, 20 Dez 2021
Diese Anweisungen sind für Mitglieder des Vorlagenprojekts bestimmt. Siehe zuerst Leitlinien für Vorlagen.
Vorlagen sind eine sehr nützliche Funktion von Wikis. Sie ermöglichen es Dir, Inhalte, die auf vielen Seiten gleich sind, einfach auf jeder Seite einzufügen, ohne sie komplett zu kopieren.
Zum Beispiel wird Template:Mayflower Passenger auf allen Profilen von Mayflower-Passagieren verwendet. Sie zeigt ein Bild der Mayflower und führt den Leser zum Mayflower-Projekt. All dies kann auf einem Profil nur mit dem Text {{Mayflower Passenger}} angezeigt werden.
Vorsicht: Experimentiere nicht mit vorhandenen Vorlagen. Alle an einer Vorlage vorgenommenen Änderungen erscheinen auf allen Seiten, die diese aufrufen, so dass Deine Änderung möglicherweise Hunderte von Profilen betrifft.
Du musst ein Mitglied des Templates Project sein, um Vorlagen erstellen und bearbeiten zu können.
Contents |
Erstellen einer einfachen Vorlage
Eine einfache Vorlage, die überall, wo sie verwendet wird, genau dasselbe anzeigt, ist sehr einfach zu erstellen.
- Öffne die Vorlagenseite. Dies wird https://www.wikitree.com/wiki/Template: sein, gefolgt vom Namen Deiner Vorlage (z.B. https://www.wikitree.com/wiki/Template:Mayflower_Passenger).
- Klicke auf den Link [edit] (Bearbeiten) in der oberen rechten Ecke.
- Gib ein, was überall erscheinen soll, wo du die Vorlage verwendest. Dies kann Wiki-Markup und/oder HTML enthalten.
- Speichere die Seite.
Wo immer Du nun den Namen Deiner Vorlage in doppelte geschweifte Klammern setzt (z.B. {{Mayflower Passenger}}), wird alles erscheinen, was Du in die Vorlage schreibst.
Erstellen einer Vorlage mit Variablen
Einige Vorlagen sind komplizierter; sie haben ein gemeinsames Erscheinungsbild, unterscheiden sich aber aufgrund von Besonderheiten, die beim Aufruf der Vorlage eingegeben werden. Ein Beispiel ist Template:Migrating Ancestor. Sie sieht immer mehr oder weniger gleich aus, aber die Ortsnamen und Flaggenbilder ändern sich, je nachdem, was zum Profil passt. Diese Vorlage wird in einem Profil mit einem Code wie diesem verwendet:
- {{Migrating Ancestor
- | origin = France
- | destination = Canada
- | origin-flag = Flags.png
- | destination-flag = Flags-1.png
- }}
Das Erstellen von Vorlagen mit Variablen ist ähnlich wie das Erstellen einer einfachen Vorlage. Der einzige Unterschied besteht darin, dass Du überall dort, wo Du eine Variable haben willst, den Namen der Variable in dreifache geschweifte Klammern setzt. In der Vorlage Migrating Ancestor wird beispielsweise {{{origin}}} an die Stelle gesetzt, an der der Ursprung genannt wird. Sie dient als Platzhalter für alles, was nach origin= kommt, wenn die Vorlage aufgerufen wird.
WikiTree-Variablen in Vorlagen
Die folgenden Variablen für WikiTree-Datenbankfelder können in eine Vorlage aufgenommen werden:
- Prefix: {{#profile:Prefix}}
- Preferred First Name: {{#profile:RealName}}
- MiddleInitial: {{#profile:MiddleInitial}}
- Last Name at Birth: {{#profile:LastNameAtBirth}}
- Current Last Name: {{#profile:LastNameCurrent}}
- Suffix: {{#profile:Suffix}}
- BirthDateDecade: {{#profile:BirthDateDecade}}
- DeathDateDecade: {{#profile:DeathDateDecade}}
So kannst Du z.B. sagen: "Joe spricht Französisch" statt "Dieser Benutzer spricht Französisch".
Wenn Du einen vollständigen Namen haben möchtest, kannst Du Template:Name, d.h. {{Name}} als Vorlage innerhalb einer Vorlage verwenden (siehe unten.) Es kombiniert die folgenden Namensfelder in einem String. Es gibt eine Bedingung, so dass der Geburtsname nur erscheint, wenn er sich vom aktuellen Nachnamen unterscheidet.
- {{#profile:RealName}} ({{#profile:LastNameAtBirth}}) {{#profile:LastNameCurrent}} {{#profile:Suffix}}
Verwendung einer Vorlage innerhalb einer Vorlage
An dieser Stelle kann es etwas kompliziert werden. Innerhalb einer Vorlage kann eine andere Vorlage aufgerufen werden. Alle Projektboxen sind Beispiele dafür. Sie alle rufen die Template:Project Box auf. Der Grund dafür ist, dass die Projektboxen alle ähnlich sind. Wenn wir also das Aussehen einer von ihnen ändern, sollen sich alle ändern. Das wird dadurch ermöglicht, dass sie alle auf einer gemeinsamen Vorlage aufbauen, die, wenn sie geändert wird, alle ändern würde.
Eine Anleitung zum Erstellen einer neuen Projektbox findest Du unter Template:Project Box.
Bilder für Vorlagen
Bilder, die in Vorlagen verwendet werden, werden normalerweise auf eine Projektseite hochgeladen, wenn die Vorlage für ein bestimmtes Projekt erstellt wird oder auf eine Seite für eine Sammlung von zusammengehörenden Bildern (z.B. Flaggen). Bilder, die für die Verwendung in Vorlagen bestimmt sind und nicht an eine andere Stelle gehören, können in Space:Template Image hochgeladen werden.
Einführung in das Erstellen von Vorlagen
Ich verwende eine persönliche, sogenannte "Sandkasten"-Vorlage, um eine Vorlagenidee zu testen, bevor ich die endgültige Vorlage erstelle. Wähle einen eindeutigen Namen, der deutlich macht, dass es sich um Deinen Sandkasten handelt. Ich habe RolandDev für meinen gewählt. Für den Rest der Einführung werde ich HelloWorld verwenden, aber Du solltest diesen Namen durch den Namen Deines persönlichen Sandkastens zur Vorlagenentwicklung ersetzen.
Hello, World!
- Erstelle Deine Vorlagenseite. Gib in die Adressleiste deines Browsers www.wikitree.com/wiki/Template:NameVonDeinerSandboxHierEinfügen ein. Wenn Du die Eingabetaste drückst, solltest Du auf eine Seite gelangen, die mit "There is currently no text in this page..." (Es gibt derzeit keinen Text auf der Seite) beginnt. (Wenn Du etwas anderes siehst, hast Du vielleicht einen Namen gewählt, der bereits verwendet wird, versuche es mit einem anderen Namen). Klicke auf den Bearbeitungs-Link, um mit der Bearbeitung deiner Vorlage zu beginnen.
- Gib in das Eingabefeld "Hello, World!" (ohne die Anführungszeichen) ein. Speichere die Seite.
- In einer Wiki-Seite, wie z.B. Deinem Profil oder einer Space:-Seite, die Du vielleicht zum Testen von Wiki-Sachen verwendest, probiere die Vorlage aus, indem Du ihren Namen in ein Paar doppelter geschweifter Klammern einschließt.
Auf der Bearbeitungsseite:
- {{HelloWorld}}
Ergebnis:
Hello, World!
- Herzlichen Glückwunsch, Du hast Deine erste Vorlage geschrieben!
Genauer sein
Die Möglichkeit, bei der Verwendung einer Vorlage zusätzliche Informationen anzugeben, macht sie so leistungsfähig. Solche zusätzlichen Informationen werden bei der Verwendung einer Vorlage angegeben, indem nach dem Vorlagennamen ein senkrechter Strich "|" eingefügt wird, gefolgt von der Information, die normalerweise als Argument oder Parameter bezeichnet wird.
- Ändere Deine Vorlage so, dass sie Parameter akzeptiert. Bearbeite Deine Vorlagenseite und ändere "World" in "{{{1}}}". Die dreifachen geschweiften Klammern geben an, wo der Parameter eingefügt werden soll, und die 1 gibt an, dass der erste Parameter dorthin gehört. Ändere auch die Seite, auf der Du die Vorlage verwendest, und füge |Bob nach dem Vorlagennamen, aber innerhalb der doppelten geschweiften Klammern ein.
Vorlagenquelle:
- Hello, {{{1}}}!
Vorlagenverwendung:
- {{HelloWorld|Bob}}
Ergebnis:
Hello, Bob!
- Was passiert, wenn Du einen Parameter nicht angibst? Versuche, den Parameter dort zu entfernen, wo Du die Vorlage verwendest.
Vorlagenverwendung:
- {{HelloWorld}}
Ergebnis:
Hello, {{{1}}}!
Dies ist wahrscheinlich keine Vorlage, die wir ohne Angabe eines Parameters verwenden möchten. In diesem Fall ist dies ein erforderlicher Parameter. Wir können einen Parameter optional machen, indem wir einen Standardwert angeben.
- Bearbeite die Vorlagenquelle, um "World" als Standard hinzuzufügen, wenn ein Parameter nicht angegeben wird.
Vorlagenquelle:
- Hello, {{{1|World}}}!
Vorlagenverwendung:
- {{HelloWorld}}
- {{HelloWorld|Bob}}
Ergebnis:
Hello, World!
Hello, Bob!
Kontrollieren, WAS erscheint
Wenn Seite A als Vorlage (d.h. mit geschweiften Klammern {{ }}) von Seite B aufgerufen wird, zeigt das System den Inhalt von Seite A an der Stelle auf Seite B an, an der der Aufruf erfolgt - dies ist eine Form der Einbindung, bekannt als Transklusion (die andere Form der Einbindung ist Substitution). Standardmäßig wird der gesamte Inhalt von Seite A einbezogen, dies ist jedoch nur selten erwünscht. Um zu kontrollieren, welcher Teil von Seite A auf Seite B erscheint, kannst Du 'inclusion tags' (Einbindungs-Tags) auf Seite A verwenden, um den Inhalt zu markieren, der eingeschlossen werden soll.
Es sind drei Einbindungs-Tags verfügbar:
- <onlyinclude> was bedeutet, diesen Inhalt auf dieser Seite anzuzeigen und NUR diesen Inhalt auf anderen Seiten anzuzeigen.
- <includeonly> was bedeutet, dass dieser Inhalt auf anderen Seiten angezeigt wird, aber NICHT auf dieser Seite.
- <noinclude> was bedeutet, dass dieser Inhalt auf dieser Seite angezeigt wird, aber NICHT auf anderen Seiten.
Zu beachten ist die Aussage, dass <onlyinclude> der Seite mitteilt, NUR diesen markierten Inhalt anzuzeigen, ein wichtiger Unterschied zwischen diesem Tag und dem <includeonly>-Tag. Mit dem <includeonly>-Tag wird jeder Inhalt außerhalb des Tags ebenfalls eingeschlossen, es sei denn, er ist mit <noinclude> markiert - darauf muss geachtet werden, da dies unbeabsichtigte Leerzeichen und Zeilenumbrüche in den angezeigten Inhalt einführen kann.
Während die Verwendung von <onlyinclude> einfacher sein kann, weil es keine separate Markierung von Inhalten mit <noinclude> erfordert und sicherstellt, dass alles außerhalb der Tags nicht eingeschlossen wird, werden alle dynamischen Inhalte (d. h. alles, was auf Parametern basiert) leer oder mit Standardtext angezeigt, was nicht darstellt, wie der eingeschlossene Inhalt bei der Verwendung erscheinen soll, und daher verwirrend sein kann. Es ist daher in der Regel ratsam, die Tags <includeonly> und <noinclude> zu verwenden.
This page was last modified 15:14, 30 March 2022. This page has been accessed 108 times.