Vorlagenprogrammierung Diskussion Lua Unterseiten mit Präfix
Modul Deutsch Englisch Modul: Dokumantation:

Modul für wiederverwendbare Literaturangaben

Bearbeiten

Mit diesem Modul können Literaturdaten aus Wikidata eingebunden werden und Literaturverzeichniseinträge als Linkziel für Einzelnachweise in Kurzschreibung gestaltet werden.

existierende Vorlagen

Bearbeiten

Vorlage:Literatur/Einzelreferenz

Bearbeiten

Siehe Vorlage:Literatur/Einzelreferenz. Diese Vorlage fügt einen vollständigen Literaturbeleg inklusive ref-Tags ein. Sie verwendet die in der Spezifikation beschriebenen Parameter der Vorlage:Literatur mit folgenden Besonderheiten:

  • Wenn die Werte der Parameter Titel, Sammelwerk, oder Reihe einen Wikidata-Objektschlüssel ("Q123...") darstellen, werden alle darunter verfügbaren, relevanten Informationen aus Wikidata in der Referenz aufgeführt, soweit sie nicht von Hand in der Vorlageneinbindung angegeben wurden. Die in die Vorlageneinbindung eingetragenen Werte überschreiben also ggf. die Werte, die in Wikidata hinterlegt sin.
  • Wenn in Wikidata ein Kurzname hinterlegt ist, wird dieser als Referenzname verwendet. Diese Eigenschaft kann durch den Parameter ID in der Vorlageneinbindung überschrieben werden.
  • Die Vorlage kennt einen Parameter group, mit dem Referenzgruppen unterstützt werden.

Beispiele

Bearbeiten
Gegeben sei ein Text. Diese Aussage erhält den Einzelnachweis.{{Literatur/Einzelreferenz |Titel=Q114328437 |group=ER}} Weitere Beiträge hat 007 geleistet.{{Literatur/Einzelreferenz|ID=Bond 2007 |Autor=James Bond |Titel=Waffentechnik für Dummies |Sammelwerk=Handreichungen für Doppelnullen |Band=3 |group=ER}}

'''Einzelnachweise'''

<references group="ER" />

wird zu

Gegeben sei ein Text. Diese Aussage erhält den Einzelnachweis.Vorlage:Literatur/Einzelreferenz Weitere Beiträge hat 007 geleistet.Vorlage:Literatur/Einzelreferenz

Einzelnachweise


Vorlage:Literatur/Listeneintrag

Bearbeiten

Diese Vorlage integriert einen vollständigen Literaturbeleg in den Parameter der Vorlage:Literatur/Liste. Die Parameter entsprechen vollständig denen der Vorlage:Literatur mit den für die Vorlage:Literatur/Einzelreferenz beschriebenen Besonderheiten. Ein Parameter group existiert nicht.

Vorlage:Literatur/Liste

Bearbeiten

Diese Vorlage erzeugt eine Aufzählung von Literatureinträgen. Sie ist alphabetisch nach Kurznamen sortiert. Der einzige (unbenannte) Parameter ist als Zeichenkette eine Folge von Einträgen nach dem Schema Kurzname{Datensatz}. Diese Einträge können vorzugsweise untereinander geschrieben werden. Ein Eintrag besteht im einfachsten Fall aus einem Paar geschweifter Klammern, das einen Wikidata-Objektschlüssel umschließt. Dieser sollte für ein Datenobjekt stehen, das selbst über einen Eigenschaftswert "Kurzname" verfügt. Für Das Buch Deuteronomium (Q114328437) lautet ein geeigneter Eintrag: {Q114328437} In diesem Fall kann der Kurzname aber auch überschrieben werden mit: neuer Kurzname{Q114328437} Das wiederum ist vollständig äquivalent zu {{Literatur/Listeneintrag|Titel=Q114328437|ID=neuer Kurzname}}. Mit dieser Vorlage können dann auch andere Eigenschaften überschrieben, oder ergänzt werden. Soll basierend auf einem Datenobjekt ein neuer Eintrag erzeugt werden, kann dies beispielsweise so geschehen: {{Literatur/Listeneintrag|Titel=Sintern ohne Schrumpfen|Sammelwerk=Q1610770 |Nummer=4/1999 |Seite=95}}

Beispiel

Bearbeiten
{{Literatur/Liste|
{Q114328437}
Hannig 1999{Q114435572}
Beispiel 2022{Berti Beispiel: ''Beispiel für einen manuellen Eintrag''. In: ''[[Wikipedia:Lua/Modul/Literatur]]''. deWiki 2022.}
{{Literatur/Listeneintrag|ID=Bond 2007|Autor=James Bond|Titel=Waffentechnik für Dummies |Sammelwerk=Handreichungen für Doppelnullen|Band=3}}
Hannig 1997{Q29561460}
{Beispielbenutzer: ''Beispiel für einen manuellen Eintrag: ohne Kurznamen''. In: ''Wikipedia:Lua/Modul/Literatur''. deWiki 2022.}
Forsskål 1775{Q5862701}
{{Literatur/Listeneintrag|Titel=Sintern ohne Schrumpfen|Sammelwerk=Q1610770 |Nummer=4/1999 |Seite=95}}
}}

