模板:Refn

模板文档 编辑文档  编辑模板 刷新

 

这个页面“模板:Refn”是理想城计划的帮助文档

• 本文用于介绍理想城计划中一些特定功能的操作方法；
• 本文仅是一篇论述，不属于方针或指引。如果本指南与相关方针或指引发生冲突或存在不一致的情况，请以方针或指引的条文为准。

注脚是一种标明资料来源、为文章补充注解的方法。注脚一般会在文章内以符号或数字标示出来，然后在文章末端（也就是文章的「脚」的部位），列出所有的补充信息，以及资料来源的详情。注脚能使编者在保持版面整洁之余，得以补充细节，且不影响行文的聚焦。

用法

• 开始标签<ref>和结束标签</ref>之间的文字，会集中在使用模板{{reflist}}的地方列出。若没有{{reflist}}，则所有注脚会被显示在条目页面的结尾。
• 您正在阅读的这个页面就使用了注脚，会显示成这样子：，查阅本页的原始码就可以看见使用注脚功能的实例。

• <ref>标签内无法使用模板subst语法，而且也不能嵌套<ref>标签，所以往往也使用{{refn}}来替代。两者的使用方式完全相同，仅仅是两种不同写法的差异，编者可以自由选择其中之一。

例子如下：

科学家说，太阳是挺大的<ref>张三（2005年）：《太阳》，第23页，香港：学术出版社。</ref>。

不过，月亮就没有那么大了{{refn|李四：《月亮的大小》，载《科学选辑》第46期，第78页，北京：科学研究社。}}。

== 注释 ==
{{reflist}}

显示效果：

科学家说，太阳是挺大的。

不过，月亮就没有那么大了。

注释

需要注意的是，使用本模板时若注释内容含有=、|等会被解析为wikitext的符号时，请使用{{=}}、{{!}}等辅助模板替换此类符号，或是改用<ref></ref>标签。

多处标明同一项注脚

如果想多处标明同一项注脚，请用{{refn|name=Example|...}} 代替<ref>，Example是该注脚的名称。文章后段如果需要参照同一个注脚，您只需再次输入带有Example的注脚就可以了，第二个和以后的注脚里面写的东西不仅不会显示出来，还会导致系统报错。在末端输入斜线可产生空标签：{{refn|name=Example}}。

以下例子使用了同一项注脚三次：

这是多处标明同一项注脚的例子{{refn|name=multiple|请谨记，多次使用同一项注脚，系统只会参照第一次的注脚文字。}}。

这种方法可以表明，同一项注释作出了多项表述{{refn|name=multiple|这裡写的字是多馀的，不仅哪裡都不会显示，还会导致报错文本出现呦。}}。

不填写文本参数即可{{refn|name=multiple}}。

== 注释 ==
{{reflist}}

上述文字码会显示成：

这是多处标明同一项注脚的例子。

这种方法可以表明，同一项注释作出了多项表述。

不填写文本参数即可。

注释

注意：

• name属性不能是单一的数字。
• name属性对大小写和繁简都敏感。
• 删除多项注脚的第一项标签的时候，应当特别留意，以免影响文章后段的一切注脚连结。

参注分组

为了让注释和参考文献的排列更加有条理，推荐将参考和注释分开来为两组。继续使用{{refn|文本}}来表示参考文献，而使用使用{{note|文本}}来表示注释（此处相当于{{refn|group=注|文本}}）。例如：

AAA{{refn|参考a}}BBB{{note|注b}}CCC{{refn|参考c}}
----
;参考文献注脚：
{{reflist}}
;注释注脚：
{{notelist}}

则会显示成：

AAABBBCCC

---

参考文献注脚：

注释注脚：

以下为相关模板及其功能的参考：

参注分组	标注模板	对应的列表模板	标注效果	备注
参考	<ref>..</ref> {{Ref}}={{Refn}}={{Refnest}}={{RefTag}}	{{Reflist}}={{RefFoot}}={{refs}}		<ref>标签本身无法进行嵌套
注解	{{Note}}={{NoteTag}}	{{Notelist}}={{NoteFoot}}={{notes}}

也可以自定义分组的数量和名称。使用-{}-{{refn|group=分组名称|文本}}，group是该注脚的组别，显示成这样。而使用-{}-{{reflist|group=分组名称}}便可把该组的注脚显示。

以下例子使用了两组注脚：

AAA<ref group="A">参考a</ref>BBB<ref group="B">注b</ref>CCC<ref group="A">参考c</ref>
----
;A组注脚：
<references group="A" />
;B组注脚：
<references group="B" />

则会显示成：

AAABBBCCC

---

A组注脚：

B组注脚：

注意：

• group属性对大小写和繁简都敏感。
• 使用{{note}}或自定义分组时必须同时使用对应的列表模板，否则会报引用错误。

注脚文本写在列表区

如果希望在注脚列表区（通常位于注释章节）编辑注脚文本，而不是在条目正文的<ref>处书写，可以使用带name属性的<ref>标签。

即在需要注释的地方用<ref name="x1" />，同时在参考文献章节使用

<references>
<ref name="x1">foo</ref>
<ref name="x2">foo</ref>
……
</references>

便实现注脚集中书写。

每一个<ref>的name值要取一个唯一的名字，除非是需要多处标明同一项注脚。

以下例子使用了两组注脚：

AAA<ref name="ref1" />BBB<ref name="ref2" />CCC<ref name="ref1" />
----
;注脚：
<references>
<ref name="ref1">foo</ref>
<ref name="ref2">bar</ref>
</references>

则会显示成：

AAABBBCCC

---

注脚：

相关模板

{{注解}}

该模板可以将需要注解的文字高亮化，并在鼠标悬停于文字时显示注解（PC版）或在右上角显示注解（移动版）。例如：

-{}-[[更新姬]]没有{{注解|欧派|胸部}}。

更新姬没有欧派^{(注）胸部}。

注意：

• 注解部分仅能使用纯文本而不能带有wikitext或HTML格式。
• 如果注解部分过长，在移动版的显示效果可能较差。
• 该模板的注解不会在<references />中列出。

因此，一般来说请优先使用上文的ref形式，尤其是想在注释中使用格式或注释部分过长时。

{{refer}}

该模板为特性介于{{注解}}和<ref>标签之间的注解模板，需配合{{references}}使用。例如：

-{}-[[更新姬]]没有{{refer|欧派|胸部}}。
{{references}}

更新姬没有欧派^{'"`UNIQ--finalizedvar-0--QINU`"'1'"`UNIQ--finalizedvar-1--QINU`"'}。

1. 胸部

模板中还提供了更多可定制内容，用于不能使用原生注脚的情形。

Cite系列模板

源自维基百科的一系列来源注释模板，包括{{Cite web}}、{{Cite news}}、{{Cite book}}、{{Cite journal}}等，用在ref标签内部，具体用法详见各模板文档。这些模板可以以整齐、统一的格式显示来源信息，在来源较多或条目比较严肃时利于使用，不过需要填写的参数较为复杂，目前并不强制使用或推广。

进入 模板:Refn/doc 页面来编辑这个模板的说明文档。（这个说明框是怎么回事？）
修改完毕后，请刷新上面的文本。