Vorlage:Literatur/Doku

Vorlage:Dokumentation/Dokuseite Vorlage:TemplateData Anmerkung: Die TemplateData enthalten auch Mappings für den Citoid-Dienst zur automatischen Übernahme von bibliografischen Angaben aus URLs im VisualEditor. Die unterstützten Quelltypen sind unter MediaWiki:Citoid-template-type-map.json spezifiziert und unter gsl-nagoya-u.net die möglichen Citoid-Parameter.

Allgemeines

Diese Vorlage wurde im Mai 2016 komplett auf Lua-Programmierung umgestellt.

Zunächst sollte fast alles wie gewohnt weitergehen.

Es gibt aber neue Parameter und Funktionalitäten, und Details der Darstellung können sich ändern.

Andere Parameter und Parameterformate wurden obsolet.
Neu ist eine intensivierte Analyse der Parameter, die während der Bearbeitungsvorschau Fehlermeldungen sichtbar macht.

Unter Vorlage:Literatur/Test kann an verschiedenen Testaufrufen die Funktionsweise erkannt werden. Fragen und Hinweise bitte auf die Diskussionsseite. Die Anwendungsweise wird im Folgenden erklärt.

Neben der allgemeinen Vorlage:Literatur existieren noch weitere spezialisierte Vorlagen, siehe Kategorie:Vorlage:Zitation, sowie spezielle Vorlagen für die Angabe von Datenbankverweisen, die mit Vorlage:Literatur kombiniert werden können, siehe Kategorie:Vorlage:Datenbanklink. Beispiele sind auf dieser Dokumentationsseite zu finden.

Diese Vorlage sollte nicht als {{subst:Literatur|…}} aufgelöst und durch Normaltext ersetzt werden, weil dadurch ein unüberblickbarer Wust von {{if…}} und sonstigem Wiki-Quelltext entstünde.

Parameter (Einzelheiten)

Alle Parameter außer dem Titel= sind optional und werden über ihren Namen angesprochen. Die Reihenfolge der Parameter ist technisch egal, sollte jedoch einer gewissen Logik folgen.

Die Vorlage ist zunächst tolerant gegenüber Abweichungen in den Namen der Parameter und der Formatierung von Werten, stellt sie wie mutmaßlich gewünscht dar, wirkt jedoch teils nachdrücklich auf die Standardisierung hin.

Die meisten Parameterwerte werden inhaltlich analysiert und die Formatierungen entsprechend angepasst. Punkte am Ende von Werten müssen nicht angegeben werden, können es aber, etwa als Abkürzungspunkte. Bei einfachen (numerischen) Werten werden Schlüsselwörter geeignet ergänzt; nicht erkennbare Wertzuweisungen jedoch belassen wie vorgefunden. Als Textwerte können – anders als in der englischsprachigen Wikipedia – immer auch Vorlagen benutzt werden, etwa zur Fremdsprachenunterstützung, sofern nicht bereits durch den einfachen Sprachparameter ausreichend abgedeckt.

Gliederung

Basisinformationen

Allgemeine Beschreibung des von uns zitierten oder erwähnten Aufsatzes bzw. Buches.

Schriftenreihe

Wenn eine Publikation Teil einer übergeordneten Reihe ist (jedoch keine Zeitschrift).

Fundstelle

Innerhalb der Basisinformationen genauere Spezifikation eines Bereichs.

Bezeichner

Standardisierte Datenbankschlüssel. Diese gibt es in zwei Grundtypen:

Identifikation des gesamten Werkes, etwa eines Buches oder einer Zeitschrift allgemein.
Identifikation eines einzelnen Aufsatzes oder Artikels darin.

Vom ersten Typ soll immer nur einer und möglichst ein weltweit gültiger Wert angegeben werden. Der zweite Typ führt oft zu einem online lesbaren Text oder Auszug; hiervon sollen alle bekannten ID benannt werden, um in Datenbanken nach frei verfügbaren Reproduktionen suchen zu können.

Online

Wenn der Text vollständig oder in Auszügen im Internet verfügbar ist und nicht schon durch einen „Datenbankschlüssel“ erschlossen ist, kann ein Weblink angegeben werden.

Originaltext

