Template:YouTube/doc：修订间差异

以互动方式浏览历史

←上一版本

删除的内容添加的内容

可视化wikitext

行内

2024年4月21日 (日) 19:23的最新版本

此頁面是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
可以使用简写 u 指定，即{{YouTube|u=userchannelname|title}}

{{YouTube|channel=userchannelid|title}}

参数 channel：填入“YouTube 用户频道id”，像是https://www.youtube.com/channel/userchannelid，該參數須符合d:Property:P2397#P2302的格式約束規定：須符合以下的正則表達式：UC[-_0-9A-Za-z]{21}[AQgw]
可以使用简写 c 指定，即{{YouTube|c=userchannelid|title}}

{{YouTube|custom=yourcustomname|title}}

参数 custom：填入“YouTube 自訂網址name”，像是https://www.youtube.com/c/yourcustomname。

{{YouTube|handle=userhandlecode|title}}

参数 handle：填入“YouTube 帐户代码”，像是https://www.youtube.com/@userhandlecode
可以使用简写 @ 指定，即{{YouTube|@=userhandlecode|title}}

链接至视频清单

{{YouTube|playlist=playlistid|title}}

参数 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]
可以使用简写 p 指定，即{{YouTube|p=playlistid|title}}。
参数 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 帐号代码	`handle` `@`	YouTube 帐号代码是在网址 https://www.youtube.com/@[帐号代码] 处示例值 youtubecreators	字符串	可选
YouTube 节目名称	`show`	YouTube 节目名称在网址 https://www.youtube.com/show/[showname] 之处示例值 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	字符串	可选

@@ 第2行： / 第2行： @@
 {{Documentation subpage}}
 {{noteTA
+|zh-cn:视频;zh-hk:影片;zh-tw:影片;
 |G1=IT
 }}
@@ 第10行： / 第11行： @@
 | text      = '''请不要使用此模板链接到违反[[WP:外部链接|版权法]]的材料。'''<br />如果链接这种材料，则必须使用合乎版权的链接替代或者<u>立即删除</u>。
 }}
-{{high-use|8800}}
+{{high-use|10399}}
 本模板用作<nowiki>==外部連結==</nowiki>章節連結[[YouTube]]-{zh-tw:影片;zh-cn:视频;zh-hk:影片}-的外部連結。此模板並非參考來源模板，您可以使用{{tl|cite AV media}}引用影音媒體。對於連續劇或連載式的媒體，使用{{tl|cite episode}}或{{tl|cite serial}}。要引用唱片封套上的說明文字（liner notes）及其他配有影音媒體的平面媒體，請使用{{tl|cite AV media notes}}。
 == 用法 ==
+=== 链接至视频 ===
- -{}-{{tlBh}}YouTube|'''视频id'''|'''link=no'''|'''视频描述'''|h='''小時數'''|m='''分鐘數'''|s='''秒數'''|language='''語言'''{{tlBf}}
+{{tlx|YouTube|视频id|link{{=}}no|视频描述|h{{=}}小時數|m{{=}}分鐘數|s{{=}}秒數|language{{=}}語言}}
 *參數說明：
-**參數'''1'''：视频id，即是在“<nowiki>http://www.youtube.com/watch?v=</nowiki>”或“<nowiki>https://music.youtube.com/watch?v=</nowiki>”之后的YouTube id，須符合[[d:Property:P1651#P2302]]的[[d:Q21502404|格式約束]]規定：64位元整數的[[Base64]]編碼，即符合以下的正則表達式：[https://regex101.com/?regex=%5B-_0-9A-Za-z%5D%7B11%7D <nowiki>[-_0-9A-Za-z]{11}</nowiki>]
+**參數 '''1'''：视频id，即是在<code><nowiki>http://www.youtube.com/watch?v=</nowiki></code>或<code><nowiki>https://music.youtube.com/watch?v=</nowiki></code>之后的'''YouTube id'''，須符合[[d:Property:P1651#P2302]]的[[d:Q21502404|格式約束]]規定：64位元整數的[[Base64]]編碼，即符合以下的正則表達式：[https://regex101.com/?regex=%5B-_0-9A-Za-z%5D%7B11%7D <nowiki>[-_0-9A-Za-z]{11}</nowiki>]（即11個字元的半形的[[連字暨減號]]、[[下橫線]]、[[阿拉伯数字]]、不區分大小寫的[[英文字母]]）
-***例如：https://www.youtube.com/watch?v=7bvukR-332A ，那麼视频id便是「7bvukR-332A」。
+***例如：https://www.youtube.com/watch?v=7bvukR-332A ，那麼视频id便是<code>7bvukR-332A</code>。
-**參數'''2'''（可省略）：為视频给出了一个可选的描述。
+**參數 '''2'''（可省略）：為视频给出了一个可选的描述。
 ***若省略此參數則描述會是包含本模板的頁面名稱。
 **'''h'''（可省略）：视频要開始播放的小時數。若省略此參數則為0。
@@ 第27行： / 第29行： @@
 **'''link=no'''（可省略）：用于取消YouTube条目链接。
-==範例==
+===== 範例 =====
+{{Uses Wikidata|P2397}}
 #<code><nowiki>{{Youtube|PfcgWfKOp1g}}</nowiki></code>
 #*效果：{{Youtube|PfcgWfKOp1g}}
@@ 第43行： / 第46行： @@
 #*效果：{{Youtube|PfcgWfKOp1g|Varias.Macau 85/86|m=3|s=04|language=zh-hk}}
