Template:注解/doc

本模板已应用于10000+页面。
为避免大规模的破坏及不必要的服务器负荷，任何改动均应先在该模板对应的沙盒页面或您自己的用户页下进行测试，并将测试无误的代码一次性地改动至本模板。
为尊重其他用户，任何功能/兼容性改动在生效前都应先在讨论页进行讨论。

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

使用场景

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

请注意，在萌娘百科为文字添加注释的首选方式是注脚（即页内<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}}模板，但其中需注解文字的背景颜色和注释角标的文字颜色分别被本模板覆盖。如果需要更加精细的颜色控制，或需要修改注释角标上的文字等，可以直接使用本模板所基于的{{高亮文字}}模板。