Template:Sfn/doc

目的

于脚注中创建短的哈佛参考文献格式。详情见「列明來源」。特点:

• 自动整合相同脚注。
• 自动创建到页底该引用的具体信息的链接。锚点只有当你添加了|harv=参数到目的模板才会被创建。这个链接只有当参数|last=、|last2=和|year=与{{sfn}}相匹配时才会被创建，或者|ref=被设置为一个其他的锚点id。

用法

{{ Sfn | Last name of author(s) | Year | loc = Location in the text }}

如果不想用選填的loc參數，可以改用以下參數其中一個：

• |p=page
• |pp=pages

注意

• 第一個參數是作者的姓（last name）。
• 可以填寫最多4位作者作為參數（見例子）。如果作者多於4位，請只列出首4位，列出更多作者就会发生将超出模板支持的参数数量，使短脚注无法正确链接到文末的完整参考文献。但文末的完整引用仍可列出所有作者。
• 下一個參數是出版年份（the year of publication）。
• 年份和作者姓名前后不能有多余的空格，否则生成的链接无效。
• The "loc = " parameter is the location of the cited material within the reference. 此參數是選填。
• 参数p是选填的页码参数; thus "{{sfn|Smith|2006| p=25}}" yields "Smith 2006，第25頁".
• 参数pp是选填的页码范围参数; thus "{{sfn|Smith|2006| pp=25–26}}" yields "Smith 2006，第25–26頁".
• 如果作者在同一年發表了多於一份著作，標準做法是在年份後面加a、b……區別（例如year=2006a 和 year=2006b）。
• If multiple references are made to the same location of the same work, only one footnote is generated.
• 如果需要加入更多注解，use {{Harvnb}} or {{Harvtxt}} in <ref> tags to achieve a similar effect. E.g.

  Jones writes "blah blah".<ref>Quoted in {{Harvnb|Smith|2006|p=25}}.</ref>

(※)注意：编辑本模板时请同步更改{{Harv}}、{{Harvnb}}和{{Harvs}}。

例子

Markup	Result
句子。{{sfn |Smith|2006| p=25}}	句子。
句子。{{sfn |Smith|2006| pp=25–26}}	句子。 引用多页。
句子。{{sfn |Smith|2006| loc=§8.5}}	句子。 提及引用的段落。
句子。{{sfn |Smith|2006| p=25}}	句子。 同一页的第二个引用。
句子。{{sfn |Smith|Jones|2006| p=25}}	句子。 两位作者。
句子。{{sfn |Smith|Jones|Brown|2009| p=25}}	句子。 三位作者。
句子。{{sfn |Smith|Jones|Brown|Black|2006| p=25}}	句子。 多位作者。
句子。{{sfn |Wallace|1993a| p=25}}下一个句子。{{sfn |Wallace|1993b| p=32}}	句子。下一个句子。 同一年的不同书籍、论文。
==Notes== {{reflist}} ==References== * {{Cite book | last = Smith | first = John | year = 2006 | title = Smith's Book | ref = harv }} * {{Cite web | last = Smith | first = John | last2 = Jones | first2 = Sam | title = Smith & Jones website | url = http://en.wikipedia.org | year = 2006 | ref = harv }} * {{Cite news | last = Smith | first = John | last2 = Jones | first2 = Sam | last3 = Brown | first3 = Tom | title = Article by Smith, Jones and Brown | year = 2009 | newspaper = Big Urban Newspaper | ref = harv }} * {{Cite journal | last = Smith | last2 = Jones | last3 = Brown | last4 = Black | year= 2006 | title= Smith, Jones, Brown and Black's Paper | journal = Important Journal | ref = harv }} * {{Cite journal | last = Wallace | first = Bill | year = 1993a | title = Wallace's first paper | journal= Important Journal | ref = harv }} * {{Cite journal | last = Wallace | first = Bill | year = 1993b | title = Wallace's second paper | journal= Another Important Journal | ref = harv }}	Notes References Smith, John. Smith's Book. 2006.  Smith, John; Jones, Sam. Smith & Jones website. 2006.  Smith, John; Jones, Sam; Brown, Tom. Article by Smith, Jones and Brown. Big Urban Newspaper. 2009.  Smith; Jones; Brown; Black. Smith, Jones, Brown and Black's Paper. Important Journal. 2006.  Wallace, Bill. Wallace's first paper. Important Journal. 1993a.  Wallace, Bill. Wallace's second paper. Another Important Journal. 1993b.

锚点 ID

{{sfn}}生成的简短脚注通过HTML的id属性所定义的锚点，链接至参考文献列表中的完整引文。{{cite book}}等{{cite}}系列模板及{{citation}}模板现已默认支持自动生成锚点，因此不再需要手动设置|ref=harv参数。

