模板:IconLink

模板文档  

这个文档嵌入自Template:IconLink/doc。

此模板“IconLink”目前处于测试阶段。可能会出现以下问题：

• 使用方法更动

---

欢迎您协助测试本模板。如果在使用过程中出现问题，你可以在模板讨论页提出。

本模板可以给外部链接附上对应的图标。

在支持的范围内，提供以下便捷功能：

• 根据URL自动识别网站；
• 根据网站标识符和ID构建链接（如给出tw和irodori7即可构建链接https://twitter.com/irodori7）；
• 对于独特的ID格式（如BV号、sm号等），不填写网站标识符便能识别网站。

效果和使用例

• 填写了标题时： 【friends】哇咧哇咧哇 哇咧哇咧哇
• 未填写标题时：
• 未匹配到网站，填写了标题时：动物游行 ～加帕里公园纪念～ - 萌娘百科 万物皆可萌的百科全书
• 未匹配到网站，未填写标题时：[1]

使用例

可不
别号	KAFU
媒体
Youtube	音乐的同位体「可不」 KAFU
Twitter	X @kaf_you

投稿顺序	投稿时间	歌曲名称	作词	作曲	编曲	媒体
2	2021年01月09日	「ホログラム」	一二三	一二三	一二三

投稿序号	投稿时间	投稿系列	名称	媒体
#4	2020年08月16日	ヰ世界創世記	「流星」	X

用法

{{icl|网站标识符|URL或ID|标题}}

“网站标识符”和“ID”请见#支持的网站。如果想用的ID不支持怎么办？——填写完整URL。

填写时必须按这个相对顺序，但并不是每个参数都要填写：

• 填写了URL就不用填网站标识符，如{{icl|https://www.bilibili.com/video/BV1Wx411D74Q}}等同于{{icl|bili|https://www.bilibili.com/video/BV1Wx411D74Q}}。
• 若ID符合#独特ID格式，则无需填写网站标识符。如{{icl|BV1Wx411D74Q}}等同于{{icl|bili|BV1Wx411D74Q}}。

命名参数

网址和标题中可能会有等号，这会与匿名参数冲突（等号前面的部分会被当成参数名）。因此本模板还支持一些命名参数，替换原本的匿名参数。

• |site=网站标识符（主要用于#封装模板）
• |link=URL
• |title=标题

例如（注意网址中的等号）：

• 使用匿名参数：
  • {{icl|https://www.youtube.com/watch?v=ZnfHNU6iej4|【PUBG限制玩法】不管说什么都愿意听的HINATA酱【#1X】}}
• 使用命名参数：
  • {{icl|link=https://www.youtube.com/watch?v=ZnfHNU6iej4|【PUBG限制玩法】不管说什么都愿意听的HINATA酱【#1X】}}
  • 【PUBG限制玩法】不管说什么都愿意听的HINATA酱【#1X】

---

以下参数只能使用命名参数：

• size 调整图标大小，格式与[[File:...|<size>]]中的相同。

例如：

• {{icl|BV1Wx411D74Q|size=42px}}：

支持的网站

网站	标识符（不分大小写）	支持自动检测的域名	支持的ID（部分大小写敏感）
AcFun	acfun	acfun.cn	视频ac号、UID
bilibili	bilibili、bili、bl	bilibili.com	av号、BV号、cv号、UID
Instagram	instagram、ig	instagram.com	用户名（@后面的部分）
niconico	niconico、nc	nicovideo.jp	sm号、so号、UID
piapro	piapro	piapro.jp	piapro ID
Twitch	twitch、ttv	twitch.tv	用户（频道）名
微博	weibo、wb	weibo.com、weibo.cn	“https://weibo.com/”后面的路径
X	x、twitter、tw	twitter.com、x.com	用户名、帖子（填写格式为“用户名 帖子号”）
YouTube	youtube、ytb、yt	youtube.com	视频ID、频道ID（“UC”开头）、频道标识名（“@”开头）

支持自动检测的域名理论上可以包含短链，但是为了鼓励使用完整链接，所以没做进去。

独特ID格式

如果ID符合独特ID格式，则无需填写网站标识符。

独特ID	格式	对应网站
ac号	ac+数字	AcFun
av号	av+数字	bilibili
BV号	BV+字母数字
cv号	cv+数字
sm号	sm+数字	niconico

封装模板

不建议封装过多这样的模板，除非真的使用很广。

使用模块:IconLink的wrapper函数，以bilibili为例：

{{#invoke:IconLink|wrapper|site=bilibili}}

对于其他网站把“bilibili”换成对应的网站标识符就行。

封装模板在使用上除了没有“网站标识符”外，与本模板一致。

注释