查看“︁Template:虚拟歌手歌曲荣誉题头/doc”︁的源代码

本模板用于指示某个虚拟歌手歌曲达成殿堂、传说、神话等荣誉成就，并且支持同时展示多引擎、多站点及不同级别的荣誉。（特别的，[[MAIDLOID电动曲]]仅显示为同义的“MAIDLOID殿堂曲”）

本模板包含用于指示引擎的匿名参数及用于区分站点的<code>nrank</code>、<code>brank</code>及<code>yrank</code>，首行会取其中最高级别的荣誉显示。此外，出于“YouTube成就”存在争议，YouTube相关文字做了单独处理，该行不出现荣誉字眼，但仍给出对应列表链接。

侧栏颜色及图片在仅有单个引擎时均会显示为对应引擎的配色、配图及链接，多引擎时默认显示为VOCALOID的配色及配图并将链接指向[[虚拟歌手]]，此三项亦支持自行指定。也支持自行指定歌曲以外的作品体裁。

==调用方式==
详细调用方式及示例如下：

基础参数
*<code>（匿名参数）</code>：填写引擎名称，如果有多个引擎则分多个参数填写。填写的引擎名称需要'''与荣誉列表页面和分类的名称一致'''。
*<code>nrank</code>、<code>brank</code>及<code>yrank</code>：分别代表niconico、bilibili及YouTube，1指代殿堂，2指代传说，3指代神话，YouTube单独具有4指代1亿播放。
<code><nowiki>{{虚拟歌手歌曲荣誉题头|VOCALOID|nrank=3}}</nowiki></code>
{{虚拟歌手歌曲荣誉题头|VOCALOID|nrank=3}}
<code><nowiki>{{虚拟歌手歌曲荣誉题头|UTAU|nrank=2}}</nowiki></code>
{{虚拟歌手歌曲荣誉题头|UTAU|nrank=2}}
<code><nowiki>{{虚拟歌手歌曲荣誉题头|NEUTRINO|nrank=1}}</nowiki></code>
{{虚拟歌手歌曲荣誉题头|NEUTRINO|nrank=1}}
多站点：
<code><nowiki>{{虚拟歌手歌曲荣誉题头|VOCALOID|nrank=1|brank=1}}</nowiki></code>
{{虚拟歌手歌曲荣誉题头|VOCALOID|nrank=1|brank=1}}
多引擎：
<code><nowiki>{{虚拟歌手歌曲荣誉题头|VOCALOID|UTAU|nrank=2}}</nowiki></code>
{{虚拟歌手歌曲荣誉题头|VOCALOID|UTAU|nrank=2}}
YouTube：
<code><nowiki>{{虚拟歌手歌曲荣誉题头|VOCALOID|UTAU|CeVIO|nrank=2|brank=1|yrank=3}}</nowiki></code>
{{虚拟歌手歌曲荣誉题头|VOCALOID|UTAU|CeVIO|nrank=2|brank=1|yrank=3}}
yrank=4：<code><nowiki>{{虚拟歌手歌曲荣誉题头|VOCALOID|UTAU|CeVIO|nrank=2|brank=1|yrank=4}}</nowiki></code>
{{虚拟歌手歌曲荣誉题头|VOCALOID|UTAU|CeVIO|nrank=2|brank=1|yrank=4}}

可选参数
*<code>color</code>：指定侧栏颜色
*<code>image</code>：指定图片
*<code>link</code>：指定图片链接
<code><nowiki>{{虚拟歌手歌曲荣誉题头|VOCALOID|nrank=3|image=E60b3be36394a03bb68bf691209e94dc_360.png|color=orange|link=战斗天赋解析系统}}</nowiki></code>
{{虚拟歌手歌曲荣誉题头|VOCALOID|nrank=3|image=E60b3be36394a03bb68bf691209e94dc_360.png|color=orange|link=战斗天赋解析系统}}
*<code>type</code>：指定歌曲以外的作品体裁，当体裁为歌曲时'''不应保留此参数'''。
*<code>nview</code>、<code>bview</code>及<code>yview</code>：分别指定niconico、bilibili及YouTube播放量的具体数值，单位为万
<code><nowiki>{{虚拟歌手歌曲荣誉题头|VOCALOID|brank=1|type=音乐剧|bview=20}}</nowiki></code>
{{虚拟歌手歌曲荣誉题头|VOCALOID|brank=1|type=音乐剧|bview=20}}

==更新维护==
===链接与重定向===
为了便于链接及统一链接格式，本模板在链接至对应荣誉列表时全部采用了“<荣誉>/<站点>投稿”的链接，因此需要配合大量重定向，在对应列表发生变更时需要建立或调整对应重定向。

例：（重定向→对应位置）
#[[VOCALOID神话曲/niconico投稿]]→[[VOCALOID神话曲]]
#[[Synthesizer V传说曲/bilibili投稿]]→[[Synthesizer V传说曲]]
#[[New_Type殿堂曲/niconico投稿]]→[[New_Type殿堂曲#niconico投稿]]

===引擎配色配图===
需要添加全新引擎的默认配色及配图时，需要在本模板中<code>leftimage</code>参数处的<code>#switch</code>中，<code>|#default=初音 殿堂曲题头.jpg</code>前按<code><nowiki>|<新引擎名>={{#if:{{{2|}}}|初音 殿堂曲题头.jpg|<新引擎使用的配图>}}</nowiki></code>添加配图，在<code>color</code>参数处的<code>#switch</code>中，<code>|#default=#009999</code>前按<code><nowiki>|<新引擎名>={{#if:{{{2|}}}|#009999|<新引擎使用的配色>}}</nowiki></code>添加配色。没有添加时默认显示为VOCALOID的配色及配图。
<noinclude>[[分类:模板文档]]</noinclude>