テンプレート:YouTube/doc
| これはテンプレート:YouTubeの解説サブページです。 使用方法、カテゴリ、およびその他テンプレート自体に含まれない情報を収容しています。 |
| Luaモジュールを使用しています: |
| 著作権法に違反するコンテンツへリンクしないでください。 そのようなリンクを見つけた場合、速やかに除去するか、法的に問題のないコンテンツへのリンクに置き換えてください。 |
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=テンプレート:hilite のVIDEOIDにあたる部分です。 - 動画のタイトルは
|2=もしくは|title=に指定します。ここで指定された文字列がリンクテキストとして表示されます。指定しなかった場合は「映像」と表示します。
使用例( https://www.youtube.com/watch?v=j9-CovbP-7U ): テンプレート:demo テンプレート:demo
タイムスタンプの指定[編集 | ソースを編集]
動画の冒頭ではなく途中にリンクするには、タイムスタンプを|time=・|t=・|3=のいずれかに指定します。
使用例: テンプレート:demo
チャンネルへのリンク[編集 | ソースを編集]
チャンネル識別子でリンクする[編集 | ソースを編集]
書式(引数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/テンプレート:hilite のCHANNELIDにあたる部分です。- リンクテキストとして表示する文字列は
|1=もしくは|title=に指定します。指定しなかった場合はテンプレートを呼び出した記事のタイトルが表示されます。
使用例( https://www.youtube.com/channel/UCK_cUZLMpibyRiIdp0uF-lQ ): テンプレート:demo
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/@テンプレート:hilite のHANDLEIDにあたる部分です。- リンクテキストとして表示する文字列は
|1=もしくは|title=に指定します。指定しなかった場合はテンプレートを呼び出した記事のタイトルが表示されます。 - handleは「@」付きでも良い。
使用例( https://www.youtube.com/@wikipedia ): テンプレート:demo
ユーザー名でリンクする[編集 | ソースを編集]
※ ユーザー名は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/テンプレート:hilite のUSERNAMEにあたる部分です。- リンクテキストとして表示する文字列は
|1=もしくは|title=に指定します。指定しなかった場合はテンプレートを呼び出した記事のタイトルが表示されます。
使用例( https://www.youtube.com/user/WikimediaFoundation ): テンプレート:demo
カスタムURLでリンクする[編集 | ソースを編集]
※ カスタムURLはYouTubeの古い機能であるため、チャンネル名やYouTubeハンドルによるURLでリンクすることを推奨します。
書式(引数1個):
{{YouTube|custom=CUSTOMURL}}
書式(引数2個):
{{YouTube|custom=CUSTOMURL|タイトル}}{{YouTube|custom=CUSTOMURL}}
解説:
|custom=にカスタムURL中の識別子を指定します。識別子はhttps://www.youtube.com/c/>テンプレート:hilite のCUSTOMURLにあたる部分です。- リンクテキストとして表示する文字列は
|1=もしくは|title=に指定します。指定しなかった場合はテンプレートを呼び出した記事のタイトルが表示されます。
使用例( https://www.youtube.com/c/officialBEG ): テンプレート:demo
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/テンプレート:hilite のSHOWIDにあたる部分です。- リンクテキストとして表示する文字列は
|1=もしくは|title=に指定します。指定しなかった場合はテンプレートを呼び出した記事のタイトルが表示されます。
使用例( https://www.youtube.com/show/SCWdVLvom3QaFGxEKNASntaA ): テンプレート:demo
プレイリストへのリンク[編集 | ソースを編集]
書式(引数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=テンプレート:hilite のPLAYLISTIDにあたる部分です。- リンクテキストとして表示する文字列は
|1=もしくは|title=に指定します。指定しなかった場合はテンプレートを呼び出した記事のタイトルが表示されます。
使用例( https://www.youtube.com/playlist?list=PLhV3K_DS5YfKOB0fRh1XXCEBuczGa33iA ): テンプレート:demo
内部リンクの無効化[編集 | ソースを編集]
|link=noと指定することで、出力における"YouTube"の部分に内部リンクが生成されなくなります。
例: テンプレート:demo
エラーチェック[編集 | ソースを編集]
識別子などを一切指定しないでテンプレートを呼び出した場合はエラーメッセージを表示します。
引数名が間違っている場合もエラーメッセージが表示されることがあります。
追跡カテゴリ[編集 | ソースを編集]
- テンプレート:clc – 標準名前空間を含む一部の名前空間において、識別子などを一切指定していないか、複数指定してテンプレートを呼び出した場合に付与されるカテゴリ
- テンプレート:clc – テンプレート側で認識できない引数を使用している標準名前空間のページに付与されるカテゴリ
関連項目[編集 | ソースを編集]
- 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'の部分に内部リンクが生成されなくなる
| 文字列 | 省略可能 |