Template:試聴/doc

オーディオファイルにリンクするためのテンプレートです。ウィキペディア日本語版やウィキメディア・コモンズに置かれているファイルをリンクすることができます。

これはTemplate:試聴の解説サブページです。 使用方法、カテゴリ、およびその他テンプレート自体に含まれない情報を収容しています。

Luaモジュールを使用しています: Module:Listen

使い方

基本的な使用法

{{試聴
 |filename     = 
 |title        = 
 |description  = 
}}

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

複数のファイルをリンクする場合

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

{{試聴
 |filename     = 
 |title        = 
 |description  = 
 |filename2    = 
 |title2       = 
 |description2 = 
 |filename3    = 
 |title3       = 
 |description3 = 
}}

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

Styleパラメータ

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

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

使用例

基本的な使用例

{{試聴
 |filename     = Accordion chords-01.ogg
 |title        = Accordion chords
 |description  = Chords being played on an accordion
}}

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

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

ヘッダのテキストを記述した使用例

{{試聴
 |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:
}}

|plain=yesを指定した使用例

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

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

{{試聴
 |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
}}

関連項目

• {{Audio}} - 音声ファイルをインラインでリンクするテンプレート。
• {{Multi-listen start}}、{{Multi-listen item}}、{{Multi-listen end}} - 複数の音声ファイルをリスト形式で並べるテンプレート。
• Help:音声・動画の再生