模板:YouTube/doc

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

請不要使用此模板鏈接到違反版權法的材料。
如果鏈接這種材料，則必須使用合乎版權的鏈接替代或者立即刪除。

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

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

本模板用作==外部連結==章節連結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}
  - 例如：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]
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 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	字串	非必填

參見