Quelltext der Seite Vorlage:Literatur/doc

<noinclude>{{Dokumentation/Dokuseite}}
</noinclude>
Diese Vorlage erzeugt – mit Daten gefüllt – Literaturangaben gemäß den Wikipedia-Richtlinien auf [[Wikipedia:Literatur]]. Diese Vorlage generiert zudem automatisch einen Eintrag im Mikroformat [[COinS]], das die automatische Extraktion von Metadaten durch Literaturverwaltungsprogramme wie [[w:de:Zotero|Zotero]] erlaubt. Unter [[Vorlage:Literatur/Test]] können an verschiedenen Testaufrufen die Funktionsweise erkannt werden. Fragen und Hinweise bitte auf die [[Vorlage Diskussion:Literatur|Diskussionsseite]]. Die Anwendungsweise wird im Folgenden erklärt.

Offene-Naturführer-HINWEIS : Übernommen von Wikipedia, aber für Verwendung in Naturwissenschaften modifiziert: Jahr kommt hier nach Autoren. Außerdem drei neue Felder:
* Freiform (Zitat nur als nicht weiter zerlegter String vorhanden!) und
* Quelle (= Autor, Jahr, Titel abgetrennt, aber Buch/Journalquellen nicht weiter zerlegt.
* Stichworte (Semikolon-getrennte Keywords, Stichworte im [[Attribut: Suchstichwort]] gesammelt)

ACHTUNG: Für '''Zeitschriften''' muß das Feld „Sammelwerk“ verwendet werden (so in Wikipedia - sollte hier vielleicht geändert werden?)

'''Technische Anmerkung'''

Die Vorlage darf ''nicht'' eingebunden oder transkludiert werden, da sonst die [[:Kategorie: Literatur]] mit transkludiert würde. Das Einbinden von Literaturangaben bewerkstelligt die [[Vorlage: Literaturverzeichnis]] bzw. [[Vorlage: Literaturdaten]], das formatieren der Literatur die [[Vorlage: Formatierte Literaturausgabe]].

-----

__INHALTSVERZEICHNIS__

== Kopiervorlagen ==

;Kurzversion (Buch)
<code><nowiki>{{Literatur | Autor= | Titel= | Verlag= | Ort= | Jahr= | ISBN= | Stichworte = }}</nowiki></code>

 <nowiki>{{Literatur
 | Autor      =
 | Titel      =
 | Verlag     =
 | Ort        =
 | Jahr       =
 | ISBN       =
 | Stichworte =
}}</nowiki>

;Kurzversion (Zeitschriftenaufsatz)
<code><nowiki>{{Literatur | Autor= | Titel= | Sammelwerk= | Band= | Nummer= | Jahr= | Seiten= | Stichworte = }}</nowiki></code>

 <nowiki>{{Literatur
 | Autor     =
 | Titel     =
 | Sammelwerk=
 | Band      =
 | Nummer    =
 | Jahr      =
 | Seiten    =
 | Stichworte=
}}</nowiki>

;Langversion
<code><nowiki>{{Literatur | Autor= | Herausgeber= | Titel= | TitelErg= | Stichworte = | Sammelwerk= | Band= | Nummer= | Auflage= | Verlag= | Ort= | Jahr= | Monat= | Tag= | Kapitel= | Seiten= | Spalten= | ISBN= | ISBNistFormalFalsch= | ISSN= | LCCN= | Originaltitel= | Originalsprache= | Übersetzer= | Online= | DOI= | arxiv= |PMID= | Zugriff= | Typ= | Kommentar=}}</nowiki></code>

 <nowiki>{{Literatur
 | Autor      =
 | Herausgeber=
 | Titel      =
 | TitelErg   =
 | Stichworte =
 | Originaltitel  =
 | Originalsprache=
 | Übersetzer =
 | Sammelwerk =
 | Band       =
 | Nummer     =
 | Auflage    =
 | Verlag     =
 | Ort        =
 | Jahr       =
 | Monat      =
 | Tag        =
 | Kapitel    =
 | Seiten     =
 | Spalten    =
 | ISBN       =
 | ISBNistFormalFalsch=
 | ISSN       =
 | LCCN       =
 | Kommentar  =
 | Online     =
 | DOI        =
 | arxiv      =
 | Zugriff    =
 | Typ        =
}}</nowiki>

== Parameter ==

Alle Parameter außer dem Titel sind optional und werden über ihren Namen angesprochen. Die Reihenfolge der Parameter ist egal.

{| class="wikitable sortable"
 !Parameter !! Attribut !! Kommentar/Beispiel
 |-
 |Autor || [[Attribut: Autoren|Autoren]] ||Autoren (Vorname Nachname, Vorname Nachname …)
 |-
 |Herausgeber || [[Attribut: Herausgeber|Herausgeber]] ||Herausgeber des Sammelwerkes oder des zitierten Werkes (falls kein Autor angegeben)
 |-
 |Titel || [[Attribut: Titel|Titel]] (Titel + TitelErg) ||Titel des zitierten Werkes
 |-
 |TitelErg || [[Attribut: Titel|Titel]] (Titel + TitelErg) ||Ergänzende Angaben zum Titel (z.&nbsp;B.: ''Mit einer Einleitung von Lieschen Müller'').
 |-
 |Stichworte |
* [[Attribut: Suchstichwort|Suchstichwort]]
* [[Attribut: Stichwort in Kleinschreibung|Stichwort in Kleinschreibung]]
 |Sinnvolle Stichworte Komma-getrennt zum nachschlagen.
 |-
 |Sammelwerk || [[Attribut: Sammelwerk|Sammelwerk]] ||Titel des übergeordneten Werkes: Zeitschrift, Sammelband … (automatisch ergänzt wird „In:“ davor)
 |-
 |Band || [[Attribut: Band|Band]] ||„Bd. 1“ (keine automatische Ergänzung: „Bd.“ ist einzutragen), „Vol. 34“ (Bandnummer, im englischen Sprachraum ''Volume, Vol.''), „Buch 12“
 |-
 |Nummer || [[Attribut: Literaturangabe Nummer|Literaturangabe Nummer]] ||Nummer, <small>auch bekannt als ''Issue'', oder ''Heft''</small>  („Nr.“ wird automatisch ergänzt, nicht eingeben)
 |-
 |Auflage || [[Attribut: Auflage|Auflage]] ||„1.“ (Punkt am Ende nicht vergessen!, „Auflage“ wird automatisch ergänzt, nicht eingeben)
 |-
 |Verlag || [[Attribut: Verlag|Verlag]] ||Ohne automatische Ergänzungen
 |-
 |Ort || [[Attribut: Ort|Ort]] ||Mehrere Verlagsorte werden mit Schrägstrich „/“ getrennt <small>(vgl. [[Wikipedia:Literatur/Formatierungsregeln #Verlag und Ort]])</small>
 |-
 |Jahr || [[Attribut: Jahr|Jahr]] ||
 |-
 |Monat || [[Attribut: Monatsname|Monatsname]] ||Bitte ausschreiben („Januar“, „Februar“, …) <small>nur bei [[Periodikum|Periodika]]</small>
 |-
 |Tag || [[Attribut: Tag|Tag]] ||„1, 2, 3, … 31“ <small>nur bei [[Periodikum|Periodika]]</small>
 |-
 |Kapitel || [[Attribut: Kapitel|Kapitel]] ||z.&nbsp;B. „Kapitel Urgeschichte“, „2.1.7 Sonstiges“ oder „614b“ (im Unterschied zu <code>Seiten</code> und <code>Spalten</code> wird hier nichts ergänzt, und lässt Freiraum für beliebige Gliederungensabschnitte des Werks)
 |-
 |Seiten || [[Attribut: Seiten|Seiten]] ||z.&nbsp;B. „27–34“ (Bis-Strich nicht vergessen!), „13ff.“, „192“ („S.“ wird automatisch ergänzt, nicht eingeben)
 |-
 |Spalten || [[Attribut: Spalten|Spalten]] ||Manche Artikel sind nicht nach Seiten sondern nach Spalten organisiert, dann hier die Spaltenzählung eingeben, z.&nbsp;B. „3–4“ ([[Bis-Strich]] nicht vergessen! – „Sp.“ wird automatisch ergänzt, nicht eingeben)
 |-
 |ISBN || [[Attribut: ISBN|ISBN]] ||ISBN-Nummer (ohne Eingabe des vorangestellten „ISBN“)
 |-
 |ISBNistFormalFalsch || [[Attribut: ISBN ist formal falsch|ISBN ist formal falsch]] ||Wenn das Buch mit einer formal falschen ISBN ausgeliefert wurde, hier „J“ eintragen.
 |-
 |ISSN || [[Attribut: ISSN|ISSN]] ||ISSN-Nummer für Zeitschriften, … (ohne Eingabe des vorangestellten „ISSN“)
 |-
 |Zusammenfassung || [[Attribut: Zusammenfassung|Zusammenfassung]] ||
 |-
 |Kommentar || [[Attribut: Kommentar|Kommentar]] ||z.&nbsp;B. Seitenumfang, Anmerkungen, Empfehlung, PMID. Wird in Klammer hinter dem Werk angeführt, weil auch andere Angaben dort stehen können, und das Trennzeichen ein „;“ ist, allfällig in Kleinbuchstaben beginnen.
 |-
 |arxiv || [[Attribut: arxiv|arxiv]] |||astro-ph/0506600v1 (The Archive, siehe [[Vorlage:ArXiv]])<br />
Die arXiv-Nummer wird dann durch ein Template angezeigt: <nowiki>{{arxiv|astro-ph|0506600}}</nowiki>
 |-
 |DOI || [[Attribut: DOI|DOI]] || 10.1109/MSPEC.2005.1526906 (Document Object Identifier, siehe [[Vorlage:DOI]])<br />
Die DOI-Nummer wird dann so angezeigt: <code>{{DOI|10.1109/MSPEC.2005.1526906}}</code>
 |-
 |LCCN || [[Attribut: LCCN|LCCN]] || /32/14978 (siehe [[Vorlage:LCCN]])<br />
Die LCCN-Nummer wird dann so angezeigt: <code>{{LCCN|/32/14978}}</code>
 |-
 |OCLC || [[Attribut: OCLC|OCLC]] || 227278342. (siehe [[Vorlage:OCLC]])<br />
Die OCLC-Nummer wird dann so angezeigt: <code>{{OCLC|227278342}}</code>
 |-
 |PMID || [[Attribut: PMID|PMID]] || 11341144 (siehe [[PubMed]])<br />
Die PMID-Nummer wird dann so angezeigt: <code>PMID 11341144</code>
 |-
 |Online || [[Attribut: Online|Online]] ||URL (Beispiel: „<code><nowiki>[http://server/file.pdf PDF, 1 MB]</nowiki></code>“)
 |-
 |Zugriff || [[Attribut: Letzter Zugriff|Letzter Zugriff]] ||Nur bei der Angabe von Online-Quellen. Zeitpunkt zu dem die zitierten Informationen gelesen wurden. Das Datum sollte in dem ISO-Format <code>YYYY-MM-TT</code>, das heißt <code>Jahr-Monat-Tag</code> (zum Beispiel <code>1958-06-16</code>), geschrieben werden.
 |-
 |Deutsche Übersetzung || [[Attribut: Deutsche Übersetzung|Deutsche Übersetzung]] || Übersetzung (z.B. eines englischen Literatureintrages) für ''nicht''deutsche Leser (Freitext)
 |-
 |Originalsprache || [[Attribut: Originalsprache|Originalsprache]] ||Code nach RFC 4646 für die Sprache, in der das Original verfasst ist, z.&nbsp;B. „<tt>en</tt>“, „<tt>en-US</tt>“ oder „<tt>ar-Latn-EG</tt>“, siehe auch [[Vorlage:Lang]].
 |-
 |Originaltitel || [[Attribut: Originaltitel|Originaltitel]] ||Der Originaltitel in der Originalsprache
 |-
 |Übersetzer || [[Attribut: Übersetzer|Übersetzer]] ||Der deutsche Übersetzer der entsprechenden Ausgabe
 |-
 |Typ || [[Attribut: Literaturtyp|Literaturtyp]] ||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.
 |-
 |ohne Kategorie || - || irgendein Wert unterbindet die Einbindung in [[:Kategorie: Literatur]] (z.B. Dokumentationszwecke für Vorlage selbst)
 |- 
 | || [[Attribut: Sortierschlüssel|Sortierschlüssel]] || Sortieren der Literaturliste
|}

Wird ein Parameter ohne Namen angegeben (<code><nowiki>{{Literatur|Hans Müller|…}}</nowiki></code>), erscheint statt der Literaturangabe eine Fehlermeldung und der Artikel in einer [[Spezial:Linkliste/Vorlage:Literatur/Parameterfehler|Liste fehlerhafter Verwendungen]].

== Beispiele==

===Unzerlegt oder vereinfachte Quelle===
(Diese Formate sind nicht auf Wikipedia verfügbar!)

<pre>
{{Literatur|Freiform = Max Mustermann 2003: Es ist nicht immer alles perfekt. Wikipedia-Press, Musterstadt}}
</pre>
'''Resultat:''' 
<div style="border:2px inset gray; padding:1ex;">{{Literatur|Freiform = Max Mustermann 2003: Es ist nicht immer alles perfekt. Wikipedia-Press, Musterstadt | ohne Kategorie=ja}}</div>

<pre>
{{Literatur |Autor=Max Mustermann |Jahr=2003 |Titel=Es ist nicht immer alles perfekt.|Quelle=Wikipedia-Press, Musterstadt}}
</pre>
'''Resultat:''' <div style="border:2px inset gray; padding:1ex;">{{Literatur |Autor=Max Mustermann |Jahr=2003 |Titel=Es ist nicht immer alles perfekt.|Quelle=Wikipedia-Press, Musterstadt | ohne Kategorie=ja}}</div>

=== Beitrag in Sammelwerk ===
<pre>
{{Literatur
|Autor       = Max Mustermann
|Titel       = Aspekte modernen Wikipädisierens
|Herausgeber = Bernd Beispiel
|Sammelwerk  = Soziologie der Wikipädianer.
|Verlag      = Wikipedia-Press
|Ort         = Musterstadt
|Jahr        = 2003
|ISBN        = 978-3-9801412-1-5
|Seiten      = 213–278
| Stichworte = Gesellschaft, Wikipedia
}}
</pre>
'''Resultat:'''
<div style="border:2px inset gray; padding:1ex;">{{Literatur
|Autor       = Max Mustermann
|Titel       = Aspekte modernen Wikipädisierens
|Herausgeber = Bernd Beispiel
|Sammelwerk  = Soziologie der Wikipädianer.
|Verlag      = Wikipedia-Press
|Ort         = Musterstadt
|Jahr        = 2003
|ISBN        = 978-3-9801412-1-5
|Seiten      = 213–278
|Stichworte = Gesellschaft, Wikipedia
|ohne Kategorie=ja
}}</div>

=== Artikel in wissenschaftlicher Zeitschrift ===
<pre>
{{Literatur
|Autor      = Max Mustermann
|Titel      = Semantischer Kollaps bei Löschdiskussionen
|Sammelwerk = Journal of Wikipedianism
|Band       = Bd. 2
|Nummer     = 3
|Jahr       = 2006
|Seiten     = 17–67
|Stichworte = Wikipedia, Semantisches Wiki
}}
</pre>
'''Resultat:'''
<div style="border:2px inset gray; padding:1ex;">{{Literatur
|Autor      = Max Mustermann
|Titel      = Semantischer Kollaps bei Löschdiskussionen
|Sammelwerk = Journal of Wikipedianism
|Band       = Bd. 2
|Nummer     = 3
|Jahr       = 2006
|Seiten     = 17–67
|Stichworte = Wikipedia, Semantisches Wiki
|ohne Kategorie=ja
}}</div>

=== Zeitungsartikel ===
<pre>
{{Literatur
|Autor      = Max Mustermann
|Titel      = Wikipedia wohin?
|Sammelwerk = FAZ
|Tag        = 1
|Monat      = Februar
|Jahr       = 2003
|ISSN       = 0174-4909
|Seiten     = 3
|Stichworte = Wikipedia, Gesellschaft
}}
</pre>
'''Resultat:'''
<div style="border:2px inset gray; padding:1ex;">{{Literatur
|Autor      = Max Mustermann
|Titel      = Wikipedia wohin?
|Sammelwerk = FAZ
|Tag        = 1
|Monat      = Februar
|Jahr       = 2003
|ISSN       = 0174-4909
|Seiten     = 3
|Stichworte = Wikipedia, Gesellschaft
|ohne Kategorie=ja
}}</div>


=== Fremdsprachliches Werk ===
<pre>
{{Literatur
|Autor           = John Doe
|Titel           = Einführung in die Trollerei
|Originaltitel   = Introduction to Trolling
|Originalsprache = en-US
|Verlag          = Wikipedia-Press
|Ort             = Musterstadt
|Jahr            = 2003
|ISBN            = 978-3-9801412-1-5
|Stichworte      = Trollerei
}}
</pre>
'''Resultat:''' 
<div style="border:2px inset gray; padding:1ex;">{{Literatur
|Autor=John Doe
|Titel=Einführung in die Trollerei
|Originaltitel=Introduction to Trolling
|Originalsprache=en-US
|Verlag=Wikipedia-Press
|Ort=Musterstadt
|Jahr=2003
|ISBN=978-3-9801412-1-5
|Stichworte = Trollerei
|ohne Kategorie=ja
}}</div>

== Hilfsmittel und Werkzeuge ==
Für das halbautomatische Ausfüllen der Vorlagenfelder stehen derzeit verschiedne Hilfmittel auf dem Toolserver zur Verfügung:
# [http://toolserver.org/~magnus/templator.php?language=de Templator] – Hilfsmittel zum Erstellen von Literaturangaben mit dieser Vorlage. Aktuelle Dokumentation siehe auch unter [[meta:Templator/De]]
# [http://toolserver.org/~holek/cite-gen/ <nowiki>{{Literatur}}-Generator</nowiki>] – füllt die Vorlagenfelder anhand einer ISBN
# [http://norro.de/Wikipedia/ISBN/ ISBN-Suche] – erzeugt eine Literaturangabe anhand der ISBN.

Es gibt auch [http://de.wikipedia.org/w/index.php?title=Spezial%3ALinkliste<!-- -->&hideredirs=1&hidelinks=1&target=Vorlage%3ALiteratur&namespace=10 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 ein  von [[Benutzer:JakobVoss]] bereitgestelltes Scaffold-Skript, siehe [[Benutzer:JakobVoss/Zotero]], kann ein so angelegter Datensatz einfach aus der Zotero-Datenbank in einen Wikipediaartikel eingefügt werden.

== Architektur der Vorlagen ==

 Literatur
 ├ [[Vorlage:Literatur/doc]] –  Doku
 ├ [[Vorlage:Literatur/NamenAlsEtListe]] – Namen in &-Liste umwandeln
 ├ [[Vorlage:Literatur/Namensaufzählung kurz]] – &-Namen als abgekürzte Namen in Referenzliste
 └ [[Vorlage:Literatur/Vorgabe]] – Vorgabe für neue Seite
 + [[Vorlage:Vorhandene Literatur]]
 + [[Vorlage:Literaturverzeichnis]]
 + [[Vorlage:Literaturverzeichnis/Zitat Kommentar]]
 + [[Vorlage:Literaturdaten]]
 + [[Vorlage:Literatur nachschlagen]]
 + [[Vorlage:Formatierte Literaturausgabe]]
 + [[Vorlage:Formatierte Literaturausgabe für ask]]
 + [[Vorlage:Bildwegweiser]]
 + [[Vorlage:BrowseByAskQueryPreviousNext]]
 + [[Vorlage:DOI]]
 + [[Vorlage:Datum]]
 + [[Vorlage:Falsche ISBN]]
 + [[Vorlage:FormatDate]]
 + [[Vorlage:Hidden]]
 + [[Vorlage:ISSN]]
 + [[Vorlage:LCCN]]
 + [[Vorlage:Logo]]
 + [[Vorlage:OCLC]]
 + [[Vorlage:Zitat]]
 + [[Vorlage:arxiv]]
 + [[Vorlage:lang]]
 + [[Vorlage:force last punctuation]]
 + [[Vorlage:remove last punctuation]]

Verschachtelte Verwendung:
 [[Vorlage: Literatur]]
 └ [[Vorlage: Formatierte Literaturausgabe]]

Verschachtelte Verwendung (mittels ask-Abfragen):
 [[Vorlage: Literaturverzeichnis]]
 [[Vorlage: Literaturdaten]]
 └ [[Vorlage: Formatierte Literaturausgabe für ask]]

== Attribute ==

* [[Attribut: arxiv]]
* [[Attribut: Auflage]]
* [[Attribut: Autoren]]
* [[Attribut: Band]]
* [[Attribut: DOI]]
* [[Attribut: Herausgeber]]
* [[Attribut: Hat Literaturverzeichnis]]
* [[Attribut: ISBN ist formal falsch]]
* [[Attribut: ISBN]]
* [[Attribut: ISSN]]
* [[Attribut: Jahr]]
* [[Attribut: Kapitel]]
* [[Attribut: Kommentar]]
* [[Attribut: LCCN]]
* [[Attribut: Letzter Zugriff]]
* [[Attribut: Literaturangabe Nummer]]
* [[Attribut: Literaturtyp]]
* [[Attribut: Monatsname]]
* [[Attribut: OCLC]]
* [[Attribut: Online]]
* [[Attribut: Originalsprache]]
* [[Attribut: Originaltitel]]
* [[Attribut: Ort]]
* [[Attribut: PMID]]
* [[Attribut: Sammelwerk]]
* [[Attribut: Seiten]]
* [[Attribut: Spalten]]
* [[Attribut: Suchtichwort]]
* [[Attribut: Stichwort in Kleinschreibung]]
** [[Attribut: Stichwort auf Seite]] (internes Seiten-Objekt für Einzelstichwortabfragen)
* [[Attribut: Tag]]
* [[Attribut: Titel]]
* [[Attribut: Übersetzer]]
* [[Attribut: Verlag]]
* [[Attribut: Zusammenfassung]]