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

本模板为特性介于{{tl|注解}}和&lt;ref&gt;标签之间的注解模板，需配合{{tl|references}}使用。
==参数==
以下所有参数，名称参数比位置参数优先。
*被注解内容/位置参数1：被注解的文字。
*注解/位置参数2：注解内容。将显示在对应的{{tl|references}}或{{tl|AllReferences}}处。
*组名/位置参数3：注解组名。不填默认为无。
*注解颜色、注解背景、内容颜色、内容背景：顾名思义。

==优缺点==

===优点===
#和{{tl|注解}}模板相比，本模板可以进行注解的分组、更加灵活地调节内容背景颜色。
#和&lt;ref&gt;标签相比，本模板可以使用内容背景对被注解内容进行标注，从而避免了歧义的发生。
#&lt;ref&gt;标签无法{{Ruby|嵌套|套娃}}&lt;ref&gt;标签，{{tl|ref}}模板嵌套又会{{黑幕|因为套娃}}导致阅读体验的降低，使用本模板即可比较美观地实现对注释进行二次注释。
====举例====
源代码：
<pre><nowiki>
*这是被注释内容×1<ref>这是注释×1<ref>这是套娃注释×1</ref></ref>

{{reflist}}
----
*这是被注释内容×2{{ref|这是注释×2{{ref|这是套娃注释×2}}}}

{{reflist}}
----
*{{refer|这是被注释内容×3|这是注释×3{{ref|这是套娃注释×3}}|[注]}}

{{references|[注]}}
{{reflist}}
</nowiki></pre>

输出↓

*这是被注释内容×1<ref>这是注释×1<ref>这是套娃注释×1</ref></ref>

{{reflist}}
----
*这是被注释内容×2{{ref|这是注释×2{{ref|这是套娃注释×2}}}}

{{reflist}}
----
*{{refer|这是被注释内容×3|这是注释×3{{ref|这是套娃注释×3}}|[注]}}

{{references|[注]}}
{{reflist}}

===缺点===
#使用本模板生成的注释没有类似&lt;ref&gt;标签的跳转链接，即查看注释内容只能滚动到{{tl|references}}模板处。如果页面内容过多，完全使用本模板取代&lt;ref&gt;标签将会给浏览带来极大的不便。
#本模板的注解组名默认为无。也就是说，在不指定注释组名时，内容中的注释标记是单一的数字，不够明显。

==使用例==
与{{tl|references}}、{{tl|AllReferences}}的联合使用例：

源代码：
<pre><nowiki>{{refer|something|supp1|supp}}

{{refer|something|empty1}}

*{{refer|something|meow{{n}}|喵|内容背景=pink}}
*{{refer|something|ref|注}}
*{{refer|something|nyaaa{{n}}|喵|注解颜色=magenta}}
*{{refer|something|woof|汪}}
*{{refer|something|{{color|gold|references}}|注}}

以下为注解：

{{references|}}

{{references|supp}}

{{references|喵}}

{{references|注}}

以下是更多文字：
*{{refer|something|squeak|吱}}
*{{refer|something|meow{{n}}|喵}}
*{{refer|something|roar|吱}}

以下是上段文字的全部注解：
{{AllReferences}}
</nowiki></pre>

输出↓

{{refer|something|supp1|supp}}

{{refer|something|empty1}}

*{{refer|something|meow{{n}}|喵|内容背景=pink}}
*{{refer|something|ref|注}}
*{{refer|something|nyaaa{{n}}|喵|注解颜色=magenta}}
*{{refer|something|woof|汪}}
*{{refer|something|{{color|gold|references}}|注}}

以下为注解：

{{references|}}

{{references|supp}}

{{references|喵}}

{{references|注}}

以下是更多文字：
*{{refer|something|squeak|吱}}
*{{refer|something|meow{{n}}|喵}}
*{{refer|something|roar|吱}}

以下是上段文字的全部注解：
{{AllReferences}}