テンプレート:AllMusic/docのソースを表示

{{Documentation subpage|種類=[[Help:テンプレート|テンプレート]]}}
{{使用箇所の多いテンプレート|1,100以上}}
{{Uses Wikidata|P1728|P1729|P1730|P1994}}
{{Tracks Wikidata|P1728|P1729|P1730|P1994}}
{{Lua|Module:EditAtWikidata}}
[[オールミュージック]]にある項目へのリンクを用意にするテンプレートです。外部リンク節に追加したり出典として使用することが可能です。

== 使用法 ==

=== パラメータ名不使用 ===
3つのパラメータのみの以下の構成だけで有効:
<pre>{{AllMusic|<分類>|<id>|<タイトル>}}</pre>

=== パラメータ名使用 ===
<pre>{{AllMusic |class= |id= |tab= |title= |last= |first= |author= |accessdate= }}</pre>

<pre>
{{AllMusic
| class      = 
| id         = 
| tab        = 
| title      = 
| first      = 
| last       = 
| author     =
| accessdate = 
}}
</pre>

=== ウィキデータ使用 ===
{{tlcw|{{BASEPAGENAME}} }}

{{tlcw|{{BASEPAGENAME}} | title{{=}} <var>表示されるリンク名</var> }}

== 使用例 ==

=== グループ含むアーティスト (分類を指定しなかった場合規定値としてartistになる) ===

フルID:
* 入力:  <code><nowiki>{{AllMusic | id= led-zeppelin-mn0000139026 | title= レッド・ツェッペリン}}</nowiki></code>
* 表示: {{AllMusic | id= led-zeppelin-mn0000139026 | title= レッド・ツェッペリン}}
* URL:    {{AllMusic | id= led-zeppelin-mn0000139026 | pure_url= yes}}

短縮ID:
* 入力:  <code><nowiki>{{AllMusic | id= mn0000139026 | title= レッド・ツェッペリン}}</nowiki></code>
* 表示: {{AllMusic | id= mn0000139026 | title= レッド・ツェッペリン}}
* URL:    {{AllMusic | id= mn0000139026 | pure_url= yes}}

=== アルバム (分類を指定しなかった場合規定値としてalbumになる) ===

フルID:
* 入力:  <code><nowiki>{{AllMusic | id= news-of-the-world-mw0000191493 | title= ''News of the World'' | accessdate= March 30, 2014}}</nowiki></code>
* 表示: {{AllMusic | id= news-of-the-world-mw0000191493 | title= ''News of the World'' | accessdate= March 30, 2014}}
* URL:    {{AllMusic | id= news-of-the-world-mw0000191493 | pure_url= yes}}

短縮ID:
* 入力:  <code><nowiki>{{AllMusic | id= mw0000191493 | title= ''News of the World'' | accessdate= March 30, 2014}}</nowiki></code>
* 表示: {{AllMusic | id= mw0000191493 | title= ''News of the World'' | accessdate= March 30, 2014}}
* URL:    {{AllMusic | id= mw0000191493 | pure_url= yes}}

=== 曲 (分類を指定しなかった場合規定値としてsongになる) ===

フルID:
* 入力:  <code><nowiki>{{AllMusic | id= dust-in-the-wind-mt0013834783 | title= "Dust in the Wind"}}</nowiki></code>
* 表示: {{AllMusic | id= dust-in-the-wind-mt0013834783 | title= "Dust in the Wind"}}
* URL:    {{AllMusic | id= dust-in-the-wind-mt0013834783 | pure_url= yes}}

短縮ID:
* 入力:  <code><nowiki>{{AllMusic | id= mt0013834783 | title= "Dust in the Wind"}}</nowiki></code>
* 表示: {{AllMusic | id= mt0013834783 | title= "Dust in the Wind"}}
* URL:    {{AllMusic | id= mt0013834783 | pure_url= yes}}

=== 作曲 (分類を指定しなかった場合規定値としてcompositionになる) ===

