imported>Diskdance：/* Anchor IDs */

2025-08-17T12:50:19Z

Anchor IDs

新页面

{{NoteTA|G1=MediaWiki}}
{{Documentation subpage}}
{{High-use}}
{{Lua|Module:Footnotes}}
==目的==

于脚注中创建短的[[哈佛参考文献格式]]。详情见[[Wikipedia:Citing sources#Shortened footnotes|「列明來源」]]。特点:
*自动整合相同脚注。
*自动创建到页底该引用的具体信息的链接。锚点只有当你添加了{{para|ref=|harv}}参数到目的模板才会被创建。这个链接只有当参数{{para|last}}、{{para|last2}}和{{para|year}}与{{tl|sfn}}相匹配时才会被创建，或者{{para|ref}}被设置为一个其他的锚点id。

==用法==

<syntaxhighlight lang="wikitext">{{ Sfn | Last name of author(s) | Year | loc = Location in the text }}</syntaxhighlight>

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

*{{para|p|page}}
*{{para|pp|pages}}

; 注意
*第一個參數是作者的姓（last name）。
*可以填寫最多4位作者作為參數（見例子）。如果作者多於4位，請只列出首4位，列出更多作者就会发生奇怪的事情。
*下一個參數是出版年份（the year of publication）。
*年份和作者姓名前后不能有多余的空格，否则生成的链接无效（BUG）。
*The "loc = " parameter is the location of the cited material within the reference. 此參數是選填。
*参数''p''是选填的页码参数; thus "<syntaxhighlight lang="wikitext" inline>{{sfn|Smith|2006| p=25}}</syntaxhighlight>" yields "{{Harvnb|Smith|2006|p=25}}".
*参数''pp''是选填的页码范围参数; thus "<syntaxhighlight lang="wikitext" inline>{{sfn|Smith|2006| pp=25&ndash;26}}</syntaxhighlight>" yields "{{Harvnb|Smith|2006|pp=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 {{tl|Harvnb}} or {{tl|Harvtxt}} in <nowiki><ref></nowiki> tags to achieve a similar effect. E.g. <pre>Jones writes "blah blah".<ref>Quoted in {{Harvnb|Smith|2006|p=25}}.</ref></pre>

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


==例子==

:{| class="wikitable"
|-
! Markup !! Result
|-
| <syntaxhighlight lang="wikitext " inline>句子。{{sfn |Smith|2006| p=25}}</syntaxhighlight>
| 句子。{{sfn |Smith|2006 |p=25}}
|-
| <syntaxhighlight lang="wikitext " inline>句子。{{sfn |Smith|2006| pp=25&ndash;26}}</syntaxhighlight>
| 句子。{{sfn|Smith|2006| pp=25–26}} 引用多页。
|-
| <syntaxhighlight lang="wikitext " inline>句子。{{sfn |Smith|2006| loc=&sect;8.5}}</syntaxhighlight>
| 句子。{{sfn|Smith|2006| loc=§8.5}} 提及引用的段落。
|-
| <syntaxhighlight lang="wikitext " inline>句子。{{sfn |Smith|2006| p=25}}</syntaxhighlight>
| 句子。{{sfn|Smith|2006 |p=25}} 同一页的第二个引用。
|-
| <syntaxhighlight lang="wikitext " inline>句子。{{sfn |Smith|Jones|2006| p=25}}</syntaxhighlight>
| 句子。{{sfn|Smith|Jones|2006| p=25}} 两位作者。
|-
| <syntaxhighlight lang="wikitext " inline>句子。{{sfn |Smith|Jones|Brown|2009| p=25}}</syntaxhighlight>
| 句子。{{sfn|Smith|Jones|Brown|2009| p=25}} 三位作者。
|-
| <syntaxhighlight lang="wikitext " inline>句子。{{sfn |Smith|Jones|Brown|Black|2006| p=25}}</syntaxhighlight>
| 句子。{{sfn|Smith|Jones|Brown|Black|2006| p=25}} 多位作者。
|-
| <syntaxhighlight lang="wikitext " inline>句子。{{sfn |Wallace|1993a| p=25}}下一个句子。{{sfn |Wallace|1993b| p=32}}</syntaxhighlight>
| 句子。{{sfn |Wallace|1993a| p=25}}下一个句子。{{sfn |Wallace|1993b| p=25}} 同一年的不同书籍、论文。
|-
|<syntaxhighlight lang="wikitext">==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
}}
</syntaxhighlight>
|
{{fake heading|Notes}}
{{reflist}}

{{fake heading|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
}}
|}

