Template:YouTube/doc
これはTemplate:YouTubeの解説サブページです。 使用方法、カテゴリ、およびその他テンプレート自体に含まれない情報を収容しています。 |
Luaモジュールを使用しています: |
著作権法に違反するコンテンツへリンクしないでください。 そのようなリンクを見つけた場合、速やかに除去するか、法的に問題のないコンテンツへのリンクに置き換えてください。 |
このテンプレートは、出典表記形式1や出典表記形式2のような出典テンプレートに用いるべきではありません。なぜなら、マークアップが含まれており、生成されるCOinSメタデータを書き換えてしまうからです(Wikipedia:COinSも参照)。 |
YouTubeにある動画、チャンネル、YouTube show(公式配信の映画やテレビ番組)、プレイリストにリンクするテンプレートです。基本的に外部リンク節で使用します。{{External media}}の内部で使うこともできます。
このテンプレートは出典テンプレートではありません。動画を出典とする場合は{{cite video}}・{{cite AV media}}・{{cite AV media ja}}が使用可能です。動画がニュース番組である場合は{{cite news}}を、エピソード形式である場合は{{cite episode}}を使用することもできます。
使用方法
[編集]動画へのリンク
[編集]書式(引数1個):
{{YouTube|VIDEOID}}
{{YouTube|id=VIDEOID}}
書式(引数2個):
{{YouTube|VIDEOID|タイトル}}
{{YouTube|id=VIDEOID|title=タイトル}}
解説:
- YouTube上の動画にリンクするには、動画識別子を
|1=
もしくは|id=
に指定します。動画識別子はhttps://www.youtube.com/watch?v=VIDEOID のVIDEOIDにあたる部分です。 - 動画のタイトルは
|2=
もしくは|title=
に指定します。ここで指定された文字列がリンクテキストとして表示されます。指定しなかった場合は「映像」と表示します。
使用例( https://www.youtube.com/watch?v=j9-CovbP-7U ):
* {{YouTube|j9-CovbP-7U}}
* {{YouTube|j9-CovbP-7U|Inside Wikimedia}}
タイムスタンプの指定
[編集]動画の冒頭ではなく途中にリンクするには、タイムスタンプを|time=
・|t=
・|3=
のいずれかに指定します。
使用例:
* {{YouTube|id=j9-CovbP-7U|title=Inside Wikimedia|time=1m23s}}
- Inside Wikimedia(1m23s〜) - YouTube
チャンネルへのリンク
[編集]チャンネル識別子でリンクする
[編集]書式(引数1個):
{{YouTube|c=CHANNELID}}
{{YouTube|channel=CHANNELID}}
書式(引数2個):
{{YouTube|c=CHANNELID|タイトル}}
{{YouTube|c=CHANNELID}}
{{YouTube|channel=CHANNELID|タイトル}}
{{YouTube|channel=CHANNELID}}
解説:
|c=
もしくは|channel=
にチャンネル識別子を指定します。チャンネル識別子はhttps://www.youtube.com/channel/CHANNELID のCHANNELIDにあたる部分です。- リンクテキストとして表示する文字列は
|1=
もしくは|title=
に指定します。指定しなかった場合はテンプレートを呼び出した記事のタイトルが表示されます。
使用例( https://www.youtube.com/channel/UCK_cUZLMpibyRiIdp0uF-lQ ):
* {{YouTube|channel=UCK_cUZLMpibyRiIdp0uF-lQ|Wikimedia Foundation}}
- Wikimedia Foundation - YouTubeチャンネル
YouTubeハンドルでリンクする
[編集]書式(引数1個):
{{YouTube|h=HANDLEID}}
{{YouTube|handle=HANDLEID}}
書式(引数2個):
{{YouTube|h=HANDLEID|タイトル}}
{{YouTube|h=HANDLEID}}
{{YouTube|handle=HANDLEID|タイトル}}
{{YouTube|handle=HANDLEID}}
解説:
|h=
もしくは|handle=
にYouTubeハンドルを指定します。YouTubeハンドルはhttps://www.youtube.com/@HANDLEID のHANDLEIDにあたる部分です。- リンクテキストとして表示する文字列は
|1=
もしくは|title=
に指定します。指定しなかった場合はテンプレートを呼び出した記事のタイトルが表示されます。
使用例( https://www.youtube.com/@wikipedia ):
* {{YouTube|handle=wikipedia|Wikimedia Foundation}}
- Wikimedia Foundation - YouTubeチャンネル
ユーザー名でリンクする
[編集]※ ユーザー名はYouTubeの古い機能であるため、チャンネル名やYouTubeハンドルによるURLでリンクすることを推奨します。
書式(引数1個):
{{YouTube|u=USERNAME}}
{{YouTube|user=USERNAME}}
書式(引数2個):
{{YouTube|u=USERNAME|タイトル}}
{{YouTube|u=USERNAME}}
{{YouTube|user=USERNAME|タイトル}}
{{YouTube|user=USERNAME}}
解説:
|u=
もしくは|user=
にユーザー名を指定します。ユーザー名はhttps://www.youtube.com/user/USERNAME のUSERNAMEにあたる部分です。- リンクテキストとして表示する文字列は
|1=
もしくは|title=
に指定します。指定しなかった場合はテンプレートを呼び出した記事のタイトルが表示されます。
使用例( https://www.youtube.com/user/WikimediaFoundation ):
* {{YouTube|user=WikimediaFoundation|Wikimedia Foundation}}
- Wikimedia Foundation - YouTubeチャンネル
カスタムURLでリンクする
[編集]※ カスタムURLはYouTubeの古い機能であるため、チャンネル名やYouTubeハンドルによるURLでリンクすることを推奨します。
書式(引数1個):
{{YouTube|custom=CUSTOMURL}}
書式(引数2個):
{{YouTube|custom=CUSTOMURL|タイトル}}
{{YouTube|custom=CUSTOMURL}}
解説:
|custom=
にカスタムURL中の識別子を指定します。識別子はhttps://www.youtube.com/c/>CUSTOMURL のCUSTOMURLにあたる部分です。- リンクテキストとして表示する文字列は
|1=
もしくは|title=
に指定します。指定しなかった場合はテンプレートを呼び出した記事のタイトルが表示されます。
使用例( https://www.youtube.com/c/officialBEG ):
* {{YouTube|custom=officialBEG|Brown Eyed Girls}}
- Brown Eyed Girls - YouTubeチャンネル
YouTube showへのリンク
[編集]※ 著作権の制約により現時点で居住している国によって紹介ページにある動画の再生が不可能の場合があります。例としてアメリカ合衆国からのアクセスで再生可能な場合でも、日本からのアクセスでは再生できない場合があります。
書式(引数1個):
{{YouTube|s=SHOWID}}
{{YouTube|show=SHOWID}}
書式(引数2個):
{{YouTube|s=SHOWID|タイトル}}
{{YouTube|s=SHOWID}}
{{YouTube|show=SHOWID|タイトル}}
{{YouTube|show=SHOWID}}
解説:
|s=
もしくは|show=
にshowの識別子を指定します。識別子はhttps://www.youtube.com/show/SHOWID のSHOWIDにあたる部分です。- リンクテキストとして表示する文字列は
|1=
もしくは|title=
に指定します。指定しなかった場合はテンプレートを呼び出した記事のタイトルが表示されます。
使用例( https://www.youtube.com/show/SCWdVLvom3QaFGxEKNASntaA ):
* {{YouTube|show=SCWdVLvom3QaFGxEKNASntaA|Star Trek}}
プレイリストへのリンク
[編集]書式(引数1個):
{{YouTube|p=PLAYLISTID}}
{{YouTube|playlist=PLAYLISTID}}
書式(引数2個):
{{YouTube|p=PLAYLISTID|タイトル}}
{{YouTube|p=PLAYLISTID}}
{{YouTube|playlist=PLAYLISTID|タイトル}}
{{YouTube|playlist=PLAYLISTID}}
解説:
|p=
もしくは|playlist=
にshowの識別子を指定します。識別子はhttps://www.youtube.com/playlist?list=PLAYLISTID のPLAYLISTIDにあたる部分です。- リンクテキストとして表示する文字列は
|1=
もしくは|title=
に指定します。指定しなかった場合はテンプレートを呼び出した記事のタイトルが表示されます。
使用例( https://www.youtube.com/playlist?list=PLhV3K_DS5YfKOB0fRh1XXCEBuczGa33iA ):
* {{YouTube|playlist=PLhV3K_DS5YfKOB0fRh1XXCEBuczGa33iA|Wikimedia monthly activities meetings}}
内部リンクの無効化
[編集]|link=no
と指定することで、出力における"YouTube"の部分に内部リンクが生成されなくなります。
例:
{{YouTube|j9-CovbP-7U|Inside Wikimedia|link=no}}
Inside Wikimedia - YouTube
エラーチェック
[編集]識別子などを一切指定しないでテンプレートを呼び出した場合はエラーメッセージを表示します。
{{YouTube}}
[1]{{YouTube}}のエラー: 引数が不足しているか、引数名を間違えています。
引数名が間違っている場合もエラーメッセージが表示されることがあります。
{{YouTube|ID=test}}
[2]{{YouTube}}のエラー: 引数が不足しているか、引数名を間違えています。
追跡カテゴリ
[編集]- Category:テンプレート呼び出しエラーのあるページ/Template:YouTube (12) – 標準名前空間を含む一部の名前空間において、識別子などを一切指定していないか、複数指定してテンプレートを呼び出した場合に付与されるカテゴリ
- Category:不明な引数を指定しているページ/Template:YouTube (0) – テンプレート側で認識できない引数を使用している標準名前空間のページに付与されるカテゴリ
関連項目
[編集]- Template:cite video、Template:cite AV media、Template:cite AV media ja - 動画を出典として明記するためのテンプレート。
- Template:External music video - {{Infobox}}内にミュージックビデオをリンクするためのテンプレート。
- Template:YouTube channel - YouTubeのユーザーチャンネルにリンクするためのテンプレート。当テンプレートとは使い方が少し異なります。
- Template:Nicovideo - ニコニコ動画の映像にリンクするためのテンプレート。
- Template:YouTube Music - YouTube Musicの曲ページ、チャンネル(アーティスト)ページ、プレイリスト(アルバム/シングル)ページにリンクするためのテンプレート。
- http://*.youtube.comおよびhttps://*.youtube.comへリンクしているページの一覧
- このテンプレートを脚注内で使用している記事を検索
テンプレートデータ
[編集]YouTubeにある動画やチャンネルなどのコンテンツにリンクするための外部リンク用テンプレート。出典テンプレートとしては使わない。
パラメーター | 説明 | 型 | 状態 | |
---|---|---|---|---|
動画識別子 | id 1 | 動画のURLにおいて https://www.youtube.com/watch?v= に続く識別子
| 文字列 | 推奨 |
タイムスタンプ | time t 3 | 動画の途中にリンクする場合は、この引数にタイムスタンプを指定する
| 文字列 | 省略可能 |
チャンネル識別子 | channel c | チャンネルのURLにおいて after https://www.youtube.com/channel/ に続く識別子
| 文字列 | 推奨 |
YouTubeハンドル | handle h | チャンネルのURLにおいて after https://www.youtube.com/@ に続く識別子
| 文字列 | 省略可能 |
ユーザー名 | user u | チャンネルのURLにおいて https://www.youtube.com/user/ に続く識別子
| 文字列 | 省略可能 |
カスタムURL中の識別子 | custom | チャンネルのURLにおいて https://www.youtube.com/c/ に続く識別子
| 文字列 | 省略可能 |
YouTube showの識別子 | show s | showのURLにおいて https://www.youtube.com/show/ に続く識別子
| 文字列 | 推奨 |
プレイリストの識別子 | playlist p | プレイリストのURLにおいて https://www.youtube.com/playlist?list= に続く識別子
| 文字列 | 推奨 |
タイトル | title 2 | リンクテキストとして表示する文字列
| 文字列 | 推奨 |
内部リンクの有無 | link | noを指定すると、出力における'YouTube'の部分に内部リンクが生成されなくなる
| 文字列 | 省略可能 |