Wenn der unter „Basisinformationen“ beschriebene Text aus einem anderen entstanden ist (meist durch Übersetzung), kann bei Bedarf der Originaltext spezifiziert werden.

Erstausgabe

Allererstes Erscheinen des unter „Basisinformationen“ beschriebenen Textes, falls erforderlich.

Sofern ein „Originaltext“ definiert ist, bezieht es sich auf dessen Erstausgabe.

Sonstiges

Kommentar – Ergänzung zur allgemeinen Beschreibung oder allen anderen Parameterwerten

Zitat

Steuerparameter

Veraltet

Die Struktur und Namensgebung wurde möglichst der Vorlage:Internetquelle angeglichen.

Einige Parametrisierungen verursachen Probleme beim Austausch mit externer Software.

Neu im Sommer 2016

Sprache= (Bezugstext)
Umfang= (sparsam verwenden)
Fundstelle= für vielfältige Spezialfälle
Genauere Beschreibung der Schriftenreihe: NummerReihe= | BandReihe= | HrsgReihe=
ArtikelNr= für bestimmte Werke ermöglicht
Zitat=
Eigenschaften von Online-Ressourcen, auch zur Bot-Unterstützung geeignet: Format= | KBytes=
Verschiedene Schlüsselnummern; offen für zukünftige Vorschläge weiterer sinnvoller und häufiger IDs: bibcode= | JSTOR= | URN= | ID=
Erstausgabe – mit JahrEA= | VerlagEA= | OrtEA=
ISBNdefekt= (für falsche Anzahl der Ziffern)

Veraltet

Parameter	Kommentar/Beispiel
Herausgeber	Jetzt: `Hrsg=` Die Abkürzung ist allgemeinverständlich. Die Abkürzung erscheint in der Ausgabe. Angleichung an Vorlage:Internetquelle – `hrsg`. Die Umstellung kann nach und nach ohne Eile erfolgen.
Jahr	Jetzt: `Datum=` Externe Werkzeuge wie citoid@VE konnten das Datum nicht fragmentiert schreiben. Allgemein ist der Austausch zwischen Werkzeugen als komplettes Datum üblich. Angleichung an Vorlage:Internetquelle – `datum`. In der Vorlagenprogrammierung wurden Einzelstücke in einzelnen Variablen bevorzugt, weil die Zerlegung und Analyse von Teilzeichenketten kaum möglich war.
Monat	Jetzt: `Datum=`. Siehe `Jahr=`. Es kann `Nummer=` für „Herbst“ oder „Januar/Februar“ genutzt werden. Ungültige Angaben führen zu einer dauerhaft sichtbaren Fehlermeldung.
Tag	Jetzt: `Datum=`. Siehe `Jahr=`. Ungültige Angaben führen zu einer dauerhaft sichtbaren Fehlermeldung.
~~ISBNistFormalFalsch~~	Jetzt: `ISBNformalFalsch=` und Angabe der ISBN unter diesem Parameternamen, bzw. `ISBNdefekt=`. Dies war bisher ein logischer Schalter gewesen, der aussagen sollte, dass `ISBN=` eine ungültige Prüfziffer habe oder sonst ungültig wäre. Das führte zu Fehlerberichten externer Prüfsoftware am Quelltext. Das Konstrukt `ISBN` <Trennzeichen> Kodierung (wobei auch `isbn` stehen kann, <Trennzeichen> für Leerzeichen auch mit Gleichheitszeichen oder Doppelpunkt steht) erwartet eine gültige Kodierung. Durch den veränderten Variablennamen sind die Fälle klar zu unterscheiden, ohne in der Umgebung nach den Werten einer logischen Variable suchen zu müssen. Der Parameter wird nicht mehr unterstützt/nicht mehr erkannt. Alle signifikanten Altfälle wurden aufgelöst.
~~Titel-P~~	Jetzt: `Titel=` Bedeutete: „Titel minus Punkt“ In der Vorlagenprogrammierung wurde damit die automatische Punktsetzung am Titelende unterdrückt, etwa weil der Titel schon auf ein anderes Satzzeichen endete. Das wird inzwischen automatisch erkannt. Der Parameter wird nicht mehr unterstützt/nicht mehr erkannt. Alle signifikanten Altfälle wurden aufgelöst.
Zugriff	Jetzt: `Abruf=` In den Artikeln hat sich „abgerufen“ durchgesetzt. Dem soll Rechnung getragen und nicht durch „zugegriffen“, „gelesen“, „aufgerufen“, „eingesehen“, „konsultiert“, „gesichtet“, „gesehen“, „Download“, „Autopsie“ Verwirrung gestiftet werden. Die Umstellung kann nach und nach ohne Eile erfolgen.