==Anchor IDs==
This template generates an HTML IDd as an anchor to link the short citation to the full citation.. The {{para|ref|harv}} field is necessary in each of the <syntaxhighlight lang="wikitext " inline>{{cite ...}}</syntaxhighlight> templates to enable the id. The {{tl|citation}} template always generates an id.

If the article cites multiple works by the same author in the same year, then duplicate IDs will be generated. One method to resolve this is to add an alpha suffix to the year. Example: 2009a, 2009b, 2009c.

If works are cited where the author or year is unknown— such as for a web page —then an invalid ID will be generated. To resolve this, create a custom ID:

: <syntaxhighlight lang="wikitext " inline>{{sfn|cite name|year}}</syntaxhighlight>
: <syntaxhighlight lang="wikitext " inline>{{cite ... |ref=CITEREFcite_nameyear }}</syntaxhighlight>

Where ''cite_name'' is a name such as the publisher, and must follow these rules:
* Must begin with a letter A-Z or a-z
* Can be followed by: letters (A-Za-z), digits (0-9), hyphens ("-"), underscores ("_"), colons (":"), and periods (".")
* Spaces in the {{para|ref}} field must be replaced with underscores
* Case-sensitive

===SfnRef===
{{main|Template:SfnRef}}
使用{{tl|SfnRef}}生成{{tl|cite}}系列模板中{{para|ref}}所需要的参数。保证{{tl|sfn}}和{{tl|SfnRef}}中使用同样的值（主要是作者和年份，SfnRef中书籍页数通常不填）：

: <syntaxhighlight lang="wikitext " inline>{{sfn|cite name|year}}</syntaxhighlight>
: <syntaxhighlight lang="wikitext " inline>{{cite ... |ref={{SfnRef|cite name|year}} }}</syntaxhighlight>

Articles using {{tlx|sfn}} should be checked for duplicate IDs with the [http://validator.w3.org/ W3C Markup Validation Service].

==注意==
使用sfn模板時，無需在前後加上<nowiki><ref>和</ref></nowiki>，例如
<syntaxhighlight lang="wikitext">{{sfn|Smith|2006|p=26}}</syntaxhighlight>等於如下原始碼：<syntaxhighlight lang="wikitext"><ref name=Smith200626>{{Harvnb|Smith|2006|p=26}}</ref></syntaxhighlight>

==模板数据==
{{TemplateDataHeader}}
<templatedata>
{
"params": {
"1": {
"description": "第一作者的姓",
"required": true,
"example": "张",
"type": "line",
"suggested": true,
"label": "作者的姓"
},
"2": {
"description": "文献的发表年份，或第二位作者的姓",
"required": true,
"example": "2006",
"type": "string",
"suggested": true,
"label": "年份或第二作者"
},
"3": {
"description": "文献的发表年份，或第三位作者的姓",
"type": "string",
"label": "年份或第三作者"
},
"4": {
"description": "文献的发表年份，或第四位作者的姓",
"type": "string",
"label": "第四作者或年份"
},
"5": {
"description": "文献的发表年份",
"type": "number",
"label": "年份（如已包含四名作者）"
},
"p": {
"description": "相关信息只存在单页时的页码（多页时请用“多篇页码”参数，其他位置数据使用“位置”参数）",
"suggested": true,
"aliases": [
"page"
],
"example": "42",
"type": "line",
"label": "页码"
},
"pp": {
"description": "来源中的多篇页码",
"aliases": [
"pages"
],
"example": "23–24",
"type": "line",
"label": "多篇页码"
},
"ps": {
"description": "补充引用或评论",
"example": "This is an additional comment.",
"type": "string",
"label": "后记"
},
"loc": {
"description": "在来源中的位置",
"example": "section 7",
"type": "line",
"label": "位置"
}
},
"description": "本模板在脚注中创建了一个简短的作者日期引用，它允许你使用哈佛引文（使用括号参考的短引文形式）将内文链接到相应的完整书目引文。",
"format": "inline"
}
</templatedata>

== 相關 ==
* {{tl|cfn}}

;對應
* {{tl|clref}}
* {{tl|citation}}
* {{tl|Harvtxt}}（{{tl|cite book}}）
* {{tl|sfnref}}

<includeonly>{{Sandbox other||
[[Category:短脚注模板]]
}}</includeonly>

Template:Sfn/doc - 版本历史

imported>Diskdance：​/* Anchor IDs */

imported>Diskdance：/* Anchor IDs */