Template:注解/doc：修订间差异

←上一编辑

删除的内容添加的内容

可视化wikitext

行内

2025年10月27日 (一) 18:00的最新版本

本模板使用OOui实现，修改时请注意和全站JS/CSS的配合。

用来高亮需要注解的文字，并在鼠标悬停于文字时显示注解（部分手机版页面则为直接显示）。

说明

请注意，在Vocawiki为文字添加注释的首选方式是注脚（即页内<ref></ref>+页脚<references/>的形式），只有在使用注脚的效果不理想的时候，才应当考虑使用本模板，主要包括以下几种情况：

当页面中有较多内容需要注解，尤其是系统性地需要注解时，使用<ref></ref>可能会造成页脚处有大量意义不明的注释，而用本模板可以较为美观地解决问题。
- 例如：以无敌状态^{(注)持续2.2秒}对面前的一名敌人突进；对目标造成大幅度^{(注)26*(技能等級+1)+2.1*魔法攻击}的魔法伤害；对目标周围^{(注)范围450内}的敌人造成中幅度^{(注)24*(技能等級+1)+1.89*魔法攻击}的魔法伤害。^[1]
有时用<ref></ref>会造成注解的范围有歧义，需要在注释中解释，比较啰嗦，而本模板不会遇到这个问题。
- 例如：某活动将会举办两次，时间分别为5月20日和6月29日^(注)暂定。
当需要注解的内容出现在某些模板（例如页顶模板）中时，将注解放在页脚不一定合理。

更多可选的解决方案及其优劣比较，请参见Help:注脚#相关模板。

示例

代码	效果
`你{{注解\|萝莉\|萝莉通常是指出现在动漫中5-13岁的女性，或者拥有5-13岁女性外貌的女性}}！你全家都萝莉！`	你萝莉^{(注)萝莉通常是指出现在动漫中5-13岁的女性，或者拥有5-13岁女性外貌的女性}！你全家都萝莉！
`我明天{{color\|green\|{{bgcolor\|black\|{{注解\|更新\|假的}}}}}}！`	我明天更新^(注)假的！
`有些时候为了显示更加美观{{注解\|\|因为黄色底色过于难看}}可以将第一参数留空。`	有些时候为了显示更加美观^{(注)因为黄色底色过于难看}可以将第一参数留空。

上述第二个例子中使用了{{color}}和{{bgcolor}}模板，但其中需注解文字的背景颜色和注释角标的文字颜色分别被本模板覆盖。如果需要更加精细的颜色控制，或需要修改注释角标上的文字等，可以直接使用本模板所基于的{{高亮文字}}模板。

模板参数

用来高亮需要注解的文字，并在鼠标悬停于文字时显示注解（部分手机版页面则为直接显示）。

模板参数
此模板首选参数不换行的行内格式。
参数		描述	类型	状态
1	`1`	需要被高亮注解的文字。	内容	必需
2	`2`	被高亮文字的注解。	内容	必需

注释

↑ 取自古蕾雅(公主连结)#属性信息，该小节中有多个如此标注了参数的技能描述。

[1] 取自古蕾雅(公主连结)#属性信息，该小节中有多个如此标注了参数的技能描述。

[1]

@@ 第1行： / 第1行： @@
-{{High-risk|10000+}}
-{{info|本模板使用OOui实现，修改时请注意和全站[[GHIA:MoegirlPediaInterfaceCodes/blob/master/src/gadgets/site-js/MediaWiki:Gadget-site-js.js|JS]]/[[GHIA:MoegirlPediaInterfaceCodes/blob/master/src/gadgets/site-styles/MediaWiki:Gadget-site-styles.css|CSS]]的配合。}}
+{{info|本模板使用OOui实现，修改时请注意和全站[[MediaWiki:Gadget-site-js.js|JS]]/[[MediaWiki:Gadget-site-styles.css|CSS]]的配合。}}
 用来高亮需要注解的文字，并在鼠标悬停于文字时显示注解（部分手机版页面则为直接显示）。
 == 说明 ==
-'''请注意，在萌娘百科为文字添加注释的首选方式是[[Help:注脚|注脚]]'''（即页内<code><nowiki><ref></ref></nowiki></code>+页脚<code><nowiki><references/></nowiki></code>的形式），只有在使用注脚的效果不理想的时候，才应当考虑使用本模板，主要包括以下几种情况：
+'''请注意，在Vocawiki为文字添加注释的首选方式是[[Help:注脚|注脚]]'''（即页内<code><nowiki><ref></ref></nowiki></code>+页脚<code><nowiki><references/></nowiki></code>的形式），只有在使用注脚的效果不理想的时候，才应当考虑使用本模板，主要包括以下几种情况：
 # 当页面中有较多内容需要注解，尤其是系统性地需要注解时，使用<code><nowiki><ref></ref></nowiki></code>可能会造成页脚处有大量意义不明的注释，而用本模板可以较为美观地解决问题。
 #* 例如：以{{注释|无敌状态|持续2.2秒}}对面前的一名敌人突进；对目标造成{{注释|大幅度|26*(技能等級+1)+2.1*魔法攻击}}的魔法伤害；对{{注释|目标周围|范围450内}}的敌人造成{{注释|中幅度|24*(技能等級+1)+1.89*魔法攻击}}的魔法伤害。<ref>取自[[古蕾雅(公主连结)#属性信息]]，该小节中有多个如此标注了参数的技能描述。</ref>
@@ 第27行： / 第27行： @@
 上述第二个例子中使用了{{tl|color}}和{{tl|bgcolor}}模板，但其中需注解文字的背景颜色和注释角标的文字颜色分别被本模板覆盖。如果需要更加精细的颜色控制，或需要修改注释角标上的文字等，可以直接使用本模板所基于的{{tl|高亮文字}}模板。
-== 注意事项 ==
-由于技术或网络环境，有时候不能正常显示注解的效果。
 ==模板参数==
@@ 第56行： / 第53行： @@
 <references />
 <!-- 本行下加入模板的分類 -->
-<includeonly>[[Category:格式模板]][[Category:依赖全站样式的模板]]</includeonly>
+<includeonly>[[Category:引用模板]][[Category:依赖全站样式的模板]]</includeonly>
 <noinclude>[[Category:模板文档]]</noinclude>