Vorlage:Quelle-Link/Doku

Zweck

Die Vorlagen Quelle-Link und Quelle-Beleg steuern, wie man von einer Textstelle in einem Kapitel direkt zum entsprechenden Beleg in einem kapitelübergreifenden Quellenverzeichnis (einem gemeinsamen Verzeichnis für das gesamte Buch) gelangen kann.

Verfahren

Dazu gehören mehrere Schritte; sie werden kurz für einen einzelnen Nachweis beschrieben und müssen grundsätzlich für jede Quelle wiederholt werden.

• Im fortlaufenden Text eines Kapitels wird mit Vorlage:Quelle-Link auf eine bestimmte Quelle hingewiesen. Jede Quelle erhält ein Kürzel (Name des Links) und erzeugt einen Link auf das zentrale Quellenverzeichnis. Die Formulierung kann ziemlich frei gewählt werden, sie hängt von der Art der Quelle und der Stelle im Kapitel ab.
• Im Quellenverzeichnis gibt es den Eintrag zu dieser Quelle. Dazu wird mit der Vorlage:Quelle-Beleg ein „Anker“ erzeugt. Der Name des Ankers muss mit dem Namen des Links vollständig übereinstimmen; dorthin verweist der Link. Außerdem steht hier die eigentliche Quellenangabe.
• Die Namen der Links/Anker müssen eindeutig sein. (Selbstverständlich kann von vielen Stellen aus, auch innerhalb desselben Kapitels, auf ein und denselben Eintrag verwiesen werden.)

Die folgenden Kopiervorlagen enthalten alle auftretenden Parameter. Grundsätzlich ist immer ein Paar dieser Vorlagen zu verwenden – {{Quelle-Link}} gehört in das Kapitel und {{Quelle-Beleg}} in das Verzeichnis.

{{Quelle-Link
 |name=
 |typ=0
 |ziel=
 |text=
}}

{{Quelle-Beleg
 |name=
 |typ=0
 |text=
}}

Wenn für eine bestimmte Quelle ein Eintrag {{Quelle-Beleg}} bereits vorhanden ist, darf für einen weiteren Link kein neuer (weiterer, doppelter) Eintrag notiert werden.

Parameter

Der Parameter name muss angegeben werden. Die anderen Parameter sind optional, aber aus praktischen Gründen oft notwendig.

Der Parameter 1 / "name"

Der Parameter kann wahlweise mit name= oder 1= oder als erster Parameter ohne Namen angegeben werden.

Dieser Wert kennzeichnet eindeutig eine bestimmte Quelle. Innerhalb eines Buches (genauer: eines Quellenverzeichnisses) darf jeder Wert nur einmal vorkommen; darauf müssen die Autoren des Buches achten.

Zu jedem Eintrag {{Quelle-Link}} mit einem bestimmten Namen in einem Kapitel muss es mit demselben Namen in exakt gleicher Schreibweise einen Eintrag {{Quelle-Beleg}} im Quellenverzeichnis geben. Umgekehrt darf es zu einem Eintrag {{Quelle-Beleg}} im Quellenverzeichnis beliebig viele Einträge {{Quelle-Link}} in beliebig vielen Kapiteln geben.

Für den Wert dürfen mit wenigen Ausnahmen sämtliche Zeichen verwendet werden. Folgende Sonderzeichen erfordern besondere Maßnahmen:

• Statt | ist | zu schreiben.
• Statt " ist " zu schreiben.
• Wenn = im Wert enthalten ist, muss der Parameter mit Namen name= oder 1= verwendet werden.

Auf Sonderzeichen (vor allem Klammern) sollte verzichtet werden, um die Darstellung im Buchtext nicht zu verwirren. Fortlaufende Nummern sind zulässig, aber davon ist eindringlich abzuraten, weil jede Änderung in der Reihenfolge sämtliche bisherigen Einträge „zerstören“ würde.

Bei mehreren Autoren sind sehr oft Kurzfassungen sinnvoll. Beispiele für zulässige und sinnvolle Namen: Franke, B. – Krüger u. a. 2012 – ECMA-334 – Ditzen, R. "Fallada"

Der Parameter "typ"

Der Parameter typ steuert die Anzeige des Links im fortlaufenden Text. Folgende Werte sind zz. vorgesehen:

• 0 – Der Name wird direkt als Text für den Link angezeigt. – Diese Variante ist bei zusätzlichen Angaben wie einer Seitenzahl sinnvoll.
• 1 – Der Name wird in runden Klammern als Text für den Link angezeigt: (Name) – Diese Variante ist sinnvoll, wenn im Text keine weiteren Informationen stehen.
• 2 – Der Name wird in eckigen Klammern als Text für den Link angezeigt: [Name] – Diese Variante ist sinnvoll, wenn als Name spezielle Kürzel wie ECMA-334 verwendet werden.

Wenn für diesen Parameter nichts angegeben wird, dann gilt:

• Im Kapitel mit {{Quelle-Link}} gilt der Standardwert 0.
• Im Verzeichnis mit {{Quelle-Beleg}} wird der Name nicht angezeigt. Das ist immer dann sinnvoll, wenn die eigentliche Quellenangabe mit dem Namen oder einer entsprechenden Angabe beginnt, sodass Verwechslungen ausgeschlossen sind.