フルID:
* 入力:  <code><nowiki>{{AllMusic | id= clarinet-concerto-mc0002356981 | title= Clarinet Concerto (Copland) }}</nowiki></code>
* 表示: {{AllMusic | id= clarinet-concerto-mc0002356981 | title= Clarinet Concerto (Copland) }}
* URL:    {{AllMusic | id= clarinet-concerto-mc0002356981 | pure_url= yes }}

短縮ID:
* 入力:  <code><nowiki>{{AllMusic | id= mc0002356981 | title= Clarinet Concerto (Copland) }}</nowiki></code>
* 表示: {{AllMusic | id= mc0002356981 | title= Clarinet Concerto (Copland) }}
* URL:    {{AllMusic | id= mc0002356981 | pure_url= yes }}

=== tabパラメータ使用 ===

フルID:
* 入力:  <code><nowiki>{{AllMusic | id= led-zeppelin-mn0000139026 | tab= discography | title= レッド・ツェッペリンのディスコグラフィー}}</nowiki></code>
* 表示: {{AllMusic | id= led-zeppelin-mn0000139026 | tab= discography | title= レッド・ツェッペリンのディスコグラフィー}}
* URL:    {{AllMusic | id= led-zeppelin-mn0000139026 | tab= discography | pure_url= yes}}

短縮ID:
* 入力:  <code><nowiki>{{AllMusic | id= mn0000139026 | tab= discography | title= レッド・ツェッペリンのディスコグラフィー}}</nowiki></code>
* 表示: {{AllMusic | id= mn0000139026 | tab= discography | title= レッド・ツェッペリンのディスコグラフィー}}
* URL:    {{AllMusic | id= mn0000139026 | tab= discography | pure_url= yes}}

=== URLにあるタブをidパラメータで指定 ===

フルID:
* 入力:  <code><nowiki>{{AllMusic | id= led-zeppelin-mn0000139026/discography | title= レッド・ツェッペリンのディスコグラフィー}}</nowiki></code>
* 表示: {{AllMusic | id= led-zeppelin-mn0000139026/discography | title= レッド・ツェッペリンのディスコグラフィー}}
* URL:    {{AllMusic | id= led-zeppelin-mn0000139026/discography | pure_url= yes}}

短縮ID:
* 入力:  <code><nowiki>{{AllMusic | id= mn0000139026/discography | title= レッド・ツェッペリンのディスコグラフィー}}</nowiki></code>
* 表示: {{AllMusic | id= mn0000139026/discography | title= レッド・ツェッペリンのディスコグラフィー}}
* URL:    {{AllMusic | id= mn0000139026/discography | pure_url= yes}}

=== ページ著者名、閲覧日 ===

フルID:
* 入力:  <code><nowiki>{{AllMusic | class= album | id= physical-graffiti-mw0000190771 | title= Review of ''Physical Graffiti'' | first= Stephen Thomas | last= Erlewine | accessdate= March 30, 2014}}</nowiki></code>
* 表示: {{AllMusic | class= album | id= physical-graffiti-mw0000190771 | title= Review of ''Physical Graffiti'' | first= Stephen Thomas | last= Erlewine | accessdate= March 30, 2014}}
* URL:    {{AllMusic | class= album | id= physical-graffiti-mw0000190771 | pure_url= yes}}

短縮ID:
* 入力:   <code><nowiki>{{AllMusic | class= album | id= mw0000190771 | title= Review of ''Physical Graffiti'' | first= Stephen Thomas | last= Erlewine | accessdate= March 30, 2014}}</nowiki></code>
* 表示: {{AllMusic | class= album | id= mw0000190771 | title= Review of ''Physical Graffiti'' | first= Stephen Thomas | last= Erlewine | accessdate= March 30, 2014}}
* URL:    {{AllMusic | class= album | id= mw0000190771 | pure_url= yes}}

=== 出典テンプレートで''pure_url''を使用 ===

