模板:Ref/doc

这份文档是关于{{ref}}、{{note}}、{{ref label}}和{{note label}}模板的。注释模板用于在文章中插入注释，而引用模板则用于在注释之间放置带标签的引用，这些标签通常是超链接，用于从引用跳转到相应的注释，以及从注释返回到引用。带标签的模板与不带标签名的模板类似，但具有更多功能。

链接和返回链接在内部通过组合指定的参数进行识别。这些模板接受一系列未命名参数，通过它们的位置来识别。它还接受一个命名参数（名为noid），自其引入以来已被弃用。

{{ref}}的第一个参数是一个标签，必须用于相应的{{note}}的参数。该标签用于形成脚注链接和返回链接的片段标识符。{{ref}}的第二个参数是脚注引用标记，显示为上标。最简单的选择是将这两者设为相同，但这不是必需的。如果未提供第二个参数，则标记将是形式为[n]的上标化外部链接。

注意事项

使用 ref / note 标签并不是加入注释的唯一办法。某些人较偏好使用 Cite.php。Cite.php 有许多优点，但并不是强制使用。您可以使用英语维基百科中的 Ref 转换器（Ref converter）将 ref/note 标签换成新的 Cite.php 格式（目前仅限英语维基中的条目，但若您有英语维基的帐户，您可将中文内容贴在英语版您的用户子页面（例如：User:用户名/temp），再到 Ref 转换器中输入“User:用户名/temp”，转换完成后再贴回中文维基百科原条目）。您可参考英语维基百科中的相关讨论（英文）。

参见：Wikipedia:模板消息/条目来源