wird zu Vorlage:Literatur/Liste

Anmerkungen

Bearbeiten

Hier fällt auf,dass beim letzten Eintrag das Jahr des ersten Heftes (1978) angegeben ist, weil dieses Jahr im Wikidata-Objekt vom Sammelwerk eingetragen ist. Es sollte folglich mit Datum=1999 überschrieben werden. Bei der Gelegenheit kann auch der Kurzname gleich überarbeitet werden:

{{Literatur/Listeneintrag|Titel=Sintern ohne Schrumpfen|Sammelwerk=Q1610770 |Nummer=4/1999 |Datum=1999|Seite=95|ID=Spektrum 04/1999}}

wird zu

Vorlage:Literatur/Listeneintrag

Des weiteren sind folgende beiden Einträge äquivalent:

{{Literatur/Listeneintrag|ID=Bond 2007|Autor=James Bond|Titel=Waffentechnik für Dummies |Sammelwerk=Handreichungen für Doppelnullen|Band=3}}

und

Bond 2007{ {{Literatur|Autor=James Bond|Titel=Waffentechnik für Dummies |Sammelwerk=Handreichungen für Doppelnullen|Band=3}}}

Hier ist bei der zweiten Variante insbesondere auf den Leerraum hinter der ersten öffnenden geschweiften Klammer zu achten. Ein Zugriff auf Wikidata-Informationen ist in dieser zweiten Variante nicht möglich.

Die Vorlage:Literatur/Liste verhält sich wie eine Gruppe von Listeneinträgen, die zufällig auch noch in sich sortiert ist. Es ist zudem sichergestellt, dass sich Anker für die Elemente der Gruppe nicht wiederholen. Einzelne Einträge können von dieser Vorlage unabhängig über, oder unter die Liste geschrieben werden mit der

Vorlage:Literatur/mit Anker

Bearbeiten

Diese Vorlage erzeugt einen Literatureintrag mit einem vorangestellten Anker, der in seiner Funktionalität genau dem der Vorlage:Literatur/Listeneintrag entspricht. Da er jedoch nicht teil der Vorlage:Literatur/Liste ist, kann es zu Wiederholungen des Ankers kommen. In diesem Fall wird nur der oberste der gleichnamigen Anker als Sprungziel berücksichtigt. Diese Vorlage verhält sich ansonsten weitgehend, wie die Vorlage:Literatur.

Einbindung per #invoke

Bearbeiten

ISBN(frame)

überprüft und formatiert eine eingegebene Folge von Ziffern und Bindestrichen als ISBN

Parameter:
unbenannt, oder ISBNISBN-Ziffern, optional mit Bindestrichen vorformatiert
Rückgabewert:Link auf ISBN-Suche, ggf. mit Hinweis auf Fehler

Beispiel

Bearbeiten
{{#invoke:Literatur|ISBN|3805317719}}

liefert ISBN 3805317719 (unmögl.)

{{#invoke:Literatur|ISBN|Test 38-05-31-77-19}}

liefert ISBN 38-05-31-7 (ungült.)

{{#invoke:Literatur|ISBN|3805317717}}

liefert ISBN 3805317717 (unmögl.)

{{#invoke:Literatur|ISBN|38053177}}

liefert ISBN 3-8053-177 (unmögl.)

byWikiData(frame)

generiert einen Literaturverzeichniseintrag aus einem Wikidata-Datenobjekt

Parameter:
unbenannt, oderWikidata Qualifier
Rückgabewert:Literaturverzeichniseintrag

Beispiel

Bearbeiten

* {{#invoke:Literatur|byWikiData|Q29561460}} liefert



Allgemeine Hinweise zur Einbindung von Modulen

Bearbeiten

Eine Einbindung erfolgt jeweils im Format

{{#invoke: Modulname | Funktionsname | Wert1 | Wert2 | NameX=Wert … }}

Die Parameter können wie bei Vorlagen benannt oder unbenannt sein; deren Regeln gelten analog.

Wenn unbekannte Zeichenketten von außen kommen (als Vorlagenparameter), sollte immer mit der Form 1=Wert gearbeitet werden.

Zu allgemeinen Problemen beachte die Abhilfen wie bei Vorlagen.

Wenn in einer Vorlage ein Modul verwendet wird, sollte auch immer die Vorlage:Dokumentation/Lua in der Dokumentationsseite eingebunden werden.

  1. Das gibt einem Programmierer Aufschluss, dass ein Lua-Modul benutzt wird, welche/s und ggf. welche Einzelfunktion daraus, und verlinkt auf die Dokumentation.
  2. Die Modul-Dokumentationen bekommen ein Link, in welchen Vorlagen sie eingesetzt werden, und wo bei eventuellen Funktionsänderungen Anpassungen erforderlich werden.
  3. Die Vorlage wird zur Übersicht kategorisiert in Kategorie:Vorlage:mit Lua-Programmierung.

Zu weiteren Informationen siehe Hilfe:Lua.

Bei Problemen wende dich bitte an die Vorlagen-Werkstatt, in schweren Fällen hilft auch die Lua-Werkstatt.