模板:AllReferences
跳到导航
跳到搜索
本模板为特性介于{{注解}}和<references>标签之间的注解模板,需配合{{ref}}使用。
使用本模板时,将为尚未产生references的所有refer产生references。
参数
本模板不接受参数。
使用例
与{{ref}}、{{references}}的联合使用例: 本模板为特性介于{{注解}}和<ref>标签之间的注解模板,需配合{{references}}使用。
参数
以下所有参数,名称参数比位置参数优先。
- 被注解内容/位置参数1:被注解的文字。
- 注解/位置参数2:注解内容。将显示在对应的{{references}}或{{AllReferences}}处。
- 组名/位置参数3:注解组名。不填默认为无。
- 注解颜色、注解背景、内容颜色、内容背景:顾名思义。
优缺点
优点
- 和{{注解}}模板相比,本模板可以进行注解的分组、更加灵活地调节内容背景颜色。
- 和<ref>标签相比,本模板可以使用内容背景对被注解内容进行标注,从而避免了歧义的发生。
- <ref>标签无法
嵌套( )<ref>标签,{{ref}}模板嵌套又会因为套娃导致阅读体验的降低,使用本模板即可比较美观地实现对注释进行二次注释。
举例
源代码:
*这是被注释内容×1<ref>这是注释×1<ref>这是套娃注释×1</ref></ref> {{reflist}} ---- *这是被注释内容×2{{ref|这是注释×2{{ref|这是套娃注释×2}}}} {{reflist}} ---- *{{refer|这是被注释内容×3|这是注释×3{{ref|这是套娃注释×3}}|[注]}} {{references|[注]}} {{reflist}}
输出↓
- 这是被注释内容×1引用错误:没有找到与
</ref>
对应的<ref>
标签</ref>
- 这是被注释内容×2[2]
- 这是被注释内容×3[注]
[注]. 这是注释×3[1]
- ↑ 这是套娃注释×3
缺点
- 使用本模板生成的注释没有类似<ref>标签的跳转链接,即查看注释内容只能滚动到{{references}}模板处。如果页面内容过多,完全使用本模板取代<ref>标签将会给浏览带来极大的不便。
- 本模板的注解组名默认为无。也就是说,在不指定注释组名时,内容中的注释标记是单一的数字,不够明显。
使用例
与{{references}}、{{AllReferences}}的联合使用例:
源代码:
{{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}}
输出↓
somethingsupp
something1
- something喵1
- something注1
- something喵2
- something汪
- something注2
以下为注解:
1. empty1
supp. supp1
喵1. meow1
喵2. nyaaa2
注1. ref
注2. references
以下是更多文字:
- something吱1
- something喵
- something吱2
以下是上段文字的全部注解:
汪. woof
吱1. squeak
吱2. roar
喵. meow3