-== 用户频道链接 ==
+=== 链接至用户频道 ===
-<code><nowiki>{{YouTube|</nowiki>user=''userchannelname''|''title''<nowiki>}}</nowiki></code>
+{{tlx|YouTube|user{{=}}''userchannelname''|''title''}}
-* ''user'' 是“YouTube 用户频道名”，像是<font color="darkblue"><nowiki>https://www.youtube.com/user/</nowiki>''userchannelname''</font>
+*参数 '''user'''：填入“YouTube 用户频道名”，像是<code><nowiki>https://www.youtube.com/user/</nowiki>''userchannelname''</code>
-* ''user'' 参数也可以使用简写 ''u'' 指定
+*可以使用简写 '''u''' 指定，即{{tlx|YouTube|u{{=}}''userchannelname''|''title''}}
-<code><nowiki>{{YouTube|</nowiki>channel=''userchannelid''|''title''<nowiki>}}</nowiki></code>
+{{tlx|YouTube|channel{{=}}''userchannelid''|''title''}}
-* ''channel'' 是“YouTube 用户频道id”，像是<font color="darkblue"><nowiki>https://www.youtube.com/channel/</nowiki>''userchannelid''</font>
+*参数 '''channel'''：填入“YouTube 用户频道id”，像是<code><nowiki>https://www.youtube.com/channel/</nowiki>''userchannelid''</code>，該參數須符合[[d:Property:P2397#P2302]]的[[d:Q21502404|格式約束]]規定：須符合以下的正則表達式：[https://regex101.com/?regex=UC%5B-_0-9A-Za-z%5D%7B21%7D%5BAQgw%5D <nowiki>UC[-_0-9A-Za-z]{21}[AQgw]</nowiki>]
+*可以使用简写 '''c''' 指定，即{{tlx|YouTube|c{{=}}''userchannelid''|''title''}}
-* ''title'' 是可选的描述，如不提供则为页面标题名（PAGENAME）
+{{tlx|YouTube|custom{{=}}''yourcustomname''|''title''}}
+*参数 '''custom'''：填入“YouTube 自訂網址name”，像是<code><nowiki>https://www.youtube.com/c/</nowiki>''yourcustomname''</code>。
+{{tlx|YouTube|handle{{=}}''userhandlecode''|''title''}}
+*参数 '''handle'''：填入“YouTube 帐户代码”，像是<code><nowiki>https://www.youtube.com/@</nowiki>''userhandlecode''</code>
+*可以使用简写 '''@''' 指定，即{{tlx|YouTube|@{{=}}''userhandlecode''|''title''}}
+=== 链接至视频清单 ===
+{{tlx|YouTube|playlist{{=}}''playlistid''|''title''}}
+*参数 '''playlist'''：填入“YouTube播放清单id”，像是<code><nowiki>https://www.youtube.com/playlist?list=</nowiki>''playlistid''</code>，該參數須符合[[d:Property:P4300#P2302]]的[[d:Q21502404|格式約束]]規定：須符合以下的正則表達式：[https://regex101.com/?regex=EL%5B0-9A-Za-z_-%5D%7B10%7D%5B048AEIMQUYcgkosw%5D%7C%7CPL%5B0-9A-Za-z_-%5D%7B16%7D%7C(%3F:UU|UC|PL|LL|EL)%5B0-9A-Za-z_-%5D%7B21%7D%5BAQgw%5D%7CPL%5B0-9A-Za-z_-%5D%7B32%7D%7C(%3F:OLAK5uy_%7CRDCLAK5uy_)%5B0-9A-Za-z_-%5D%7B32%7D%5B048AEIMQUYcgkosw%5D <nowiki>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]</nowiki>]
+*可以使用简写 '''p''' 指定，即{{tlx|YouTube|p{{=}}''playlistid''|''title''}}。
+* 参数 '''title''' 是可选的描述，如不提供则为当前条目标题名称（PAGENAME）。
 ==模版数据==
@@ 第82行： / 第96行： @@
 			],
 			"example": "UC-9-kyTW8ZkZNDHQJ6FgpwQ",
+			"type": "string"
+		},
+		"custom": {
+			"label": "YouTube 自訂頻道ID",
+			"description": "YouTube 自訂頻道ID是在網址 https://www.youtube.com/c/[自訂網址name] 之處",
+			"example": "YouTubeCreators",
 			"type": "string"
 		},
 		"show": {
-			"label": "YouTube show name",
+			"label": "YouTube 节目名称",
-			"description": "The show name which appears after https://www.youtube.com/show/ in the URL",
+			"description": "YouTube 节目名称在网址 https://www.youtube.com/show/[showname] 之处",
 			"example": "startrek",
 			"type": "string"
@@ 第115行： / 第135行： @@
 			"description": "Set this parameter to no to suppress the link to the YouTube article",
 			"example": "no",
+			"type": "string"
+		},
+		"handle": {
+			"aliases": [
+				"@"
+			],
+			"label": "YouTube 帐号代码",
+			"description": "YouTube 帐号代码是在网址 https://www.youtube.com/@[帐号代码] 处",
+			"example": "youtubecreators",
 			"type": "string"
 		}
-	}
+	},
+	"paramOrder": [
+		"id",
+		"user",
+		"channel",
+		"custom",
+		"handle",
+		"show",
+		"playlist",
+		"title",
+		"link"
+	]
 }
 </templatedata>
-== 參見 ==
+== 相关 ==
 * [[Template:Cite video]]
 * [[Template:Youku]]
 * [[Template:土豆網]]
+* [[Template:Bilibili]]
 <includeonly>{{Basepage subpage|
 <!-- ADD CATEGORIES BELOW THIS LINE -->