„Vorlage:Allmusic/Doku“ – Versionsunterschied

[gesichtete Version][gesichtete Version]
Inhalt gelöscht Inhalt hinzugefügt
K http → https
+ TemplateData und das Format der Kopiervorlage sollte zu den Beispielen passen
Zeile 1:
<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
{{TemplateData|JSON=
{ "description": "Die Vorlage dient der Erzeugung von Weblinks zur Seite von allmusic ([https://www.allmusic.com/ allmusic.com]).",
"params": {
"Rubrik":
{ "label": "Rubrik",
"description": "Teil der [[Uniform Resource Locator|URL]] <code>www.allmusic.com/<mark>album</mark>/…</code><noexport> Siehe [[#Rubrik|mögliche Werte]]</noexport>",
"example": "album",
"default": "artist",
"type": "url",
"suggested": true },
"ID":
{ "label": "ID",
"description": "Teil der [[Uniform Resource Locator|URL]] <code>www.allmusic.com/album/<mark>mw0000191493</mark></code>",
"example": "mw0000191493",
"type": "url",
"required": true },
"Abruf":
{ "label": "Abrufdatum",
"aliases": [ "Download" ],
"description": "Tagesdatum zur Dokumentation, wann der Weblink abgerufen wurde, mögilchst im ISO-Format <code>JJJJ-MM-TT</code>.",
"example": "2010-02-10",
"type": "date",
"suggested": true },
"Linktext":
{ "label": "",
"description": "Linktext für den generierten Weblink. Wird kein Linktext angegeben, wird der Seitenname verwendet.",
"type": "line",
"required": false },
"NurURL":
{ "label": "",
"description": "Der Parameter bewirkt, dass ein „unformatierter“ Weblink ohne Linktext erzeugt wird.<noexport> [[#NurURL|Zusatzinfo]]</noexport>",
"type": "boolean",
"required": false },
"1":
{ "label": "1",
"description": "veralteter Parameter bitte <code>Rubrik</code> verwenden.",
"deprecated": true },
"2":
{ "label": "2",
"description": "veralteter Parameter bitte <code>ID</code> verwenden.",
"deprecated": true },
"3":
{ "label": "3",
"description": "veralteter Parameter bitte <code>Linktext</code> verwenden.",
"deprecated": true }
},
"format": "inline half"
}
|TOC=1}}
 
