Vorlage:Literatur/Doku
Diese Seite ist die Dokumentations-Unterseite der Vorlage:Literatur.
|
Diese Vorlage wurde am Pfingstsonntag 2016 komplett auf Lua-Programmierung umgestellt. Die Transformation hat sich als stabil gezeigt. Zunächst sollte fast alles wie gewohnt weitergehen. Es gibt aber neue Parameter und Funktionalitäten, und Details der Darstellung können sich ändern.
Am Wochenende 21./22. Mai werden die neuen Möglichkeiten dokumentiert. --PerfektesChaos 16:57, 20. Mai 2016 (CEST) |
Diese Vorlage erzeugt – mit Daten gefüllt – für gedruckt vorliegende Literatur eine Beschreibung anhand der Wikipedia:Zitierregeln. Die Vorlage generiert zudem automatisch einen Eintrag im Mikroformat COinS, das die automatische Extraktion von Metadaten durch Literaturverwaltungsprogramme wie Zotero erlaubt.
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. Für reine Internetquellen (nur online verfügbar) wird die Vorlage:Internetquelle empfohlen.
|
Diese Vorlage sollte nicht als |
Übersicht (TemplateData)
[Quelltext bearbeiten]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 die möglichen Citoid-Parameter unter http://gsl-nagoya-u.net/http/pub/csl-fields/index.html.
Parameter (Einzelheiten)
[Quelltext bearbeiten]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.
Gliederung
[Quelltext bearbeiten]- 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.
- 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.
Einzelbeschreibungen
[Quelltext bearbeiten]| Parameter | Kommentar/Beispiel |
|---|---|
| Basisinformationen | |
| Autor | Autoren (Vorname Nachname, Vorname Nachname, …). |
| Hrsg | Herausgeber des Sammelwerkes oder des zitierten Werkes (falls kein Autor angegeben).
|
| Titel | Titel des zitierten Werkes (bei Bedarf automatische Punktsetzung am Titelende).
|
| TitelErg | Ergänzende Angaben zu Titel=.
|
| Sammelwerk | Titel des übergeordneten Werkes: Zeitschrift, Sammelband …
|
| WerkErg | Analog zu TitelErg=, für Sammelwerk= (wird nur angezeigt, wenn dieses angeben ist)
|
| Band | „Band 1“ (keine automatische Ergänzung: „Band“ ist einzutragen), „Volume 34“ (Bandnummer, im englischen Sprachraum Volume, Vol.), „Buch 12“ |
| Nummer | Nummer, auch bekannt als Issue, Heft oder Ausgabe („Nr.“ wird automatisch ergänzt, nicht eingeben) |
| Auflage | „1.“, „2., überarbeitete“ („Auflage“ wird automatisch ergänzt, nicht eingeben) |
| Verlag | Publizierende Institution.
Keine Angabe erforderlich, wenn eine Zeitschrift etc. als |
| Ort | Verlagsort (nur bei Buchverlagen als Verlag=).
|
| Datum | Die Jahreszahl sollte immer vorhanden sein.
|
| Sprache | Fremdsprache des aktuell herangezogenen Textes. Angabe nach ISO 639, mit meist zwei oder drei Kleinbuchstaben.
|
| Umfang | Gesamtzahl der Seiten eines Werkes, wenn für die Literaturverwendung notwendig und hilfreich; „S.“ wird automatisch ergänzt.
|
| Kommentar | Anmerkungen, selten Empfehlung. Wird in Klammer hinter dem Werk angeführt; weil auch andere Angaben dort stehen können und das Trennzeichen ein „;“ ist, ggf. in Kleinbuchstaben beginnen. |
| Schriftenreihe | |
| Reihe | Die Schriften- oder Buchreihe (Serie, engl. Series), in der das Werk erschienen ist. Die Reihe erscheint in Klammern nach einem Gleichheitszeichen nach Nennung des Sammelwerks bzw. Titels (wenn kein Sammelwerk= angegeben wird).
|
| NummerReihe | Bandnummer in einer Schriften- oder Buchreihe Reihe=.
|
| BandReihe | Bandbezeichnung (keine Nummer) in einer Schriften- oder Buchreihe Reihe=.
|
| HrsgReihe | Herausgeber einer Schriften- oder Buchreihe Reihe=.
|
| Fundstelle | |
| Kapitel | zum Beispiel: „Kap. Urgeschichte“, „Vorwort des Herausgebers“, „2.1.7 Sonstiges“, „614b“, „Annex II“ (Titulatur kursiv setzen – im Unterschied zu Seiten und Spalten wird hier nichts ergänzt, und lässt Freiraum für beliebige Gliederungsabschnitte des Werks)
|
| Seiten | beispielsweise: „192“, „27–34“ (Bis-Strich nicht vergessen!), „13 f.“, „13 ff.“, („S.“ wird automatisch ergänzt, nicht eingeben)
|
| Spalten | Manche Artikel, beispielsweise einige Lexika, sind nicht nach Seiten sondern nach Spalten organisiert; dann hier die Spaltenzählung eingeben, zum Beispiel: „3–4“ (Bis-Strich nicht vergessen! – „Sp.“ wird automatisch ergänzt, nicht eingeben) |
| ArtikelNr | Es gibt einige Fälle (z. B. PLoS und einige Fachzeitschriften), bei denen Fachartikel nicht mit Seitenzahlen, sondern einer Artikelnummer angegeben werden. Dieser Fall wird durch Seiten, Band, Nummer nicht erfasst und ein vorangestelltes „S.“ bei der Nutzung des Seiten-Parameters ist irritierend.
|
| Fundstelle | Hochauflösende Fundstelle innerhalb einer Seite oder eines Abschnitts. Etwa: Absatz, Randnummer, Zeile, Vers, Anmerkung; siehe auch Kapitel=.
|
| Datenbankschlüssel | |
| ISBN | ISB-Nummer (ohne Eingabe des vorangestellten „ISBN“)
|
| ISBNformalFalsch | Wie ISBN= aber mit falsch berechneter Prüfziffer.
|
| ISSN | ISS-Nummer für Zeitschriften (ohne Eingabe des vorangestellten „ISSN“), wenn Sammelwerk= nicht verlinkbar ist.
|
| ISSNformalFalsch | Wie ISSN= aber mit falsch berechneter Prüfziffer. Die Hinweise unter ISBNformalFalsch= gelten analog.
|
| ZDB | Zeitschriftendatenbank der Deutschen Nationalbibliothek, wenn Sammelwerk= nicht verlinkbar und ISSN= nicht vergeben ist.
|
| DNB | Deutsche Nationalbibliothek, wenn keine ISBN= vorhanden.
|
| LCCN | Library of Congress Control Number, wenn keine ISBN= vorhanden.
|
| OCLC | WorldCat / Online Computer Library Center, wenn keine anderen Nummern vorhanden; siehe Vorlage:OCLC |
| Lizenznummer | Lizenznummer in der DDR, wenn keine DNB= vorhanden.
|
| arXiv | Artikel in The Archive, siehe Vorlage:ArXiv
|
| bibcode | Artikel im Astrophysics Data System, siehe Vorlage:bibcode
|
| DOI | Digital Object Identifier, siehe Vorlage:DOI
|
| JSTOR | JSTOR für einzelne Artikel gemäß {{JSTOR}}
|
| PMC | Artikel im PubMed Central |
| PMID | Artikel im PubMed, wenn PMC= nicht vorhanden ist.
|
| URN | Artikel mit Uniform Resource Name (ohne vorangestelltes urn:)
|
| ID | Nichtkommerzieller Datenbankschlüssel, der von keinem anderen Bezeichner abgedeckt ist.
|
| Online-Ressource | |
| Online | URL mit beschreibendem Text (Weblink), wodurch eine Reproduktion des Textes zugänglich wird, und die nicht schon von einer Datenbank-ID abgedeckt ist.
|
| Format | Format einer Online-Ressource in Online=, für die spezielle Software benötigt wird, sofern die URL direkt auf eine derartige Ressource verlinkt.
|
| KBytes | Ungefähre Größenangabe bei einer Online-Ressource, für die spezielle Software benötigt wird, die durch Format= spezifiziert wurde.
|
| Abruf | Nur bei der Angabe von Online-Ressourcen mit Online= ausgewertet. Zeitpunkt, zu dem die zitierten Informationen zuletzt erfolgreich gelesen wurden. Das Datum sollte im ISO-Format YYYY-MM-TT, das heißt Jahr-Monat-Tag (zum Beispiel 2015-06-16), geschrieben werden.
|
| Ursprungstext | |
| Originaltitel | Der Originaltitel in der Originalsprache (meist nicht deutsch).
|
| Originalsprache | Code nach BCP 47 / RFC 4646 für die Sprache, in der das Original verfasst wurde, zum Beispiel: „en“, „en-US“ oder „ar-Latn-EG“, siehe auch Vorlage:lang. Dieser Parameter wird nur bei gleichzeitiger Verwendung von Originaltitel= ausgewertet.
|
| Originaljahr | Das Jahr der Herausgabe der fremdsprachigen Originals |
| Originalort | Ort des Erscheinens des fremdsprachigen Originals |
| Übersetzer | Der (meist deutsche) Übersetzer der entsprechenden Ausgabe |
| Sonstiges | |
| Zitat | Kurzes Zitat (in der Sprache= oder sonst deutsch)
|
| Typ | Einzig gültiger Wert: wl (Werkliste). Wenn dieser Parameterwert angegeben wird, erscheint der Name des Autors nicht im Resultat. Dadurch kann die Vorlage auch in Werklisten verwendet werden.
|
| Veraltet | |
| Herausgeber | Jetzt: Hrsg=
Die Umstellung kann nach und nach ohne Eile erfolgen. |
| Titel-P | Jetzt: Titel=
Die Unterscheidung sollte nach und nach zurückgebaut werden, um Autoren nicht zu verwirren. |
| Jahr | Jetzt: Datum=
|
| Monat | Jetzt: Datum=
|
| Tag | Jetzt: Datum=
|
| ISBNistFormalFalsch | Jetzt: ISBNformalFalsch= und Angabe der ISBN unter diesem Parameternamen.
Die alten Wertzuweisungen sollten bald zurückgebaut werden, um Verwirrung zu vermeiden. |
| Zugriff | Jetzt: Abruf=
Die Umstellung kann nach und nach ohne Eile erfolgen. |
Kopiervorlagen
[Quelltext bearbeiten]Nicht verwendete Parameter sollten nach dem Kopieren, soweit es sich nicht um fehlende Angaben handelt bzw. 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.
{{Literatur | Autor= | Titel= | Datum= | Sammelwerk= | Nummer= | Seiten= | Online=}}
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= | Kommentar= | Kapitel= | Seiten= | Spalten= | ArtikelNr= | Fundstelle= | ISBN= | ISBNformalFalsch= | ISSN= | ISSNformalFalsch= | ZDB= | DNB= | LCCN= | OCLC= | Lizenznummer= | arXiv= | bibcode= | DOI= | JSTOR= | PMC= | PMID= | URN= | ID= | Online= | Format= | KBytes= | Abruf=2024-12-22 | Originaltitel= | Originaljahr= | Originalort= | Originalsprache= | Übersetzer= | Zitat= | Typ= }}
{{Literatur
| Autor=
| Titel=
| TitelErg=
| Hrsg=
| Sammelwerk=
| WerkErg=
| Band=
| Nummer=
| Auflage=
| Verlag=
| Ort=
| Datum=
| Sprache=
| Umfang=
| Reihe=
| NummerReihe=
| BandReihe=
| HrsgReihe=
| Kommentar=
| Kapitel=
| Seiten=
| Spalten=
| ArtikelNr=
| Fundstelle=
| ISBN=
| ISBNformalFalsch=
| ISSN=
| ISSNformalFalsch=
| ZDB=
| DNB=
| LCCN=
| OCLC=
| Lizenznummer=
| arXiv=
| bibcode=
| DOI=
| JSTOR=
| PMC=
| PMID=
| URN=
| ID=
| Online=
| Format=
| KBytes=
| Abruf=2024-12-22
| Originaltitel=
| Originaljahr=
| Originalort=
| Originalsprache=
| Übersetzer=
| Zitat=
| Typ=
}}
Beispiele
[Quelltext bearbeiten]|
Die Beispiele und die Testseite sind möglicherweise noch nicht restlos an die Änderungen Mai 2016 angepasst. |
Beitrag in Sammelwerk
[Quelltext bearbeiten]{{Literatur
|Autor=Max Mustermann
|Titel=Aspekte modernen Wikipädisierens
|Hrsg=Bernd Beispiel
|Sammelwerk=Soziologie der Wikipädianer
|Reihe=Wikipediabeispielbücher
|Band=Bd. 7
|Verlag=Wikipedia-Press
|Ort=Musterstadt
|Datum=2003
|ISBN=3-9801412-1-7
|Seiten=213–278}}
Resultat:
Artikel in wissenschaftlicher Zeitschrift
[Quelltext bearbeiten]{{Literatur
|Autor=Max Mustermann
|Titel=Semantischer Kollaps bei Löschdiskussionen
|Sammelwerk=Journal of Wikipedianism
|Band=2
|Nummer=3
|Datum=2006
|Seiten=17–67
|DOI=10.1371/journal.pbio.0020449}}
Resultat:
Zeitungsartikel
[Quelltext bearbeiten]{{Literatur
|Autor=Max Mustermann
|Titel=Wikipedia wohin?
|Sammelwerk=FAZ
|Datum=2003-02-01
|ISSN=0174-4909
|Seiten=3}}
Resultat:
Fremdsprachiges Werk
[Quelltext bearbeiten]{{Literatur
|Autor=John Doe
|Titel=Einführung in die Trollerei
|Originaltitel=Introduction to Trolling
|Originalsprache=en-US
|Verlag=Wikipedia-Press
|Ort=Musterstadt
|Datum=2003
|ISBN=3-9801412-1-7}}
Resultat:
Historisches
[Quelltext bearbeiten]{{Literatur
| Titel=Augsburg
| Sammelwerk=Die Chroniken der deutschen Städte vom vierzehnten bis ins sechzehnte Jahrhundert
| WerkErg=Auf Veranlassung und mit Unterstützung Seiner Majestaet des Königs von Bayern, Maximilian II. hrsg. durch die Historische Commission bei der Königl. Academie der Wissenschaften
| Band=LII
| Verlag=Hirzel
| Ort=Leipzig
| Datum=1866}}
Resultat:
Zeitschriftenaufsatz online
[Quelltext bearbeiten]{{Literatur
|Autor=Benoît Majerus
|Titel=Polizei im besetzten Belgien, 1914–1918 und 1940–1944. Eine vergleichende Studie der Brüsseler Polizei während der beiden Weltkriege
|Sammelwerk=Francia
|Band=Bd. 32
|Nummer=3
|Datum=2005
|Seiten=1–22
|Online=[http://francia.digitale-sammlungen.de/Blatt_bsb00016438,00013.html digitale-sammlungen.de]
|Abruf=2011-04-18}}
Resultat:
Werklisten
[Quelltext bearbeiten]Als Teil einer Werkliste kann die Autorenangabe ausgeblendet werden:
{{Literatur
|Autor=Max Mustermann
|Titel=Aspekte modernen Wikipädisierens
|Hrsg=Bernd Beispiel
|Sammelwerk=Soziologie der Wikipädianer
|Reihe=Wikipediabeispielbücher
|Band=Bd. 7
|Verlag=Wikipedia-Press
|Ort=Musterstadt
|Datum=2003
|ISBN=3-9801412-1-7
|Seiten=213–278
|Typ=wl}}
Resultat:
Hilfsmittel und Werkzeuge
[Quelltext bearbeiten]Für das halbautomatische Ausfüllen der Vorlagenfelder stehen derzeit verschiedene Hilfmittel zur Verfügung:
- Direkt als JavaScript:
- Im VisualEditor werden Citoid-Angaben aus den Ressourcen selbst zur Verfügung gestellt.
- Das Benutzerskript citoidWikitext füllt bei der Quelltextbearbeitung die Einzelheiten anhand von ISBN, DOI, PMID, PMC, DNB, OCLC, LCCN, arXiv usw. aus.
- Der Vorlagenmeister erleichtert das Ausfüllen bei der Quelltextbearbeitung.
- Labs-Tools:
- Templator – Hilfsmittel zum Erstellen von Literaturangaben mit dieser Vorlage. Aktuelle Dokumentation siehe auch unter meta:Templator/De
- Externe Anbieter:
- PMID- und DOI-zu-Wikipedia-Reference-Konverter – füllt die Vorlagenfelder anhand einer PMID oder DOI
Es gibt auch spezielle Formatierungsvorlagen, die auf der Vorlage:Literatur aufsetzen bzw. zur Formatierung des Online-Parameters eingesetzt werden können. Dazu zählt unter anderem die Vorlage:Google Buch, die als Hilfsvorlage für den Online-Parameter (bitte Wikipedia:Weblinks beachten) genutzt werden kann (Verwendung der Vorlage, siehe Vorlagenbeschreibung).
Des Weiteren gibt es die Literaturverwaltung Zotero, der es über die COinS-Angaben aus der Vorlage:Literatur möglich ist, automatisch Literaturangaben aus Wikipedia-Artikeln einzulesen. Diese Funktion steht auch für die meisten Seiten von Fachzeitschriften, Online-Buchhändlern und den meisten Verlags- sowie Suchdiensten für wissenschaftliche Recherche zu Verfügung. Über nachfolgende Möglichkeiten kann ein so angelegter Datensatz einfach aus der Zotero-Datenbank in einen Wikipediaartikel eingefügt werden:
- über ein von Benutzer:JakobVoss bereitgestelltes Scaffold-Skript, siehe Benutzer:JakobVoss/Zotero
- über einen von Benutzer:Cepheiden bereitgestellten CSL-Style (nutzbar ab Zotero 2), siehe Benutzer:Cepheiden/Zotero
Die Literaturverwaltung Citavi verfügt ebenfalls über einen Zitierstil "Wikipedia - Vorlage Literatur (German)".
Wartung
[Quelltext bearbeiten]Kategorie:Wikipedia:Vorlagenfehler/Vorlage:Literatur: Sammlung von Artikeln mit nicht unterstützten Parametern oder fehlenden Pflichtparametern
Die Fehlermeldungen sind bei der Ansicht der Seite unsichtbar, sofern man nicht Elemente der Klasse Zitationswartung sichtbar macht (siehe WP:CSS):
.Zitationswartung {
display: inline ! important;
}
Während der Bearbeitung sind die Fehlermeldungen in der Vorschau für alle Bearbeiter sichtbar.
- Bis zur Reduktion des Rückstands der letzten Jahre wird die Anzeige der Fehlermeldungen in der Normalansicht ausgeblendet.