模板:References

From 理想城计划

本模板为特性介于{{注解}}和<references>标签之间的注解模板,需配合{{refer}}使用。

参数

  • 组名/位置参数1:注解组名。不填默认为无。

使用例

与{{refer}}、{{AllReferences}}的联合使用例: 本模板为特性介于{{注解}}和<ref>标签之间的注解模板,需配合{{references}}使用。

参数

以下所有参数,名称参数比位置参数优先。

  • 被注解内容/位置参数1:被注解的文字。
  • 注解/位置参数2:注解内容。将显示在对应的{{references}}或{{AllReferences}}处。
  • 组名/位置参数3:注解组名。不填默认为无。
  • 注解颜色、注解背景、内容颜色、内容背景:顾名思义。

优缺点

优点

  1. 和{{注解}}模板相比,本模板可以进行注解的分组、更加灵活地调节内容背景颜色。
  2. 和<ref>标签相比,本模板可以使用内容背景对被注解内容进行标注,从而避免了歧义的发生。
  3. <ref>标签无法{{{1}}}{{{2}}}<ref>标签,{{ref}}模板嵌套又会因为套娃导致阅读体验的降低,使用本模板即可比较美观地实现对注释进行二次注释。

举例

源代码:

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

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

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

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

输出↓

  • 这是被注释内容×1Cite error: Closing </ref> missing for <ref> tag</ref>



  • 这是被注释内容×2[2]
  1. 这是套娃注释×2
  2. 这是注释×2[1]

  • 这是被注释内容×3[注]'"`UNIQ--finalizedvar-0--QINU`"'1'"`UNIQ--finalizedvar-1--QINU`"'

Lua错误 在模块:Loop的第98行:必须设置自增/自减的变量名!

[注]. 这是注释×3[1]

  1. 这是套娃注释×3

缺点

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

使用例

与{{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'"`UNIQ--finalizedvar-2--QINU`"'1'"`UNIQ--finalizedvar-3--QINU`"'

something'"`UNIQ--finalizedvar-4--QINU`"'1'"`UNIQ--finalizedvar-5--QINU`"'

  • something喵'"`UNIQ--finalizedvar-6--QINU`"'1'"`UNIQ--finalizedvar-7--QINU`"'
  • something注'"`UNIQ--finalizedvar-8--QINU`"'1'"`UNIQ--finalizedvar-9--QINU`"'
  • something喵'"`UNIQ--finalizedvar-10--QINU`"'2'"`UNIQ--finalizedvar-11--QINU`"'
  • something汪'"`UNIQ--finalizedvar-12--QINU`"'1'"`UNIQ--finalizedvar-13--QINU`"'
  • something注'"`UNIQ--finalizedvar-14--QINU`"'2'"`UNIQ--finalizedvar-15--QINU`"'

以下为注解:

Lua错误 在模块:Loop的第98行:必须设置自增/自减的变量名!

1. empty1

Lua错误 在模块:Loop的第98行:必须设置自增/自减的变量名!

supp. supp1

Lua错误 在模块:Loop的第98行:必须设置自增/自减的变量名!Lua错误 在模块:Loop的第98行:必须设置自增/自减的变量名!

Lua错误 在模块:Loop的第98行:必须设置自增/自减的变量名!Lua错误 在模块:Loop的第98行:必须设置自增/自减的变量名!

以下是更多文字:

  • something吱'"`UNIQ--finalizedvar-16--QINU`"'1'"`UNIQ--finalizedvar-17--QINU`"'
  • something喵'"`UNIQ--finalizedvar-18--QINU`"'1'"`UNIQ--finalizedvar-19--QINU`"'
  • something吱'"`UNIQ--finalizedvar-20--QINU`"'2'"`UNIQ--finalizedvar-21--QINU`"'

以下是上段文字的全部注解: Lua错误 在模块:Loop的第98行:必须设置自增/自减的变量名!