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

<noinclude>{{Documentation subpage|種類=[[Help:テンプレート|テンプレート]]}}</noinclude>
{{Lua|Module:Listen}}
オーディオファイルにリンクするためのテンプレートです。ウィキペディア日本語版や[[ウィキメディア・コモンズ]]に置かれているファイルをリンクすることができます。

== 使い方 ==

=== 基本的な使用法 ===
<pre style="overflow: auto">
{{試聴
 |filename     = 
 |title        = 
 |description  = 
}}
</pre>

*'''filename''' (必須) &ndash; 音声・映像のファイル名。冒頭の「ファイル:（File: Image: 画像:）」は不要です。
*'''title''' （必須） &ndash; 曲名などのリンクしたファイルに対応する題名。ファイルの詳細ページにリンクされるので内部リンク(<nowiki>[[記事名]]</nowiki>)を記述すると正しく表示されなくなります。内部リンクは<code>description</code>か<code>header</code>の方で記述してください。
*'''description''' &ndash; ファイルの説明文。

=== 複数のファイルをリンクする場合 ===
一つのテンプレートに最大12個までのファイルをリンクすることができます。

<pre style="overflow: auto">
{{試聴
 |filename     = 
 |title        = 
 |description  = 
 |filename2    = 
 |title2       = 
 |description2 = 
 |filename3    = 
 |title3       = 
 |description3 = 
}}
</pre>

*'''filename''' (必須) &ndash; 音声・映像のファイル名。冒頭の「ファイル:（File: Image: 画像:）」は不要です。
*'''title''' （必須） &ndash; 曲名などのリンクしたファイルに対応する題名。ファイルの詳細ページにリンクされるので内部リンク(<nowiki>[[記事名]]</nowiki>)を記述すると正しく表示されなくなります。内部リンクは<code>description</code>か<code>header</code>の方で記述してください。
*'''description''' &ndash; ファイルの説明文。

=== Styleパラメータ ===
このテンプレートでは以下のパラメータで:

*'''type''' &ndash; テンプレートの左側に表示されるアイコンを変えることができます。'''sound'''や'''music'''（デフォルト）が指定できます。 
*'''header''' &ndash; テンプレートの最上部に表示する文章を記述できます。
*'''help''' &ndash; {{para|help|no}}と指定すると「サウンド再生のヒント」へのリンクが無効になります。
*'''pos''' &ndash; デフォルトでは右側にテンプレートが表示されますが、<code>left</code>を指定すると左側に表示されます。
*'''image''' &ndash; 任意の画像を指定します。{{nowrap|{{para|image|<nowiki>[[File:Example.jpg|20px]]</nowiki>}}}}のように記述します。{{para|image|none}}と設定した場合は画像は表示されません。
*'''style''' &ndash; CSSの属性を指定できます。 
*'''play#''' &ndash; {{para|play|no}}と指定すると再生ボタンが表示されなくなり、ファイルのリンクのみが表示されます。ファイルごとに指定できます。
*'''plain''' &ndash; {{para|plain|yes}}と指定するとテンプレートの右側表示、罫線、画像、「サウンド再生のヒント」へのリンクが無効になります。

== 使用例 ==
;基本的な使用例

{{試聴
 |filename     = Accordion chords-01.ogg
 |title        = Accordion chords
 |description  = Chords being played on an accordion
}}
<pre style="overflow: auto">
{{試聴
 |filename     = Accordion chords-01.ogg
 |title        = Accordion chords
 |description  = Chords being played on an accordion
}}</pre>

;映像ファイルをリンクした例

{{試聴
 |header=バラク・オバマの就任演説
 |filename=Barack Obama inaugural address.ogv
 |title=就任演説（映像）
 |description=[[バラク・オバマ]]が2009年1月20日に行った就任演説（21分21秒）。
 |help=yes
 |type=sound
}}<pre style="overflow:auto;">
{{試聴
 |header=バラク・オバマの就任演説
 |filename=Barack Obama inaugural address.ogv
 |title=就任演説（映像）
 |description=[[バラク・オバマ]]が2009年1月20日に行った就任演説（21分21秒）。
 |help=yes
 |type=sound
}}</pre>

{{-}}

;ヘッダのテキストを記述した使用例:
{{試聴
 |filename     = Frase de Neil Armstrong.ogg
 |title        = "One small step for a man..."
 |description  = First words spoken on the [[月|moon]].
 |type         = speech
 |pos          = left
 |header       = Recordings of this phrase:
}}
<pre style="overflow: auto">
{{試聴
 |filename     = Frase de Neil Armstrong.ogg
 |title        = "One small step for a man..."
 |description  = First words spoken on the [[moon]].
 |type         = speech
 |pos          = left
 |header       = Recordings of this phrase:
}}
</pre>

;{{Para|plain|yes}}を指定した使用例:

{{試聴
 |filename = Accordion chords-01.ogg
 |title    = Accordion chords
 |plain    = yes
 |style    = float:left
}}

<pre style="overflow: auto">
{{試聴
 |filename = Accordion chords-01.ogg
 |title    = Accordion chords
 |plain    = yes
 |style    = float:left
}}
</pre>


;複数のファイルをリンクした例

{{試聴
 |filename     = Accordion chords-01.ogg
 |title        = Accordion chords
 |description  = Chords being played on an accordion
 |filename2    = Moonlight.ogg
 |title2       = ''Moonlight Sonata''
 |description2 = [[Beethoven]]'s Sonata in C# minor
 |filename3    = Au_clair_de_la_lune_mode_do.mid
 |title3       = Au Clair de la Lune
 |description3 = The traditional French children's song
 |play3        = no
}}
<pre style="overflow: auto">
{{試聴
 |filename     = Accordion chords-01.ogg
 |title        = Accordion chords
 |description  = Chords being played on an accordion
 |filename2    = Moonlight.ogg
 |title2       = ''Moonlight Sonata''
 |description2 = [[ルートヴィヒ・ヴァン・ベートーヴェン|Beethoven]]'s Sonata in C# minor
 |filename3    = Au_clair_de_la_lune_mode_do.mid
 |title3       = Au Clair de la Lune
 |description3 = The traditional French children's song
 |play3        = no
}}
</pre>

== 関連項目 ==
* {{tl|Audio}} - 音声ファイルをインラインでリンクするテンプレート。
* {{tl|Multi-listen start}}、{{tl|Multi-listen item}}、{{tl|Multi-listen end}} - 複数の音声ファイルをリスト形式で並べるテンプレート。
* [[Help:音声・動画の再生]]
<includeonly>
<!-- カテゴリと言語間リンクは以下に追加してください -->
{{DEFAULTSORT:しちよう}}
[[Category:音声関連のテンプレート]]

[[mwl:Modelo:Oube]]
[[nl:Sjabloon:Luister]]
</includeonly>