帮助:注释

这篇帮助文档的难度为:普通
这篇帮助文档比较简单,适合有一定基础的编辑者阅读。阅读这篇帮助文档前,您需要掌握一定的Wiki基础知识。

注释是解释字句的文字,可以用于解释文章内容(包括但不限于文字),也可以注明内容出处。即“内容解释”和“来源解释”。

一般而言,注释会在文章内以数字标号的形式显示,在文章末尾(也称“foot”,页脚)列出内容或来源的详情;在补充内容之余保证了整洁的版面,与流畅的阅读体验。

合理使用“内容解释”可以减少文章冗杂成分,提升可读性;合理使用“来源解释”可以方便读者查证,也可以尊重与保护原作者的权利。

用法

在标签<ref></ref>之间的内容,会在<references />的位置一一列出;如果不存在<references />,则注释会被显示在页面末尾。

一般用法示例

一下是一个简单的例子,满足大部分情况下的使用需要。

你知道吗,{{color|green|绵羊}}是个肝帝。<ref>语出MCBBS Wiki编辑群,穹妹</ref>

你知道吗,盐是有毒的。<ref>语出MCBBS Wiki编辑群,盐</ref>

== 注释 ==
<references />

你知道吗,绵羊是个肝帝。[1]

你知道吗,盐是有毒的。[2]

注释

  1. 语出MCBBS Wiki编辑群,穹妹
  2. 语出MCBBS Wiki编辑群,盐

多个位置使用同一注释

以下是这个特殊情况处理办法:多个位置使用同一个注释,需要使用带name属性的<ref>标签。

你知道吗,{{color|green|绵羊}}是个肝帝。<ref name="mashkjo">语出MCBBS Wiki编辑群,穹妹</ref>

求编辑都变成潮流了。<ref name="mashkjo" />

使用 name="" 属性,指定注释。<ref name="aaaa">多次使用同一项注释的时候,系统只承认'''第一次'''的注脚文字</ref>

'''第二次使用的时候,请使用自闭合标签'''。<ref name="aaaa" />

只使用一次的注释没有必要使用 name 属性。<ref>只使用一次的注释只要参照一般写法即可</ref>
== 注释 ==
<references />

你知道吗,绵羊是个肝帝。[1]

求编辑都变成潮流了。[1]

使用 name="" 属性,指定注释。[2]

第二次使用的时候,请使用自闭合标签[2]

只使用一次的注释没有必要使用 name 属性。[3]

注释

  1. 1.0 1.1 语出MCBBS Wiki编辑群,穹妹
  2. 2.0 2.1 多次使用同一项注释的时候,系统只承认第一次的注脚文字
  3. 只使用一次的注释只要参照一般写法即可

注释分组

有时候,注释太多会严重影响文章可读性,这种情况下我们需要给注释分组,以减少阅读障碍。

给注释分组,我们需要用到带group属性的<ref>标签。

{{color|green|绵羊}}是个肝帝。<ref group="sheep">语出MCBBS Wiki编辑群,穹妹</ref>

{{color|green|绵羊}}浑身是肝。<ref group="sheep">语出MCBBS Wiki编辑群,盐</ref>

{{color|green|绵羊}}浑身是宝。<ref group="sheep">语出MCBBS Wiki编辑群,不愿透露姓名人士</ref>

你知道吗,盐是有毒的。<ref group="salt">语出MCBBS Wiki编辑群,盐</ref>

AWSL!<ref group="salt">语出MCBBS Wiki编辑群,穹妹</ref>
== 注释 ==
;关于{{color|green|绵羊}}的言论: 
<references group="sheep" /> 
;关于盐的言论: 
<references group="salt" />

绵羊是个肝帝。[sheep 1]

绵羊浑身是肝。[sheep 2]

绵羊浑身是宝。[sheep 3]

你知道吗,盐是有毒的。[salt 1]

AWSL![salt 2] 注释

关于绵羊的言论:
  1. 语出MCBBS Wiki编辑群,穹妹
  2. 语出MCBBS Wiki编辑群,盐
  3. 语出MCBBS Wiki编辑群,不愿透露姓名人士
关于盐的言论:
  1. 语出MCBBS Wiki编辑群,盐
  2. 语出MCBBS Wiki编辑群,穹妹

特殊用法

在页尾集中编写注释内容

如果希望在注释区(“注释”章节)编辑注释文本,而不是在正文处书写,可以使用带name属性的<ref>标签。

你知道吗,{{color|green|绵羊}}是个肝帝。<ref name="mashkjo" />

求编辑都变成潮流了。<ref name="mashkjo" />

使用 name 属性,指定注释。<ref name="aaaa" />

'''在页尾集中编写的时候,正文部分即使是第一个标签也请使用自闭合标签'''。<ref name="aaaa" />

== 注释 ==
<references>
<ref name="mashkjo">语出MCBBS Wiki编辑群,穹妹</ref>
<ref name="aaaa">正文处仅需使用name属性一致的自闭合的ref标签即可</ref>
</references>

你知道吗,绵羊是个肝帝。[1]

求编辑都变成潮流了。[1]

使用 name 属性,指定注释。[2]

在页尾集中编写的时候,正文部分即使是第一个标签也请使用自闭合标签[2]

注释

  1. 1.0 1.1 语出MCBBS Wiki编辑群,穹妹
  2. 2.0 2.1 正文处仅需使用name属性一致的自闭合的ref标签即可