帮助:注释

本条目有待完善，当前内容并不完整。 原因在于：

• 可读性不佳

MCBBS Wiki欢迎您帮助我们完善条目。

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

帮助导航

方针 • 命名规范 • 格式规范

新手入门

入门手册 • 上传文件 • 创建个人沙盒 进阶手册 • 移动页面

高级编辑

强制刷新页面 • 插入媒体 • 消歧义页 • 名字空间 • 使用表格 状态开关 • 系统变量 • 解析器函数 模板 • HTML元素标签 • 页内API -> 查看所有帮助 <-

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

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

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

用法

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

一般用法示例

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

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

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

== 注释 ==
<references />

你知道吗，绵羊是个肝帝。

你知道吗，盐是有毒的。

注释

多个位置使用同一注释

以下是这个特殊情况处理办法：多个位置使用同一个注释，需要使用带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 />

你知道吗，绵羊是个肝帝。

求编辑都变成潮流了。

使用 name="" 属性，指定注释。

第二次使用的时候，请使用自闭合标签。

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

注释

注释分组

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

给注释分组，我们需要用到带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" />

绵羊是个肝帝。

绵羊浑身是肝。

绵羊浑身是宝。

你知道吗，盐是有毒的。

AWSL！ 注释

关于绵羊的言论：

关于盐的言论：

特殊用法

在页尾集中编写注释内容

如果希望在注释区（“注释”章节）编辑注释文本，而不是在正文处书写，可以使用带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>

你知道吗，绵羊是个肝帝。

求编辑都变成潮流了。

使用 name 属性，指定注释。

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

注释