== VerwendungZusatzinformation ==
; {{Anker |Rubrik}}[[#templatedata:Rubrik |Rubrik]]
Die Vorlage dient der Erzeugung von Weblinks zur Seite von allmusic ([https://www.allmusic.com/ www.allmusic.com]).
: Die Rubrik zur abgerufenen Information. Möglich sind beispielsweise Informationen über
: Künstler/Gruppen (“artist”) = Standardwert
: Alben (“album”)
: einzelne Lieder (“song”)
: klassische Werke (“composition”)
: übergreifende Themen (“style”, “genre”, “mood”, “theme”).
 
; {{Anker|NurURL}}[[#templatedata:NurURL|NurURL]]
: Es wird nur eine unformatierte Webadresse ohne Linktext Begleittext erzeugt. Dies ist nur für die automatisierte Umstellung direkter Weblinks auf Vorlagenverwendung gedacht, kann aber auch bei Verwendung der Vorlage innerhalb anderer Vorlagen verwendet werden, z.B. bei Einbettung innerhalb der [[Vorlage:Internetquelle]]. Siehe auch [[#unformatiert|Beispiel]].
 
== Kopiervorlage ==
<pre style="white-space:pre-wrap;">
{{Allmusic |Rubrik= |ID= |Linktext= |Abruf=}}
|Rubrik=
|ID=
|Linktext=
|Download=
}}
</pre>
<div style="clear:both;"></div>
 
== Parameter ==
 
{| class="wikitable sortable"
|-
! Parameter
! class="unsortable" style="width:130px"| Typ
! class="unsortable"|Erklärung
|-
| '''Rubrik'''
| optional
| Die Rubrik zur abgerufenen Information. Möglich sind beispielsweise Informationen über Künstler/Gruppen (“artist”), über Alben (“album”), über einzelne Lieder (“song”), klassische Werke (“composition”) oder übergreifende Themen (“style”, “genre”, “mood”, “theme”). Die anzugebende Rubrik entspricht dem hinter <code>www.allmusic.com/</code> folgenden Teil der [[URL]]. Standardwert, wenn nicht angegeben, ist “artist”.
|-
| '''ID'''
| '''notwendig'''
| Identifikation der Information. Dies entspricht dem auf die Rubrik (z.B. “artist/”, “album/” oder “song/”) folgenden Teil der URL. Die Information zum Künstler, Album etc. zu Beginn dieses Teils der URL kann wegelassen werden (Beispiel: Bei [https://www.allmusic.com/artist/led-zeppelin-mn0000139026 www.allmusic.com/artist/led-zeppelin-mn0000139026] ist <code>mn0000139026</code> als ID ausreichend). In manchen Fällen folgt nach der Rubrik noch ein weiterer klassifizierende Teil vor der eigentlichen ID. (z.B. bei Editionen von Alben, “album/release”, siehe Beispiel unten). Dieser weitere klassifizierende Teil sollte der ID vorangestellt werden. Wenn direkt auf eine über Register erreichbare Unterseite verlinkt werden soll (z.B. “awards”) ist dies möglich (auch mehrstufig). Hierzu ist der gesamte Suffix der URL an die ID anzuhängen (z.B. <code>mn0000139026/songs/all</code>).
 
|-
| '''Linktext'''
| optional
| Linktext für den generierten Weblink. Wird kein Linktext angegeben, wird der Seitenname verwendet.
|-
| '''NurURL'''
| optional
| Die Angabe von <code>ja</code> bewirkt, dass kein Linktext und kein folgender Text sondern der „nackte“ Weblink erzeugt wird. Dies ist eigentlich nur für die automatisierte Umstellung direkter Weblinks auf Vorlagenverwendung gedacht, kann aber auch bei Verwendung der Vorlage innerhalb anderer Vorlagen verwendet werden, z.B. bei Einbettung innerhalb der [[Vorlage:Internetquelle]].
|-
| '''Download'''
| optional, Datum
| Tagesdatum zur Dokumentation, wann der Weblink abgerufen wurde. Sollte in Langform mit ausgeschriebenem Monatsnamen verwendet werden (z.&nbsp;B. 14. Januar 2010)
|-
|}
 
Es ist auch eine Kurzschreibweise mit Angabe der ersten zwei oder drei Parameter als Stellungsparameter (ohne Parameternamen) möglich.
 
== Beispiele ==
 
'''Gruppe oder Künstler'''
* <code><nowiki>{{</nowiki>Allmusic |ID=mn0000139026 |Linktext=Led Zeppelin<nowiki>}}</nowiki></code>
 
führt zu
* {{Allmusic |ID=mn0000139026 |Linktext=Led Zeppelin |Rubrik=artist}}
 
 
'''Album''' (mit Angabe von Download)
* <code><nowiki>{{</nowiki>Allmusic |Rubrik=album |ID=mw0000191493 |Linktext=News of the World |DownloadAbruf=10. Februar 2010-02-10<nowiki>}}</nowiki></code>
 
führt zu
* {{Allmusic |Rubrik=album |ID=mw0000191493 |Linktext=News of the World |DownloadAbruf=10. Februar 2010-02-10}}
 
 
'''Song''' (Kurzschreibweise)
* <code><nowiki>{{</nowiki>Allmusic|song|mt0010540312|Dust in the Wind<nowiki>}}</nowiki></code>
 
führt zu
* {{Allmusic|song|mt0010540312|Dust in the Wind}}
Zeile 72 ⟶ 87:
 
'''Album Release'''
* <code><nowiki>{{</nowiki>Allmusic |Rubrik=album |ID=release/mr0003410455 |Linktext=Dark Side of the Moon, Immerson edition<nowiki>}}</nowiki></code>
führt zu
* {{Allmusic |Rubrik=album |ID=release/mr0003410455 |Linktext=Dark Side of the Moon, Immerson Edition}}
 
 
{{Anker|unformatiert}}'''URL unformatiert ausgeben'''
* <code><nowiki>{{</nowiki>Allmusic |ID=mn0000139026 |Linktext=Led Zeppelin |NurURL=1<nowiki>}}</nowiki></code>
führt zu
* {{Allmusic|Rubrik=album |ID=release/mr0003410455mn0000139026 |Linktext=DarkLed SideZeppelin of|Rubrik=artist the Moon, Immerson Edition|NurURL=1}}
 
''In [[Vorlage:Internetquelle]] eingebettet''<br />Das ist nur ein Beispiel, es sollte auf derartige Vorlagenverschachtelungen verzichtet werden
<pre>
{{Internetquelle |titel=Led Zeppelin |url={{Allmusic |ID=mn0000139026 |NurURL=1}} |abruf=2011-02-03}}
</pre>
führt zu
* {{Internetquelle |titel=Led Zeppelin |url={{Allmusic |ID=mn0000139026 |NurURL=1}} |abruf=2011-02-03}}
 
== Wartung ==
Artikel, bei denen die Pflichtangabe [[#templatedata:ID|ID]] fehlt, sind in der [[Vorlage:Allmusic/Wartung]] aufgelistet.
 
<includeonly>
{{Lua-Vorlage|WLink #getArticleBase |TemplUtl #faculty}}
[[Kategorie:Vorlage:Datenbanklink Musik|{{PAGENAME}}]]
</includeonly>