自动生成的锚点通常由前四位作者的姓氏（如无作者，则可使用编者姓名）及出版年份组成，格式为CITEREF作者姓氏年份。例如，作者为Smith、出版年份为2009年的文献，其锚点通常为CITEREFSmith2009。{{sfn}}中的作者姓名和年份必须与完整引文所生成的锚点相匹配，链接才能正常工作。

如果条目引用了同一作者在同一年发表的多部作品，可能会生成重复的锚点ID，导致简短脚注无法准确链接至对应的完整引文。通常可以在年份后添加小写字母加以区分，例如2009a、2009b、2009c。应确保{{sfn}}及对应完整引文中的年份后缀一致。

对于作者或出版年份不详的文献（例如部分网页），自动生成的锚点可能缺失，或无法与简短脚注正确匹配。此时可以通过|ref=参数设置自定义锚点，并使用机构名称、网站名称或作品标题等作为引用标识。其具体用法见下文。

SfnRef

主页面：Template:SfnRef

{{SfnRef}}用于生成与{{sfn}}相匹配的自定义锚点ID，可作为{{cite}}系列模板或{{citation}}模板中|ref=参数的值。当自动生成的锚点无法满足需要时，例如作者姓名或出版年份不详、不同文献生成相同锚点，或需要使用机构名称代替作者姓名时，可以使用此模板。

使用时，应确保{{sfn}}与{{SfnRef}}中用于生成锚点的参数一致，包括姓名、年份及其后缀。页码或其他文献位置参数（如|p=、|pp=及|loc=）不参与锚点的生成，因此无需传递给{{SfnRef}}。

例如，以机构名称代替作者姓名时：

{{sfn|机构名称|2020}}

{{cite web|url=https://example.org/|title=资料标题|website=网站名称|date=2020|ref={{SfnRef|机构名称|2020}}}}

如果出版年份不详，也可以使用统一的标识（如n.d.，表示无日期），但必须确保简短脚注和自定义锚点所使用的标识一致。

{{sfn|机构名称|n.d.}}

{{cite web|url=https://example.org/|title=资料标题|ref={{SfnRef|机构名称|n.d.}}}}

自定义锚点应遵循以下规则：

• 同一页面中的每个HTML锚点ID必须唯一，以免产生链接冲突。
• ID区分大小写，因此{{sfn}}和{{SfnRef}}中的相应参数应保持一致，包括字母大小写。
• 根据现行HTML标准，ID不能为空，也不得包含ASCII空白字符，但不再要求以英文字母开头，也不再仅限于英文字母、数字及少数标点符号。
• 建议使用{{SfnRef}}自动生成锚点，而非手动拼接CITEREF前缀或处理空格及特殊字符，以确保与简短脚注生成的链接目标一致。

使用{{sfn}}的条目应检查是否存在重复的锚点ID。可以通过Lint错误：重复ID特殊页面查看相关错误，也可以使用W3C标记验证服务检查生成的HTML中是否存在重复ID。

注意

使用sfn模板時，無需在前後加上<ref>和</ref>，例如

{{sfn|Smith|2006|p=26}}

等於如下原始碼：

<ref name=Smith200626>{{Harvnb|Smith|2006|p=26}}</ref>

模板数据

以下是该模板的模板数据，适用于可视化编辑器等工具。

Sfn模板数据

本模板在脚注中创建了一个简短的作者日期引用，它允许你使用哈佛引文（使用括号参考的短引文形式）将内文链接到相应的完整书目引文。

模板参数

此模板首选参数不换行的行内格式。

参数		描述	类型	状态
作者的姓	1	第一作者的姓 示例值 张	单行文本	必需
年份或第二作者	2	文献的发表年份，或第二位作者的姓 示例值 2006	字符串	必需
年份或第三作者	3	文献的发表年份，或第三位作者的姓	字符串	可选
第四作者或年份	4	文献的发表年份，或第四位作者的姓	字符串	可选
年份（如已包含四名作者）	5	文献的发表年份	数字	可选
页码	p page	相关信息只存在单页时的页码（多页时请用“多篇页码”参数，其他位置数据使用“位置”参数） 示例值 42	单行文本	推荐
多篇页码	pp pages	来源中的多篇页码 示例值 23–24	单行文本	可选
后记	ps	补充引用或评论 示例值 This is an additional comment.	字符串	可选
位置	loc	在来源中的位置 示例值 section 7	单行文本	可选

相關

• {{cfn}}

對應

• {{clref}}
• {{citation}}
• {{Harvtxt}}（{{cite book}}）
• {{sfnref}}