* 入力: <code><nowiki>{{cite web | url = {{AllMusic|album|mw0000190771|pure_url=yes}} | title = Review of ''Physical Graffiti'' | work = [[オールミュージック|AllMusic]] | publisher = [[All Media Network]] | first = Stephen Thomas | last = Erlewine | accessdate = March 30, 2014}}</nowiki></code>
* 表示: {{cite web | url = {{AllMusic|album|mw0000190771|pure_url=yes}} | title = Review of ''Physical Graffiti'' | work = [[オールミュージック|AllMusic]] | publisher = [[All Media Network]] | first = Stephen Thomas | last = Erlewine | accessdate = March 30, 2014}}
* URL:    {{AllMusic|album|mw0000190771|pure_url=yes}}

=== テンプレートにもウィキデータにもIDを入力せず''pure_url''も不使用 ===

* 入力: {{tlcw|{{BASEPAGENAME}} }}
* 表示: {{{{BASEPAGENAME}} }}

== TemplateData ==
{{TemplateDataHeader}}
<templatedata>
{
    "description": "オールミュージックの項目への外部リンクを生成するテンプレート",
    "params": {
     "class": {
            "label": "オールミュージックの分類",
            "aliases": ["1"],
            "type": "string",
            "default": "artist",
            "description": "情報の分類。URLにおける www.allmusic.com/ の次の部分を指定。例としてartist、album、song、compositionがある。もし指定しなかった場合、\"id\"でmn=artist、mw=album、mt=song、mc=compositionというふうに判断。"
        },
        "id": {
            "label": "オールミュージックID",
            "aliases": ["2"],
            "type": "string",
            "required": true,
            "description": "オールミュージックの識別子の番号や文字列。URLにおける artist/、album/、song/、composition/ の次の部分を指定。実際のIDの前に付いているアーティスト、アルバムなどの名前の部分は省略できる。例としてURLが www.allmusic.com/artist/led-zeppelin-mn0000139026 の場合、\"led-zeppelin-mn0000139026\" もしくは \"mn0000139026\"が該当する。また\"release/stone-temple-pilots-deluxe-edition-mr0002917004\"というようにURLの最後まで指定することができる。"
        },
        "title": {
            "label": "表示テキスト",
            "aliases": ["label", "3"],
            "type": "string",
            "description": "表示されるリンクテキスト。指定しなかった場合テンプレートを使用した記事の名前が表示される。"
        },
        "tab": {
            "label": "オールミュージックのタブ",
            "type": "string",
            "description": "オールミュージックにある特定のタブに直接リンクしたい場合このパラメータで使用。指定するのはIDの後ろにあるURL末尾のスラッシュ('/')の後の部分。例として(引用符除く)\"biography\"、\"discography\"、\"songs\"、\"awards\"など。もしタブのサブタブを指定したい場合は「\"songs/all\"」のように末尾部分全てを指定する必要がある。"
        },
        "first": {
            "label": "ページ執筆者のファーストネーム",
            "type": "string",
            "description": "ページ執筆者のファーストネームや名"
        },
        "last": {
            "label": "ページ執筆者のラストネーム",
            "type": "string",
            "description": "ページ執筆者のラストネームや姓"
        },
        "author": {
            "label": "ページ執筆者のフルネーム",
            "type": "string",
            "description": "ページ執筆者のフルネーム。 |last= を使用した場合は使用してはいけない。"
        },
        "accessdate": {
            "label": "閲覧日",
            "type": "string",
            "description": "閲覧した日付を年月日で記述。内部リンクしてはいけない。"
        },
        "pure_url": {
            "label": "URLのみ表示",
            "type": "string",
            "description": "\"yes\"としていしたら、URLのみを表示する。通常出典テンプレートで使用する。"
        }
    }
}
</templatedata>

== 追跡カテゴリ ==
* {{clc|ウィキデータに無ければIDも指定していないAllMusicテンプレート}}

== 関連項目 ==
* {{tl|AllMovie title}}
* {{tl|AllMovie name}}
* {{tl|Allgame}}
<includeonly>{{Sandbox other||
[[Category:音楽の外部リンク用テンプレート]]
[[Category:音楽の出典テンプレート]]
[[Category:人物の外部リンク用テンプレート]]
[[Category:ウィキデータを使用している外部リンク用テンプレート]]
[[Category:追跡カテゴリを追加するテンプレート]]
}}</includeonly>