GenWiki:Vorlagen: Unterschied zwischen den Versionen
K (Fix Begriffserklärung => Begriffsklärung) |
|||
(125 dazwischenliegende Versionen von 28 Benutzern werden nicht angezeigt) | |||
Zeile 1: | Zeile 1: | ||
{{Artikel Portal Mitmach-Hilfe}} | |||
==Einleitung== | ==Einleitung== | ||
'''Vorlagen''' (auch Templates genannt) sind eine einfache Möglichkeit, Artikel nach einem vorgegebenen Schema aufzubauen. | '''Vorlagen''' (auch Templates oder Textbausteine genannt) sind eine einfache Möglichkeit, Artikel nach einem vorgegebenen Schema aufzubauen. | ||
== Anwendungsmöglichkeiten == | |||
Wir unterscheiden zwei grundsätzliche Möglichkeiten, Vorlagen einzusetzen. | |||
# als Formular oder Stempel | |||
# als Textbaustein, manchmal auch mit formularähnlichen Funktionen durch Parameter | |||
=== Die Vorlage als Formular === | |||
Als Formular wird die Vorlage wie ein Stempel benutzt, der einmal in den Artikel eingefügt wird. Anschließend kann man die Formularfelder ausfüllen und weiter bearbeiten. Änderungen an der Vorlage wirken sich nicht mehr auf den Artikel aus. | |||
und speichert | Will man z. B. einen neuen Artikel über einen Familiennamen schreiben, erzeugt man einfach einen neuen Artikel und benutzt die [[Vorlage:Familienname]] als Stempel indem man als einzigen Quelltext hineinschreibt: | ||
:'''<nowiki>{{subst:Familienname}}</nowiki>''' | |||
und speichert den Artikel erstmals ab. Hierdurch wird die komplette Vorlagendatei in die neue Seite kopiert und kann anschließend weiterbearbeitet werden. Dieses Verfahren kann man auch bei schon bestehenden Seiten anwenden; in diesem Fall wird die Vorlage dazukopiert. Anschließend kann man den bereits vorher vorhandenen Text sinnvoll in die Formularstruktur einfügen. | |||
=== Dynamische Anwendung einer Vorlage als Textbaustein === | |||
Eine ganze Reihe von Vorlagen werden nicht in einen Artikel „gestempelt“, sondern dynamisch eingebunden. Das hat den Vorteil, dass alle Änderungen in der Vorlage sich auf jeden Artikel auswirken, der die Vorlage benutzt. | |||
;Einsatzmöglichkeit 1 | |||
:Wir möchten eine bestimmte Information in vielen Artikeln positionieren und diese nach Bedarf zentral verändern können. | |||
::Vorlagenbeispiel: [[Vorlage:Begriffsklärung]] | |||
:::Anwendungsbeispiel: [[Haaren]] | |||
;Einsatzmöglichkeit 2 | |||
:Wir möchten eine Navigationsleiste in einem Artikel oder in einer Kategorie einsetzen. Der Quelltext dafür ist manchmal sehr komplex, aber immer gleich. Um sich den Aufwand des immer neu Schreibens zu ersparen, legt man eine Vorlage an und bindet diese dynamisch ein. | |||
::Vorlagenbeispiel 1: [[Vorlage:TOC]] | |||
::: Anwendungsbeispiel 1: [[GenWiki:Index]] | |||
::Vorlagenbeispiel 2: [[Vorlage:KategorieABC-TOC]] | |||
::: Anwendungsbeispiel 2: [[:Kategorie:Familienname|Kategorie:Familienname]] | |||
=== Dynamische Anwendung eines Formulars === | |||
Manche Formulare brauchen nicht als Stempel eingefügt werden, da nicht zu erwarten ist, dass sie sich innerhalb eines Artikels an die weitere Artikelstruktur wesentlich anpassen müssen. Diese Vorlagen erwarten sogenannte Parameterangaben, die unterschiedlich - je nach Vorlage - angegeben werden müssen. | |||
;Einsatzmöglichkeit 1 | |||
:Wir wollen häufig auf eine bestimmte Webpräsenz außerhalb von Genwiki linken. Webpräsenzen haben manchmal die unangenehme Eigenschaft, Ihre URL zu ändern. Über eine Vorlage kann man die URL-Anpassung zentral in der Vorlage nachvollziehen, ohne jeden Artikel aufsuchen zu müssen, der die URL benutzt. | |||
::Vorlagenbeispiel: [[Vorlage:Wikipedia-Link]] | |||
:::Anwendungsbeispiel: [[Deutsche_Zentralstelle_für_Genealogie#Weblinks|Deutsche Zentralstelle für Genealogie, Abschnitt „Weblinks“]] | |||
;Einsatzmöglichkeit 2 | |||
:Wir wollen nur ein oder zwei Variabeln im Textbaustein einsetzen. | |||
::Vorlagenbeispiel: [[Vorlage:Begriffsklärungshinweis]] | |||
:::Anwendungsbeispiel: [[Haaren (Aachen)]] | |||
=== Halbdynamische Anwendung eines Formulars === | |||
Manche Formulare sind in ihrer Struktur schon ziemlich komplex und ihre Anwendung erleichtert nur dann die Artikelarbeit, wenn man sie über eine weitere Vorlage, die die Parameter enthält und als Stempel in den Artikel eingefügt wird, benutzt. | |||
;Einsatzmöglichkeit | |||
:Wir wollen ziemlich viele Variabeln im Textbaustein ermöglichen. | |||
::Vorlagenbeispiel: [[Vorlage:Anschrift Syntax]] | |||
:Diese Vorlage gilt als „technische Vorlage“, die über den Stempel einer weiteren Vorlage in den Artikel benutzt wird. | |||
::Vorlage zur Nutzung der technischen Vorlage: [[Vorlage:Anschrift]] (Einfügen mittels: <nowiki>{{subst:Anschrift}}</nowiki>) | |||
::: Anwendungsbeispiel: [[AOFF]] bzw. im Editiermodus: http://wiki-de.genealogy.net/w/index.php?title=AOFF&action=edit | |||
:::: Im Anwendungsbeispiel kommt die „Vorlage:Anschrift Syntax“ gleich zwei mal zum Einsatz. | |||
== Vorlagen selbst erstellen == | |||
Anlegen einer Vorlage entsprechend [[Hilfe:Neue Seite anlegen]] | |||
Die Vorlagenprogrammierung für einem Wiki ist ausführlich beschrieben im {{Wikipedia-Link|Hilfe:Vorlagen|Hilfe:Vorlagen}} Allerdings verwendet Wikipedia eine neuere Wiki-Software als GenWiki. Deshalb werden hier nicht alle Sprachelemente funktionieren, die dort beschrieben sind. Bis hier eine spezifische Dokumentation für GenWiki verfügbar ist, hilft nur ausprobieren, z. B. in der [[:Vorlage:Sandkasten|Vorlage Sandkasten]]. | |||
Außer in gut begründeten Ausnahmefällen sollen Vorlagen im Namensraum "Vorlage" erstellt werden, das heißt, dass der Artikelname der Vorlage mit '''Vorlage:''' beginnt. | |||
<!-- to do: GenWiki-Spezifika beschreiben --> | |||
=== Stolperfallen und Lösungen === | |||
[[GenWiki:Vorlagen/Tipps und Tricks|Tipps und Tricks]] werden hier gesammelt. | |||
=== Dokumentation von Vorlagen === | |||
Eine Vorlage kann nur so gut sein wie ihre Dokumentation. Undokumentierte Vorlagen werden von den Autoren gemieden. Wer also möchte, dass eine Vorlage von anderen genutzt wird, sollte auch Zeit in die Beschreibung der Vorlage und ihrer Parameter investieren. Siehe dazu '''[[:Vorlage:Dokumentation]]'''. | |||
=== Kategorien === | |||
Damit eine Vorlage von anderen gefunden und genutzt werden kann, sollte sie auch bekannt gemacht werden, zum Beispiel durch Zuweisung in eine oder mehrere [[Hilfe:Kategorie|Kategorien]]. In der [[:Kategorie:Vorlage|Kategorie:Vorlage]] sind Vorlagenkategorien aufgeführt, die in Frage kommen. | |||
== Vorlagen für Themenseiten == | == Vorlagen für Themenseiten == | ||
siehe auch: [[:Kategorie:Vorlage]] | |||
===Thema: Namen=== | ===Thema: Namen=== | ||
#[[Vorlage:Familienname|Vorlage für Familiennamen-Artikel]] <nowiki>{{subst:Familienname}}</nowiki> | |||
#[[Vorlage:Vorname|Vorlage für Vornamen-Artikel]] <nowiki>{{subst:Vorname}}</nowiki> | |||
===Thema: Militär=== | ===Thema: Militär=== | ||
#[[ | #[[Vorlage:Regiment|Vorlage für Regiment]] <nowiki>{{subst:Regiment}}</nowiki> | ||
#[[ | ##[[Vorlage:Regiment_WK1|Vorlage für Regiment im Ersten Weltkrieg]] <nowiki>{{subst:Regiment_WK1}}</nowiki> | ||
#[[ | #[[Vorlage:Division|Vorlage für Division]] <nowiki>{{subst:Division}}</nowiki> | ||
#[[ | #[[Vorlage:Armeekorps|Vorlage für Armeekorps]] <nowiki>{{subst:Armeekorps}}</nowiki> | ||
===Thema: Ortsfamilienbücher=== | ===Thema: Ortsfamilienbücher=== | ||
#[[ | #[[Vorlage:OFB|Vorlage für Ortsfamilienbücher (OFBs)]] <nowiki>{{subst:OFB}}</nowiki> | ||
Über die Seite [[Hilfe:Ortsfamilienbuch - Anlegen eines Artikels über ein OFB]] wird die Vorlage automatisch eingebunden. | |||
===Thema: Adressbuch=== | |||
# [[Vorlage:Adressbuch]] <nowiki>{{subst:Adressbuch}}</nowiki> | |||
:Über die Seite [[Hilfe:Anlegen eines Adressbuchartikels]] - Anlegen eines Artikels über ein Adressbuch wird die Vorlage automatisch eingebunden. | |||
# [[Vorlage:Adressbuch-Ortslink]] <nowiki>{{subst:Adressbuch-Ortslink}}</nowiki> | |||
:Diese Vorlage kann von Ortsartikel oder Buchartikel der DigiBib für einen Ort direkt in die Adressbuch-Datenbank verlinken. | |||
===Thema: Software=== | ===Thema: Software=== | ||
#[[ | #[[Vorlage:Software]] <nowiki>{{subst:Software}}</nowiki> | ||
=== Thema: Berufsbezeichnung === | |||
Diese Vorlage ist ein Textbaustein, der mit <nowiki>{{subst:Berufsbezeichnung}}</nowiki> in einen neuen Artikel hineinkopiert und dann inhaltlich ausgefüllt und ergänzt werden sollte. | |||
#[[Vorlage:Berufsbezeichnung]] | |||
===Thema: Höfe und Bauern=== | |||
#[[Vorlage:Hof]] <nowiki>{{subst:Hof}}</nowiki> | |||
===Thema: Mühlen=== | |||
#[[Vorlage:Mühle]] <nowiki>{{subst:Mühle}}</nowiki> | |||
=== Regionalseiten === | |||
#[[Vorlage:Region|Vorlage für Bundesländer/Regionen]] <nowiki>{{subst:Region}}</nowiki> | |||
#[[Vorlage:Kreis|Vorlage für Landkreise]] <nowiki>{{subst:Kreis}}</nowiki> | |||
#Vorlage für Orte | |||
##[[Vorlage:Ort|Vorlage für Orte in Deutschland]] <nowiki>{{subst:Ort}}</nowiki> | |||
##[[Vorlage:Ort_in_Österreich|Vorlage für Orte in Österreich]] <nowiki>{{subst:Ort_in_Österreich}}</nowiki> | |||
##[[Vorlage:Ort_in_Schweiz|Vorlage für Orte in der Schweiz]] <nowiki>{{subst:Ort_in_Schweiz}}</nowiki> | |||
##[[Vorlage:Ort_in_den_Niederlanden|Vorlage für Orte in den Niederlanden]] <nowiki>{{subst:Ort_in_den_Niederlanden}}</nowiki> | |||
##[[Vorlage:Ort_in_Boehmen|Vorlage für Orte in Böhmen]] <nowiki>{{subst:Ort_in_Boehmen}}</nowiki> | |||
##[[Vorlage:Politischer Bezirk in Boehmen|Vorlage für Politische Bezirke in Böhmen]] <nowiki>{{subst:Politischer Bezirk in Boehmen}}</nowiki> | |||
##[[Vorlage:Gerichtsbezirk in Boehmen|Vorlage für Gerichtsbezirke in Böhmen]] <nowiki>{{subst:Gerichtsbezirk in Boehmen}}</nowiki> | |||
##[[Vorlage:Ort_in_Maehren|Vorlage für Orte in Mähren]] <nowiki>{{subst:Ort_in_Maehren}}</nowiki> | |||
##[[Vorlage:Politischer Bezirk in Maehren|Vorlage für Politische Bezirke in Mähren]] <nowiki>{{subst:Politischer Bezirk in Maehren}}</nowiki> | |||
##[[Vorlage:Gerichtsbezirk in Maehren|Vorlage für Gerichtsbezirke in Mähren]] <nowiki>{{subst:Gerichtsbezirk in Maehren}}</nowiki> | |||
##[[Vorlage:Ort_in_Oesterreich-Schlesien|Vorlage für Orte in Österreich-Schlesien]] <nowiki>{{subst:Ort_in_Oesterreich-Schlesien}}</nowiki> | |||
##[[Vorlage:Politischer Bezirk in Oesterreich-Schlesien|Vorlage für Politische Bezirke in Österreich-Schlesien]] <nowiki>{{subst:Politischer Bezirk in Oesterreich-Schlesien}}</nowiki> | |||
##[[Vorlage:Gerichtsbezirk in Oesterreich-Schlesien|Vorlage für Gerichtsbezirke in Österreich-Schlesien]] <nowiki>{{subst:Gerichtsbezirk in Oesterreich-Schlesien}}</nowiki> | |||
#Regionale Vorlagensammlungen | |||
##[[Vorlage:Gemeinde Bayern]] <nowiki>{{subst:Gemeinde Bayern}}</nowiki> | |||
##[[Vorlagen Regional NRW]] | |||
##[[GenWiki:Vorlagen/Navigation Schweiz|Vorlagen der Schweiz]] | |||
##[[Vorlagen Regional Ostpreußen]] | |||
# [[Vorlage:Landschaft|Vorlage für Landschaft]] <nowiki>{{subst:Landschaft}}</nowiki> | |||
# [[Vorlage:Mühle|Vorlage für Mühlen]] <nowiki>{{subst:Mühle}}</nowiki> | |||
==== Navigationsleisten ==== | |||
Navigationsleisten können dynamisch eingebunden werden mit: <nowiki>{{xxx}}</nowiki> (also ohne "subst:") | |||
#[[Vorlage:Navigationsleiste|Navigationsleiste Städte und Gemeinden im Kreis XXX]] <nowiki>{{Navigationsleiste}}</nowiki> | |||
#Vorlagensammlungen zu Navigationsleisten | |||
##[[GenWiki:Vorlagen/Navigation BWL|Navigationsleisten Baden-Württemberg]] | |||
##[[GenWiki:Vorlagen/Navigation BAY|Navigationsleisten Bayern]] | |||
##[[GenWiki:Vorlagen/Navigation B|Navigationsleisten Berlin]] | |||
##[[GenWiki:Vorlagen/Navigation HH|Navigationsleisten Hamburg]] | |||
##[[GenWiki:Vorlagen/Navigation HE|Navigationsleisten Hessen]] | |||
##[[GenWiki:Vorlagen/Navigation NDS|Navigationsleisten Niedersachsen]] | |||
##Navigationsleisten Nordrhein-Westfalen: siehe: [[Vorlagen Regional NRW]] | |||
##[[GenWiki:Vorlagen/Navigation OPR|Navigationsleisten Ostpreußen]] oder [[:Kategorie:Vorlage Navigationsleiste Ostpreußen|Kat. Navigationsleiste Ostpreußen]] | |||
##[[GenWiki:Vorlagen/Navigation POS|Navigationsleisten Posen]] | |||
##[[GenWiki:Vorlagen/Navigation RP|Navigationsleisten Rheinland-Pfalz]] | |||
##[[GenWiki:Vorlagen/Navigation LSN|Navigationsleisten Sachsen]] | |||
##[[GenWiki:Vorlagen/Navigation LSA|Navigationsleisten Sachsen-Anhalt]] | |||
##[[GenWiki:Vorlagen/Navigation BAY-Kirche|Navigationsleisten kirchlich in Bayern]] | |||
##[[GenWiki:Vorlagen/Navigation_Böhmen|Navigationsleisten Böhmen]] | |||
##[[:Kategorie:Vorlage Navigationsleiste Schlesien|Navigationsleisten Schlesien]] | |||
== Allgemeine Angaben == | |||
# [[Vorlage:Anschrift|Anschrift (Adresse)]] <nowiki>{{Anschrift|...}}</nowiki> | |||
# [[Vorlage:Öffnungszeiten|Öffnungszeiten]] <nowiki>{{Öffnungszeiten Syntax|Montag = ...}}</nowiki> Hier bitte die vorn aufgeführte Vorlage mit subst kopierern und dann die Parameter bitte setzen. | |||
== Archiv == | |||
#[[Vorlage:Archiv|Vorlage mit der Grundstruktur für eine Archivinformation]] <nowiki>{{subst:Archiv}}</nowiki> | |||
== Datenbanken == | |||
# [[Vorlage:Ortsdatenbank|Vorlage für Ortsdatenbank]] | |||
== Textbausteine == | == Textbausteine == | ||
Textbausteine werden eingebunden mit: <nowiki>{{ | Textbausteine werden dynamisch eingebunden mit: <nowiki>{{xxx}}</nowiki> (also ohne "subst:") | ||
#[[Vorlage:Begriffsklärung|Textbaustein für Begriffsklärungen]] <nowiki>{{Begriffsklärung}}</nowiki> | |||
#[[Vorlage:Begriffsklärungshinweis|Textbaustein für Begriffsklärungshinweis]] <nowiki>{{Begriffsklärungshinweis}}</nowiki> | |||
#[[Vorlage:TOC|Textbaustein für eine alphabetische Leiste]] <nowiki>{{TOC}}</nowiki> | |||
#[[Vorlage:KategorieTOC|Textbaustein für eine alphabetische Leiste incl. Zahlen in einer Kategorie]] <nowiki>{{KategorieTOC}}</nowiki> | |||
#[[Vorlage:KategorieABC-TOC|Textbaustein für eine rein alphabetische Leiste in einer Kategorie]] <nowiki>{{KategorieABC-TOC}}</nowiki> | |||
#[[Vorlage:Kategoriehinweis|Textbaustein für einen Hinweis in einer Kategorie]] <nowiki>{{Kategoriehinweis}}</nowiki> | |||
Siehe auch [[:Kategorie:Textbaustein-Vorlage]]. | |||
== Textbausteine mit Parametern == | |||
Die Erklärung zum Einsatz der Parameter befinden sich in den Textbausteinen selbst: | |||
#[[Vorlage:Begriffsklärungshinweis|Textbaustein für einen Begriffsklärungshinweis]] <nowiki>{{Begriffsklärungshinweis|1|2}}</nowiki> | |||
#[[Vorlage:Batchnummer|Textbaustein für Direktlinks zu batchnummerbezogenen Datenerfassungen bei FamilySearch]] <nowiki>{{Batchnummer|1}} oder {{Batchnummer|1|2}}</nowiki> (ohne Beschreibungstext, optional mit Angabe der Region) | |||
#[[Vorlage:Batchnummer1|Textbaustein für Direktlinks zu batchnummerbezogenen Datenerfassungen bei FamilySearch]] <nowiki>{{Batchnummer1|1|2}} oder {{Batchnummer1|1|2|3}}</nowiki> (mit Beschreibungstext, optional mit Angabe der Region) | |||
#[[Vorlage:FS-Film|Textbaustein für Direktlinks zu filmnummerbezogenen Datenerfassungen bei FamilySearch]] <nowiki>{{FS-Film|1}}</nowiki> | |||
#[[Vorlage:LDS-Film|Textbaustein für Direktlinks zu LDS-Filmnummern]] <nowiki>{{LDS-Film|1}}</nowiki> (ohne Beschreibungstext) | |||
#[[Vorlage:LDS-Film1|Textbaustein für Direktlinks zu LDS-Filmnummern]] <nowiki>{{LDS-Film|1|2}}</nowiki> (mit Beschreibungstext) | |||
#[[Vorlage:FOKO|Textbaustein für spezielle Links auf die FOKO-Datenbank]] <nowiki>{{FOKO|1|2}}</nowiki> | |||
#[[Vorlage:Wikipedia-Link|Textbaustein für Links in die deutschsprachige Wikipedia]] <nowiki>{{Wikipedia-Link|1|2}}</nowiki> (mit Beschreibungstext) | |||
#[[Vorlage:Wikipedia-Link-EN|Textbaustein für Links in die ''englisch''sprachige Wikipedia]] <nowiki>{{Wikipedia-Link-EN|1|2}}</nowiki> (mit Beschreibungstext) | |||
#[[Vorlage:Wikipedia-Link-PL|Textbaustein für Links in die ''polnisch''sprachige Wikipedia]] <nowiki>{{Wikipedia-Link-PL|1|2}}</nowiki> (mit Beschreibungstext) | |||
#[[Vorlage:Wikipedia-Link-RU|Textbaustein für Links in die ''russisch''sprachige Wikipedia]] <nowiki>{{Wikipedia-Link-RU|1|2}}</nowiki> (mit Beschreibungstext) | |||
#[[Vorlage:ZDB|Textbaustein für Direktlinks zur Zeitschriftendatenbank]] <nowiki>{{ZDB|1}}</nowiki> | |||
#[[Vorlage:Infobox|Textbaustein zur einheitlichen Gestaltung von Infoboxen am Kopf oder Fuß von Artikeln]] <nowiki>{{Infobox|Infotext}}</nowiki> | |||
#[[Vorlage:Mitmachen|Textbaustein zur einheitlichen Gestaltung von Mitmach-Angeboten]] <nowiki>{{Mitmachen|Infotext}}</nowiki> | |||
#[[Vorlage:BLO-Link|Textbaustein für Direktlinks zu Ortsnamen in der Ortsdatenbank der Bayerischen Landesbibliothek Online]] <nowiki>{{BLO-Link|1|2}}</nowiki> (mit Beschreibungstext) | |||
== Textbausteine für commons == | |||
Unsere Mediendateien (Bilder, PDFs etc.) werden in commons bereitgestellt. Dort stehen folgende Vorlagen (in Commons: Templates) bereit: | |||
#[[:commons-link:Template:CoatOfArms|Textbaustein für Wappenrecht]] <nowiki>{{CoatOfArms}}</nowiki><br/>Bei Wappen, Flaggen und Siegeln sollte bei der Bildbeschreibung dieser Textbaustein mit eingebunden werden. Es sollte ein Parameter eingefügt werden, der die korrekte alphabetische Einsortierung des Wappen in die [[:commons-link:Category:CoatOfArms|Category:CoatOfArms]] erzeugt. Das sieht beispielsweise so aus: <nowiki>{{CoatOfArms|Aachen}}</nowiki>. | |||
#[[:commons-link:Template:Licence Geogen|Textbaustein für den Lizenzhinweis Geogen]] <nowiki>{{Licence Geogen}}</nowiki><br />[[Geogen]] liefert interessante Grafiken für unsere Artikel über Familiennamen. | |||
#[[:commons-link:Template:GFDL|GNU Lizenz für Bilder]] <nowiki>{{GFDL}}</nowiki> | |||
#[[:commons-link:Template:LVA NRW HK|Copyrighthinweis des Landesvermessungsamtes NRW]] <nowiki>{{LVA NRW HK}}</nowiki> | |||
[[Kategorie:Vorlage|!]] | |||
[[Kategorie:GenWiki-Intern|Vorlagen]] | |||
[[Kategorie:Hilfe-GenWiki|Vorlagen]] | |||
== Vorlagen für Literaturangaben == | |||
von häufig zitierter Literatur sind unter diesen Kategorie-Einträgen zu finden: | |||
# [[:Kategorie:Literatur]] | |||
# [[:Kategorie:Vorlage:Literatur]] | |||
# [[:Kategorie:Literatur zu Familiennamen]] | |||
# [[:Kategorie:Literaturdatenbank-Vorlage]]n für die [http://famlit.genealogy.net/ Familienkundliche Literaturdatenbank] oder den [[KVK|Karlsruher Virtueller Katalog]] | |||
== Vorlage für Dokumentation [[GOV]] == | |||
#[[ | # [[:Vorlage:GOV-Objekttyp-Artikel]] <nowiki>{{subst:GOV-Objekttyp-Artikel}}</nowiki> |
Aktuelle Version vom 17. Oktober 2023, 01:09 Uhr
Dieser Artikel gehört zum Portal Mitmach-Hilfe und zum Hilfe-Stichwortverzeichnis. |
Einleitung
Vorlagen (auch Templates oder Textbausteine genannt) sind eine einfache Möglichkeit, Artikel nach einem vorgegebenen Schema aufzubauen.
Anwendungsmöglichkeiten
Wir unterscheiden zwei grundsätzliche Möglichkeiten, Vorlagen einzusetzen.
- als Formular oder Stempel
- als Textbaustein, manchmal auch mit formularähnlichen Funktionen durch Parameter
Die Vorlage als Formular
Als Formular wird die Vorlage wie ein Stempel benutzt, der einmal in den Artikel eingefügt wird. Anschließend kann man die Formularfelder ausfüllen und weiter bearbeiten. Änderungen an der Vorlage wirken sich nicht mehr auf den Artikel aus.
Will man z. B. einen neuen Artikel über einen Familiennamen schreiben, erzeugt man einfach einen neuen Artikel und benutzt die Vorlage:Familienname als Stempel indem man als einzigen Quelltext hineinschreibt:
- {{subst:Familienname}}
und speichert den Artikel erstmals ab. Hierdurch wird die komplette Vorlagendatei in die neue Seite kopiert und kann anschließend weiterbearbeitet werden. Dieses Verfahren kann man auch bei schon bestehenden Seiten anwenden; in diesem Fall wird die Vorlage dazukopiert. Anschließend kann man den bereits vorher vorhandenen Text sinnvoll in die Formularstruktur einfügen.
Dynamische Anwendung einer Vorlage als Textbaustein
Eine ganze Reihe von Vorlagen werden nicht in einen Artikel „gestempelt“, sondern dynamisch eingebunden. Das hat den Vorteil, dass alle Änderungen in der Vorlage sich auf jeden Artikel auswirken, der die Vorlage benutzt.
- Einsatzmöglichkeit 1
- Wir möchten eine bestimmte Information in vielen Artikeln positionieren und diese nach Bedarf zentral verändern können.
- Vorlagenbeispiel: Vorlage:Begriffsklärung
- Anwendungsbeispiel: Haaren
- Vorlagenbeispiel: Vorlage:Begriffsklärung
- Einsatzmöglichkeit 2
- Wir möchten eine Navigationsleiste in einem Artikel oder in einer Kategorie einsetzen. Der Quelltext dafür ist manchmal sehr komplex, aber immer gleich. Um sich den Aufwand des immer neu Schreibens zu ersparen, legt man eine Vorlage an und bindet diese dynamisch ein.
- Vorlagenbeispiel 1: Vorlage:TOC
- Anwendungsbeispiel 1: GenWiki:Index
- Vorlagenbeispiel 2: Vorlage:KategorieABC-TOC
- Anwendungsbeispiel 2: Kategorie:Familienname
- Vorlagenbeispiel 1: Vorlage:TOC
Dynamische Anwendung eines Formulars
Manche Formulare brauchen nicht als Stempel eingefügt werden, da nicht zu erwarten ist, dass sie sich innerhalb eines Artikels an die weitere Artikelstruktur wesentlich anpassen müssen. Diese Vorlagen erwarten sogenannte Parameterangaben, die unterschiedlich - je nach Vorlage - angegeben werden müssen.
- Einsatzmöglichkeit 1
- Wir wollen häufig auf eine bestimmte Webpräsenz außerhalb von Genwiki linken. Webpräsenzen haben manchmal die unangenehme Eigenschaft, Ihre URL zu ändern. Über eine Vorlage kann man die URL-Anpassung zentral in der Vorlage nachvollziehen, ohne jeden Artikel aufsuchen zu müssen, der die URL benutzt.
- Vorlagenbeispiel: Vorlage:Wikipedia-Link
- Anwendungsbeispiel: Deutsche Zentralstelle für Genealogie, Abschnitt „Weblinks“
- Vorlagenbeispiel: Vorlage:Wikipedia-Link
- Einsatzmöglichkeit 2
- Wir wollen nur ein oder zwei Variabeln im Textbaustein einsetzen.
- Vorlagenbeispiel: Vorlage:Begriffsklärungshinweis
- Anwendungsbeispiel: Haaren (Aachen)
- Vorlagenbeispiel: Vorlage:Begriffsklärungshinweis
Halbdynamische Anwendung eines Formulars
Manche Formulare sind in ihrer Struktur schon ziemlich komplex und ihre Anwendung erleichtert nur dann die Artikelarbeit, wenn man sie über eine weitere Vorlage, die die Parameter enthält und als Stempel in den Artikel eingefügt wird, benutzt.
- Einsatzmöglichkeit
- Wir wollen ziemlich viele Variabeln im Textbaustein ermöglichen.
- Vorlagenbeispiel: Vorlage:Anschrift Syntax
- Diese Vorlage gilt als „technische Vorlage“, die über den Stempel einer weiteren Vorlage in den Artikel benutzt wird.
- Vorlage zur Nutzung der technischen Vorlage: Vorlage:Anschrift (Einfügen mittels: {{subst:Anschrift}})
- Anwendungsbeispiel: AOFF bzw. im Editiermodus: http://wiki-de.genealogy.net/w/index.php?title=AOFF&action=edit
- Im Anwendungsbeispiel kommt die „Vorlage:Anschrift Syntax“ gleich zwei mal zum Einsatz.
- Anwendungsbeispiel: AOFF bzw. im Editiermodus: http://wiki-de.genealogy.net/w/index.php?title=AOFF&action=edit
- Vorlage zur Nutzung der technischen Vorlage: Vorlage:Anschrift (Einfügen mittels: {{subst:Anschrift}})
Vorlagen selbst erstellen
Anlegen einer Vorlage entsprechend Hilfe:Neue Seite anlegen
Die Vorlagenprogrammierung für einem Wiki ist ausführlich beschrieben im Artikel Hilfe:Vorlagen. In: Wikipedia, Die freie Enzyklopädie. Allerdings verwendet Wikipedia eine neuere Wiki-Software als GenWiki. Deshalb werden hier nicht alle Sprachelemente funktionieren, die dort beschrieben sind. Bis hier eine spezifische Dokumentation für GenWiki verfügbar ist, hilft nur ausprobieren, z. B. in der Vorlage Sandkasten.
Außer in gut begründeten Ausnahmefällen sollen Vorlagen im Namensraum "Vorlage" erstellt werden, das heißt, dass der Artikelname der Vorlage mit Vorlage: beginnt.
Stolperfallen und Lösungen
Tipps und Tricks werden hier gesammelt.
Dokumentation von Vorlagen
Eine Vorlage kann nur so gut sein wie ihre Dokumentation. Undokumentierte Vorlagen werden von den Autoren gemieden. Wer also möchte, dass eine Vorlage von anderen genutzt wird, sollte auch Zeit in die Beschreibung der Vorlage und ihrer Parameter investieren. Siehe dazu Vorlage:Dokumentation.
Kategorien
Damit eine Vorlage von anderen gefunden und genutzt werden kann, sollte sie auch bekannt gemacht werden, zum Beispiel durch Zuweisung in eine oder mehrere Kategorien. In der Kategorie:Vorlage sind Vorlagenkategorien aufgeführt, die in Frage kommen.
Vorlagen für Themenseiten
siehe auch: Kategorie:Vorlage
Thema: Namen
- Vorlage für Familiennamen-Artikel {{subst:Familienname}}
- Vorlage für Vornamen-Artikel {{subst:Vorname}}
Thema: Militär
- Vorlage für Regiment {{subst:Regiment}}
- Vorlage für Regiment im Ersten Weltkrieg {{subst:Regiment_WK1}}
- Vorlage für Division {{subst:Division}}
- Vorlage für Armeekorps {{subst:Armeekorps}}
Thema: Ortsfamilienbücher
- Vorlage für Ortsfamilienbücher (OFBs) {{subst:OFB}}
Über die Seite Hilfe:Ortsfamilienbuch - Anlegen eines Artikels über ein OFB wird die Vorlage automatisch eingebunden.
Thema: Adressbuch
- Vorlage:Adressbuch {{subst:Adressbuch}}
- Über die Seite Hilfe:Anlegen eines Adressbuchartikels - Anlegen eines Artikels über ein Adressbuch wird die Vorlage automatisch eingebunden.
- Vorlage:Adressbuch-Ortslink {{subst:Adressbuch-Ortslink}}
- Diese Vorlage kann von Ortsartikel oder Buchartikel der DigiBib für einen Ort direkt in die Adressbuch-Datenbank verlinken.
Thema: Software
- Vorlage:Software {{subst:Software}}
Thema: Berufsbezeichnung
Diese Vorlage ist ein Textbaustein, der mit {{subst:Berufsbezeichnung}} in einen neuen Artikel hineinkopiert und dann inhaltlich ausgefüllt und ergänzt werden sollte.
Thema: Höfe und Bauern
- Vorlage:Hof {{subst:Hof}}
Thema: Mühlen
- Vorlage:Mühle {{subst:Mühle}}
Regionalseiten
- Vorlage für Bundesländer/Regionen {{subst:Region}}
- Vorlage für Landkreise {{subst:Kreis}}
- Vorlage für Orte
- Vorlage für Orte in Deutschland {{subst:Ort}}
- Vorlage für Orte in Österreich {{subst:Ort_in_Österreich}}
- Vorlage für Orte in der Schweiz {{subst:Ort_in_Schweiz}}
- Vorlage für Orte in den Niederlanden {{subst:Ort_in_den_Niederlanden}}
- Vorlage für Orte in Böhmen {{subst:Ort_in_Boehmen}}
- Vorlage für Politische Bezirke in Böhmen {{subst:Politischer Bezirk in Boehmen}}
- Vorlage für Gerichtsbezirke in Böhmen {{subst:Gerichtsbezirk in Boehmen}}
- Vorlage für Orte in Mähren {{subst:Ort_in_Maehren}}
- Vorlage für Politische Bezirke in Mähren {{subst:Politischer Bezirk in Maehren}}
- Vorlage für Gerichtsbezirke in Mähren {{subst:Gerichtsbezirk in Maehren}}
- Vorlage für Orte in Österreich-Schlesien {{subst:Ort_in_Oesterreich-Schlesien}}
- Vorlage für Politische Bezirke in Österreich-Schlesien {{subst:Politischer Bezirk in Oesterreich-Schlesien}}
- Vorlage für Gerichtsbezirke in Österreich-Schlesien {{subst:Gerichtsbezirk in Oesterreich-Schlesien}}
- Regionale Vorlagensammlungen
- Vorlage:Gemeinde Bayern {{subst:Gemeinde Bayern}}
- Vorlagen Regional NRW
- Vorlagen der Schweiz
- Vorlagen Regional Ostpreußen
- Vorlage für Landschaft {{subst:Landschaft}}
- Vorlage für Mühlen {{subst:Mühle}}
Navigationsleisten können dynamisch eingebunden werden mit: {{xxx}} (also ohne "subst:")
- Navigationsleiste Städte und Gemeinden im Kreis XXX {{Navigationsleiste}}
- Vorlagensammlungen zu Navigationsleisten
- Navigationsleisten Baden-Württemberg
- Navigationsleisten Bayern
- Navigationsleisten Berlin
- Navigationsleisten Hamburg
- Navigationsleisten Hessen
- Navigationsleisten Niedersachsen
- Navigationsleisten Nordrhein-Westfalen: siehe: Vorlagen Regional NRW
- Navigationsleisten Ostpreußen oder Kat. Navigationsleiste Ostpreußen
- Navigationsleisten Posen
- Navigationsleisten Rheinland-Pfalz
- Navigationsleisten Sachsen
- Navigationsleisten Sachsen-Anhalt
- Navigationsleisten kirchlich in Bayern
- Navigationsleisten Böhmen
- Navigationsleisten Schlesien
Allgemeine Angaben
- Anschrift (Adresse) {{Anschrift|...}}
- Öffnungszeiten {{Öffnungszeiten Syntax|Montag = ...}} Hier bitte die vorn aufgeführte Vorlage mit subst kopierern und dann die Parameter bitte setzen.
Archiv
- Vorlage mit der Grundstruktur für eine Archivinformation {{subst:Archiv}}
Datenbanken
Textbausteine
Textbausteine werden dynamisch eingebunden mit: {{xxx}} (also ohne "subst:")
- Textbaustein für Begriffsklärungen {{Begriffsklärung}}
- Textbaustein für Begriffsklärungshinweis {{Begriffsklärungshinweis}}
- Textbaustein für eine alphabetische Leiste {{TOC}}
- Textbaustein für eine alphabetische Leiste incl. Zahlen in einer Kategorie {{KategorieTOC}}
- Textbaustein für eine rein alphabetische Leiste in einer Kategorie {{KategorieABC-TOC}}
- Textbaustein für einen Hinweis in einer Kategorie {{Kategoriehinweis}}
Siehe auch Kategorie:Textbaustein-Vorlage.
Textbausteine mit Parametern
Die Erklärung zum Einsatz der Parameter befinden sich in den Textbausteinen selbst:
- Textbaustein für einen Begriffsklärungshinweis {{Begriffsklärungshinweis|1|2}}
- Textbaustein für Direktlinks zu batchnummerbezogenen Datenerfassungen bei FamilySearch {{Batchnummer|1}} oder {{Batchnummer|1|2}} (ohne Beschreibungstext, optional mit Angabe der Region)
- Textbaustein für Direktlinks zu batchnummerbezogenen Datenerfassungen bei FamilySearch {{Batchnummer1|1|2}} oder {{Batchnummer1|1|2|3}} (mit Beschreibungstext, optional mit Angabe der Region)
- Textbaustein für Direktlinks zu filmnummerbezogenen Datenerfassungen bei FamilySearch {{FS-Film|1}}
- Textbaustein für Direktlinks zu LDS-Filmnummern {{LDS-Film|1}} (ohne Beschreibungstext)
- Textbaustein für Direktlinks zu LDS-Filmnummern {{LDS-Film|1|2}} (mit Beschreibungstext)
- Textbaustein für spezielle Links auf die FOKO-Datenbank {{FOKO|1|2}}
- Textbaustein für Links in die deutschsprachige Wikipedia {{Wikipedia-Link|1|2}} (mit Beschreibungstext)
- Textbaustein für Links in die englischsprachige Wikipedia {{Wikipedia-Link-EN|1|2}} (mit Beschreibungstext)
- Textbaustein für Links in die polnischsprachige Wikipedia {{Wikipedia-Link-PL|1|2}} (mit Beschreibungstext)
- Textbaustein für Links in die russischsprachige Wikipedia {{Wikipedia-Link-RU|1|2}} (mit Beschreibungstext)
- Textbaustein für Direktlinks zur Zeitschriftendatenbank {{ZDB|1}}
- Textbaustein zur einheitlichen Gestaltung von Infoboxen am Kopf oder Fuß von Artikeln {{Infobox|Infotext}}
- Textbaustein zur einheitlichen Gestaltung von Mitmach-Angeboten {{Mitmachen|Infotext}}
- Textbaustein für Direktlinks zu Ortsnamen in der Ortsdatenbank der Bayerischen Landesbibliothek Online {{BLO-Link|1|2}} (mit Beschreibungstext)
Textbausteine für commons
Unsere Mediendateien (Bilder, PDFs etc.) werden in commons bereitgestellt. Dort stehen folgende Vorlagen (in Commons: Templates) bereit:
- Textbaustein für Wappenrecht {{CoatOfArms}}
Bei Wappen, Flaggen und Siegeln sollte bei der Bildbeschreibung dieser Textbaustein mit eingebunden werden. Es sollte ein Parameter eingefügt werden, der die korrekte alphabetische Einsortierung des Wappen in die Category:CoatOfArms erzeugt. Das sieht beispielsweise so aus: {{CoatOfArms|Aachen}}. - Textbaustein für den Lizenzhinweis Geogen {{Licence Geogen}}
Geogen liefert interessante Grafiken für unsere Artikel über Familiennamen. - GNU Lizenz für Bilder {{GFDL}}
- Copyrighthinweis des Landesvermessungsamtes NRW {{LVA NRW HK}}
Vorlagen für Literaturangaben
von häufig zitierter Literatur sind unter diesen Kategorie-Einträgen zu finden:
- Kategorie:Literatur
- Kategorie:Vorlage:Literatur
- Kategorie:Literatur zu Familiennamen
- Kategorie:Literaturdatenbank-Vorlagen für die Familienkundliche Literaturdatenbank oder den Karlsruher Virtueller Katalog
Vorlage für Dokumentation GOV
- Vorlage:GOV-Objekttyp-Artikel {{subst:GOV-Objekttyp-Artikel}}