Der Parameter "ziel"

Diesen Parameter gibt es nur in Vorlage:Quelle-Link. Er enthält die Seite (Kapitel) des Quellenverzeichnisses, also diejenige mit den Einträgen {{Quelle-Beleg}}. Diese Angabe ist grundsätzlich notwendig und kann nur in folgender Situation entfallen:

• Buch und Kapitel nutzen den Schrägstrich als Trennzeichen; als Verzeichnis wird der Kapitelname Quellenverzeichnis verwendet; diese Seite steht direkt unterhalb der Hauptseite des Buches.
• Beispiel: Mykorrhiza – Pilz-Wurzel-Symbiosen/ Quellenverzeichnis

In allen anderen Fällen muss das Verzeichnis explizit genannt werden. Beispiel:

• name=Biochemie und Pathobiochemie: Literatur und Weblinks

Der Parameter "text"

Mit diesem Parameter kann der Anzeigetext für Link bzw. Anker angepasst werden, wenn an einer bestimmten Stelle der name nicht passt.

Beispiele

Bisher werden die Vorlagen noch nicht durchgehend genutzt. Mögliche Verwendungen sind auf Juethos Entwurfsseite zu finden; das Quellenverzeichnis wird durch Benutzer:Juetho/ Entwurf 2 simuliert.

• im Text einer Fußnote:
  voriger Text.<ref>vgl. {{Quelle-Link|Abc 01|ziel=Benutzer:Juetho/ Entwurf 2}} S. 123</ref> Und so weiter
  voriger Text. Und so weiter
• direkt im fortlaufenden Text:
  Beispielsweise enthält {{Quelle-Link|Abc 01|ziel=Benutzer:Juetho/ Entwurf 2|typ=0}} eine Aussage...
  Beispielsweise enthält Abc 01 eine Aussage...
• der gleiche Link mit einem abweichenden Text zur Anzeige:
  Beispielsweise enthält {{Quelle-Link|Abc 01|ziel=Benutzer:Juetho/ Entwurf 2|typ=0|text=Abc & Def}} eine Aussage...
  Beispielsweise enthält Abc & Def eine Aussage...
• mit den Links in runden oder eckigen Klammern:
  Herrmann hat das 1954 erklärt {{Quelle-Link|name=Herrmann-2|ziel=Benutzer:Juetho/ Entwurf 2|typ=1}} im Widerspruch zu Häsel {{Quelle-Link|name=Häsel-4|ziel=Benutzer:Juetho/ Entwurf 2|typ=2}} mit seiner Aussage...
  Herrmann hat das 1954 erklärt (Herrmann-2) im Widerspruch zu Häsel [Häsel-4] mit seiner Aussage...
• Sonderzeichen wie # & sind kein Problem, aber | " müssen codiert werden, und = verlangt den ersten Parameter mit Namen:
  Sonderzeichen so: {{Quelle-Link|1=Ex# | &#34a=b|ziel=Benutzer:Juetho/ Entwurf 2}}
  Sonderzeichen so: Ex# | "a=b

Die erste praktische Verwendung ist hier zu finden:

• Mykorrhiza – Pilz-Wurzel-Symbiosen/ Der Begriff Mykorrhiza mit Beispielen für {{Quelle-Link}}
• Mykorrhiza – Pilz-Wurzel-Symbiosen/ Quellenverzeichnis mit den Einträgen und {{Quelle-Beleg}}

Weitere Hinweise

Diese Vorlagen sind entstanden nach einem Verbesserungsvorschlag zum Thema „Kapitelübergreifende Bibliographie“ (Archiv 2016). Dort sind auch Erläuterungen zu den Zielen und zum Aufbau zu finden.

Vorlagen zu den eigentlichen Quellenangaben:

• Wikibooks:Vorlagen/ Quellenangaben – Beispiele mit verschiedenen Vorlagen
• Vorlage:Literatur – eine Vorlage für viele Varianten

Erläuterungen zu den benutzten Verfahren:

• Hilfe:Links/ Anker
• Hilfe:Links/ Quellenangaben – mit Hinweisen zu Varianten

Auf den Parameter ziel kann vorerst nur verzichtet werden, wenn das Buch den Schrägstrich als Trennzeichen für Kapitel verwendet. Wenn für Bücher mit Doppelpunkt ein Standardvorschlag eingeführt wird, kann das etwa wie folgt ergänzt werden (die Leerzeichen stehen hier nur zur besseren Lesbarkeit):

• {{{ziel| {{#ifeq: {{ROOTPAGENAME}} | {{PAGENAME}} | neue Variante | {{ROOTPAGENAME}} }}/_Quellenverzeichnis}}}

In der Diskussion zum Verbesserungsvorschlag gab es auch Gedanken, die Texte vor und nach dem Link sowie die Einbindung als Fußnote als Parameter zu verwenden. Darauf wird verzichtet, weil das keinerlei zusätzlichen Wert bringt: Diese Angaben gehören zum Text des Kapitels und nicht zur Funktion der Vorlage.