Kopiervorlagen

Nicht verwendete Parameter sollten nach dem Kopieren, soweit es sich nicht um fehlende Angaben handelt oder mit ihrer Vervollständigung nicht zu rechnen ist, komplett entfernt werden.

Es wird außerdem gebeten, bei Einzelnachweisen (ref-Baustein) im Artikelrumpf nach dem Anlegen die Zeilenumbrüche zu entfernen, um den Quelltext nicht zu unübersichtlich zu machen. In den Literaturlisten am Ende der Artikel oder dort in den Blöcken <references>…</references> sind viele Autoren zu einer zeilenweisen Anordnung im Quelltext übergegangen (wie bei einer Infobox), um die teils umfangreichen Parameter besser kontrollieren zu können.

Kurzversion (Buch)

{{Literatur |Autor= |Titel= |Auflage= |Verlag= |Ort= |Datum= |ISBN= |Seiten=}}

{{Literatur
 | Autor=
 | Titel=
 | Auflage=
 | Verlag=
 | Ort=
 | Datum=
 | ISBN=
 | Seiten=
}}

Kurzversion (Zeitschriftenaufsatz)

{{Literatur |Autor= |Titel= |Sammelwerk= |Band= |Nummer= |Datum= |Seiten= |DOI=}}

{{Literatur
 | Autor=
 | Titel=
 | Sammelwerk=
 | Band=
 | Nummer=
 | Datum=
 | Seiten=
 | DOI=
}}

Vollversion – unbedingt vor dem Speichern die nicht benötigten Parameter löschen!

{{Literatur |Autor= |Titel= |TitelErg= |Hrsg= |Sammelwerk= |WerkErg= |Band= |Nummer= |Auflage= |Verlag= |Ort= |Datum= |Sprache= |Umfang= |Reihe= |NummerReihe= |BandReihe= |HrsgReihe= |ISBN= |ISBNformalFalsch= |Kapitel= |Seiten= |Spalten= |ArtikelNr= |Fundstelle= |ISSN= |ISSNformalFalsch= |ISBNdefekt= |ZDB= |DNB= |LCCN= |OCLC= |Lizenznummer= |arXiv= |bibcode= |DOI= |JSTOR= |PMC= |PMID= |URN= |ID= |Kommentar= |Online= |Format= |KBytes= |Abruf=2024-12-03 |Originaltitel= |Originaljahr= |Originalort= |Originalsprache= |Übersetzer= |JahrEA= |VerlagEA= |OrtEA= |Zitat= |Typ= }}

{{Literatur
| Autor=
| Titel=
| TitelErg=
| Hrsg=
| Sammelwerk=
| WerkErg=
| Band=
| Nummer=
| Auflage=
| Verlag=
| Ort=
| Datum=
| Sprache=
| Umfang=
| Reihe=
| NummerReihe=
| BandReihe=
| HrsgReihe=
| ISBN=
| ISBNformalFalsch=
| ISBNdefekt=
| ISSN=
| ISSNformalFalsch=
| Kapitel=
| Seiten=
| Spalten=
| ArtikelNr=
| Fundstelle=
| ZDB=
| DNB=
| LCCN=
| OCLC=
| Lizenznummer=
| arXiv=
| bibcode=
| DOI=
| JSTOR=
| PMC=
| PMID=
| URN=
| ID=
| Kommentar=
| Online=
| Format=
| KBytes=
| Abruf=2024-12-03
| Originaltitel=
| Originaljahr=
| Originalort=
| Originalsprache=
| Übersetzer=
| JahrEA=
| VerlagEA=
| OrtEA=
| Zitat=
| Typ=
}}

Beispiele

Die Beispiele und die Testseite sind möglicherweise noch nicht restlos an die Änderungen vom Mai 2016 angepasst.