Template:YouTube/doc

此頁面是Template:YouTube的Template文档。
此頁面可能包含了模板的使用說明、分類和其他内容。

请不要使用此模板链接到违反版权法的材料。
如果链接这种材料，则必须使用合乎版权的链接替代或者立即删除。

此Template文档被引用於約17,000個頁面。
為了避免造成大規模的影響，所有對此Template文档的編輯應先於沙盒、測試樣例或您的沙盒上測試。
測試後無誤的版本可以一次性地加入此Template文档中，但是修改前請務必於討論頁發起討論。

模板引用數量會自動更新。

本模板用作==外部連結==章節連結YouTube视频的外部連結。此模板並非參考來源模板，您可以使用{{cite AV media}}引用影音媒體。對於連續劇或連載式的媒體，使用{{cite episode}}或{{cite serial}}。要引用唱片封套上的說明文字（liner notes）及其他配有影音媒體的平面媒體，請使用{{cite AV media notes}}。

用法

{{YouTube|视频id|link=no|视频描述|h=小時數|m=分鐘數|s=秒數|language=語言}}

參數說明：
- 參數1：视频id，即是在“http://www.youtube.com/watch?v=”或“https://music.youtube.com/watch?v=”之后的YouTube id，須符合d:Property:P1651#P2302的格式約束規定：64位元整數的Base64編碼，即符合以下的正則表達式：[-_0-9A-Za-z]{11}（即11個字元的半形的連字暨減號、下橫線、阿拉伯数字、不區分大小寫的英文字母）
  - 例如：https://www.youtube.com/watch?v=7bvukR-332A ，那麼视频id便是「7bvukR-332A」。
- 參數2（可省略）：為视频给出了一个可选的描述。
  - 若省略此參數則描述會是包含本模板的頁面名稱。
- h（可省略）：视频要開始播放的小時數。若省略此參數則為0。
- m（可省略）：视频要開始播放的分鐘數。若省略此參數則為0。
- s（可省略）：视频要開始播放的秒數。若省略此參數則為0。（注意：参数show不可用简称s，否则会与秒數冲突而无法正常显示。）
- language（可省略）：视频的語言。
- link=no（可省略）：用于取消YouTube条目链接。

範例

{{Youtube|PfcgWfKOp1g}}
- 效果：YouTube上的视频
{{YouTube|9bZkp7q19f0|《江南Style》}}
- 效果：YouTube上的《江南Style》
{{YouTube|c=UCidwPAdN3UO59sMOZX2cn6Q}}
- 效果：YouTube上的甜度冰塊 KaoBeiCold頻道
{{YouTube|show=startrek|''Star Trek: The Original Series''}}
- 效果：YouTube上的Star Trek: The Original Series劇集
{{Youtube|PfcgWfKOp1g|Varias.Macau 85/86|m=3}}
- 效果：YouTube上的Varias.Macau 85/86，始於3分00秒
{{Youtube|PfcgWfKOp1g|Varias.Macau 85/86|m=3|s=04}}
- 效果：YouTube上的Varias.Macau 85/86，始於3分04秒
{{Youtube|PfcgWfKOp1g|Varias.Macau 85/86|m=3|s=04|language=zh-hk}}
- 效果：YouTube上的Varias.Macau 85/86，始於3分04秒（繁體中文）

用户频道链接

{{YouTube|user=userchannelname|title}}

user 是“YouTube 用户频道名”，像是https://www.youtube.com/user/userchannelname
user 参数也可以使用简写 u 指定

{{YouTube|channel=userchannelid|title}}

channel 是“YouTube 用户频道id”，像是https://www.youtube.com/channel/userchannelid，該參數須符合d:Property:P2397#P2302的格式約束規定：須符合以下的正則表達式：UC[-_0-9A-Za-z]{21}[AQgw]
playlist 是“YouTube播放列表id”，像是https://www.youtube.com/playlist?list=playlistid，該參數須符合d:Property:P4300#P2302的格式約束規定：須符合以下的正則表達式：EL[0-9A-Za-z_-]{10}[048AEIMQUYcgkosw]||PL[0-9A-Za-z_-]{16}|(?:UU|UC|PL|LL|EL)[0-9A-Za-z_-]{21}[AQgw]|PL[0-9A-Za-z_-]{32}|(?:OLAK5uy_|RDCLAK5uy_)[0-9A-Za-z_-]{32}[048AEIMQUYcgkosw]
custom 是“YouTube 自訂網址name”，像是https://www.youtube.com/c/yourcustomname
title 是可选的描述，如不提供则为页面标题名（PAGENAME）

模版数据

以下是该模板的模板数据，适用于可视化编辑器等工具。

YouTube模板数据

本模板用以在外部連結段落建立連結至YouTube網站的超連結。非參考來源模板。

模板参数
参数		描述	类型	状态
YouTube 影片ID	`id` `1`	影片ID是網址 https://www.youtube.com/watch?v=[影片ID] 之處示例值 9bZkp7q19f0	字符串	可选
YouTube 使用者名稱	`user` `u`	YouTube 使用者名稱是在網址 https://www.youtube.com/user/[使用者名稱] 之處示例值 pewdiepie	字符串	可选
YouTube 頻道ID	`channel` `c`	YouTube 頻道ID是在網址 https://www.youtube.com/channel/[頻道ID] 之處示例值 UC-9-kyTW8ZkZNDHQJ6FgpwQ	字符串	可选
YouTube 自訂ID	`custom`	YouTube 頻道ID是在網址 https://www.youtube.com/c/[自訂網址name] 之處示例值 YouTubeCreators	字符串	可选
YouTube show name	`show`	The show name which appears after https://www.youtube.com/show/ in the URL 示例值 startrek	字符串	可选
YouTube 播放清單ID	`playlist` `p`	YouTube 播放清單ID是在網址 https://www.youtube.com/playlist?list=[播放清單ID] 之處示例值 PLrEnWoR732-DZV1Jc8bUpVTF_HTPbywpE	字符串	可选
Title	`title` `1` `2`	The name of the page being linked to 默认值 If it is a video, Video, if it is a show, the article's page name in italics, otherwise, the article's page name unformatted 示例值 Gangnam Style	字符串	推荐
Link on	`link`	Set this parameter to no to suppress the link to the YouTube article 示例值 no	字符串	可选

用法

範例

用户频道链接

模版数据

相关