Quelltext der Seite Vorlage:DOI/Doku

<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
{{TemplateData|JSON=
{ "description": "Mittels [[w:Digital Object Identifier|Digital Object Identifier]] (DOI) auf ein digitales Objekt verweisen.",
  "params": { "1": { "label": "DOI",
                     "description": "Digital Object Identifier. Folgende Zeichen müssen ersetzt werden: “<code>{</code>” → <code>&amp;#123;</code>, “<code>}</code>” → <code>&amp;#125;</code> und “{{!}}” → <code>&amp;#124;</code> (siehe [[w:Hilfe:Sonderzeichen]])",
                     "type": "line",
                     "required": true,
                     "example":  "10.1000/182" },
             "Problem": {
                     "label": "Problem",
                     "description": "Jahreszahl (Monat); wann zuletzt festgestellt wurde, dass das Dokument im Internet nicht richtig zugeordnet wurde<noexport>.<br /> Dies ist voraussichtlich ein vorübergehendes Problem, weil entweder der Anbieter die [[Uniform Resource Locator|URL]] geändert hat, ohne eine Weiterleitung anzulegen, und die Einträge in der Datenbank des Solvers noch nicht aktualisiert wurden, oder weil schlicht ein Eintrag falsch ist und noch nicht korrigiert wurde.<br /> Der DOI gilt trotzdem, auch wenn momentan das Dokument nicht abgerufen werden kann; vorausgesetzt natürlich, er enthält keinen Schreibfehler.<br /> Alternativ könnte genauer mit ''JJJJ-MM'' spezifiziert werden.</noexport>",
                     "type":     "date",
                     "required": false,
                     "example":  "2019-07" },
             "NoCat": {
                     "label": "Keine Kategorie",
                     "description": "Nicht in Wartungskategorie einordnen.",
                     "type":      "boolean",
                     "suggested": false,
                     "default":  "0",
                     "example":  "1" }
  },
  "format": "inline"
}
|TOC=1}}

== Kopiervorlagen ==
<code><nowiki>[[doi:]]</nowiki></code><br />
<code><nowiki>{{DOI|}}</nowiki></code><br />
<code>{&#123;DOI||Problem={{CURRENTYEAR}}}}</code>

== Beispiele ==

{| class="wikitable"
! Quelltext
! Ergebnis
|-
| <code><nowiki>[[doi:10.1000/182]]</nowiki></code>
| [[doi:10.1000/182]]
|-
| <code><nowiki>{{DOI|10.1002/(SICI)1096-9063(199911)55:11<1043::AID-PS60>3.0.CO;2-L}}</nowiki></code>
| {{DOI|10.1002/(SICI)1096-9063(199911)55:11<1043::AID-PS60>3.0.CO;2-L}}
|-
| <code>{&#123;DOI&#124;10.1000/182&#124;Problem={{#time:Y|5 years}}}}</code>
| {{DOI|10.1000/182|Problem={{#time:Y|5 years}}}}
|-
| <code><nowiki>{{DOI|10.1000/182}}</nowiki></code>
| {{DOI|10.1000/182|demo=1}}
|}

== Verlinkung ==
Im Normalfall kann der [[w:Digital Object Identifier|DOI]] direkt (und etwas effizienter) verlinkt werden, da die MediaWiki-Software <code><nowiki>[[w:doi:10.1000/182]]</nowiki></code> automatisch in [[doi:10.1000/182]] umwandelt. Dies funktioniert jedoch in den Fällen nicht, in denen der DOI bestimmte Sonderzeichen wie <code>&lt;</code> und <code>></code> oder <code>[</code> und <code>]</code> enthält. In diesen Fällen muss diese Vorlage verwendet werden. Außerdem können Zugriffsprobleme verwaltet werden.

Ein Vorteil der Vorlage ist, dass für mit DOI nicht vertraute Leser der enthaltene Link auf [[w:Digital Object Identifier|Digital Object Identifier]] hilfreich ist.

== Wartung ==
* {{Vorlagenfehler-Wartungskat |Vorlage=Parameter:DOI |Text=Seiten mit formal falschem DOI (oder ungültigen Parameterangaben) werden aufgelistet in der |ignoriere=}}
** Das geschieht nur, sofern sie zu folgenden Namensräumen gehören: Artikel, Wikipedia (Recherche-Anfragen, Literaturlisten), Vorlage ([[Vorlage:BibDOI|BibDOI]] usw.), Portale (Literaturlisten).
* Für Seiten mit einem <code>Problem</code> gibt es keine dauerhafte Wartungskategorie. In der Vorlagenprogrammierung kann bedarfsweise eine Einordnung für alle Seiten mit Problem oder nur für solche mit einer bestimmten Jahreszahl vorgenommen werden; die Kategoriebeschreibungsseite muss dazu nicht existieren.
* Alternativ können mit verschiedenen Werkzeugen (auch Cirrus) die entsprechenden Seiten ausgewertet werden.
* Fehlermeldungen werden zurzeit nur Benutzern mit Sichterrechten oder aber während des Bearbeitens in der Vorschau gezeigt.

== Vorlagenprogrammierung ==
Abweichend von der oben beschriebenen Einbindung direkt in Artikel gibt es für die Programmierung etwa von Zitationsvorlagen oder auch Infoboxen folgende Abweichungen:
* Der Parameter '''1''' darf ein vorangegangenes Resultat dieser Vorlagenexpansion sein; also den bereits verlinkten DOI oder eine Fehlermeldung enthalten.
* Der Parameter '''1''' darf auch leer sein.
* Die Parameter '''Problem''' und '''NoCat''' werden hier kaum sinnvoll benutzt werden können.
* Der Parameter '''demo''' bewirkt auf Dokumentationsseiten wie dieser, dass das Ausblenden von Fehlermeldungen deaktiviert wird.

== Siehe auch ==
* [[Vorlage:BibDOI]]
* [[Vorlage:HDL]]
<includeonly>
{{Lua-Vorlage|Vorlage:Handle #f}}

[[Kategorie:Vorlage:Datenbanklink]]
[[Kategorie:Vorlage:Zitation/Codes]]
</includeonly>