查看“模板:注解/doc”的源代码

<!-- 在本行下編輯模板說明 -->
== 使用场景 ==
用来高亮需要注解的文字，并在鼠标悬停于文字时显示注解（手机版则为直接显示）。

'''请注意，在萌娘百科为文字添加注释的首选方式是[[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>
# 有时用<code><nowiki><ref></ref></nowiki></code>会造成注解的范围有歧义，需要在注释中解释，比较啰嗦，而本模板不会遇到这个问题。
#* 例如：某活动将会举办两次，时间分别为5月20日和{{注释|6月29日|暂定}}。
# 当需要注解的内容出现在某些模板（例如页顶模板）中时，将注解放在页脚不一定合理。

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

== 用法示例 ==
{| class="wikitable"
|-
! 代码 !! 效果
|-
| <code><nowiki>你{{注解|萝莉|萝莉通常是指出现在动漫中5-13岁的女性，或者拥有5-13岁女性外貌的女性}}！你全家都萝莉！</nowiki></code> || 你{{注解|萝莉|萝莉通常是指出现在动漫中5-13岁的女性，或者拥有5-13岁女性外貌的女性}}！你全家都萝莉！
|-
| <code><nowiki>我明天{{color|green|{{bgcolor|black|{{注解|更新|假的}}}}}}！</nowiki></code> || 我明天{{color|green|{{bgcolor|black|{{注解|更新|假的}}}}}}！
|}

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

== 注意事项 ==
* 注释部分只能使用纯文本，不能带有wikitext或HTML格式，否则可能会出现无法预期的情况，例如<code><nowiki>{{注解|更新|{{黑幕|假的}}}}</nowiki></code>的渲染效果为：<div class="toccolours" style="float:none; padding:0.3em 1em;">{{注解|更新|{{黑幕|假的}}}}</div>
: 这种情况建议直接使用注脚（<code><nowiki><ref></ref></nowiki></code>），例如<code><nowiki>我明天更新<ref>{{黑幕|假的}}</ref>！</nowiki></code>→我明天更新<ref>{{黑幕|假的}}</ref>！
* 为了照顾手机版无法鼠标悬停，本模板在电脑版和手机版上显示效果不同：
** 电脑版：<span style="background-color:#F0FFB3;" title="Beat Per Minute，每分钟节拍数">BPM</span><sup style="display:inline;color:blue;" title="Beat Per Minute，每分钟节拍数">(注)</sup>
** 手机版：<span style="background-color:#F0FFB3;" title="Beat Per Minute，每分钟节拍数">BPM</span><sup style="display:inline;color:blue;" title="Beat Per Minute，每分钟节拍数">(Beat Per Minute，每分钟节拍数)</sup>
:如果注释文字过长，在手机版上可能显示效果不佳，使用时请考虑到这一点。
== 注释 ==
<references />
<!-- 本行下加入模板的分類 -->
<includeonly>[[Category:格式模板]]</includeonly>
<noinclude>[[Category:模板说明文件]]</noinclude>