模板:SfnRef/doc
 | 此页面是Template:SfnRef的模板文档。 此页面可能包含了模板的使用说明、分类和其他内容。 |
 | 此模板文档被引用于约8,700个页面。 为了避免造成大规模的影响，所有对此模板文档的编辑应先于沙盒、测试样例或您的沙盒上测试。 测试后无误的版本可以一次性地加入此模板文档中，但是修改前请务必于讨论页发起讨论。 模板引用数量会自动更新。 |
 | 此模板使用Lua语言： |
此模板用于创建哈佛式引用模板的链接锚点ID。许多条目使用短脚注进行引用，这些脚注通常会链接到页面底部的完整引用。{{SfnRef}}接受与大多数短脚注模板相同的参数[1]，在完整引用的|ref=参数中使用，以创建与短脚注模板匹配的锚点。大多数CS1模板填写|ref=harv参数时会自动生成链接的锚点。在自动生成的锚点出现问题时，可使用本模板手动创建锚点，出现问题的情况包括：
- 作者未知
- 多位作者姓氏相同
- 作者字段包含特殊字符
- 同一位作者在同一年份有多部作品
- 出版年份未知
此外，少部分引用模板，或没有使用引用模板的情况，只能手动创建锚点。[2]
示例
[编辑]引用一篇发表于2004年12月《滚石》（Rolling Stone）杂志且作者不详的文章时，短脚注可写为：
而完整引用的|ref=参数可使用{{SfnRef}}并指定与{{Sfn}}相同的参数：
即完整引用如下：
用法
[编辑]本模板最多接受四个年份和一个出版年份。如果作者超过四位，只列出前四位。最后一个参数是出版年份，如果同一组作者在同一年份有多个文献，可以在年份后附加一个字母（如1996a、1996b）。所有参数均为匿名参数，命名参数无效。
| 引用情况 | Sfnref锚点标记 | 完整引用 | 简短引用 |
|---|---|---|---|
| 作者和日期均存在 | {{SfnRef|Smith|2024}}[3]
|
Smith. Title. Publisher. 2024. | Smith 2024 |
| 多位作者和日期存在 | {{SfnRef |Doe |Pérez |Kowalski |Al-Fulani |2024}}[4]
|
Doe, John; Pérez, Juan; Kowalski, Jan; Al-Fulani, Fulan; Horvat, Ivan; Hudjefa. Title. Publisher. 2024. | Doe et al. 2024 |
| 作者是出版机构 | {{SfnRef|Museum of Modern Art|2024}}
|
Title. Museum of Modern Art. 2024. | Museum of Modern Art 2024 |
{{SfnRef|MoMA|2024}}
|
MoMA (2024). Title. Museum of Modern Art. 2024. | MoMA 2024 | |
| 作者为匿名 | {{SfnRef|Anonymous|2024}}[5]
|
Anonymous. Title. Publisher. 2024. | Anonymous 2024 |
| 作者缺失 | {{SfnRef|''Title''|2024}}
|
Title. Publisher. 2024. | Title 2024 |
{{SfnRef|"Title"|2024}}
|
Title. Work (Publisher). 2024. | "Title" 2024 | |
| 作者同名 |
|
|
|
| 日期缺失 | {{SfnRef|Smith|n.d.}}[6]
|
Smith. Title. Publisher. n.d. | Smith n.d. |
{{SfnRef|Smith}}[7]
|
Smith. Title. Publisher. | Smith | |
| 日期和作者均缺失 | {{SfnRef|[Description]|n.d.}}[8]
|
[Description]. Publisher. n.d. | [Description] n.d. |
用途
[编辑]此模板为引文格式1模板（{{Cite journal}}、{{Cite book}}、{{Cite web}}等）以及通用的引用样式2模板{{Citation}}的|ref=参数创建恰当的值。[9]它旨在与{{Sfnp}}、{{Sfn}}、{{Harvp}}、{{Harvnb}}及相关模板配对使用，并使用相同的参数。如上所述，{{SfnRef}}仅在需要使用这些模板的部分情况下才是必要的。
{{Sfnp}}等短脚注模板会创建到完整引用的链接，但完整引用必须被分配正确的锚点ID才能成为该链接的有效目标。一般情况下在完整引用的模板中添加|ref=harv参数，模板即可根据作者/编者、日期/年份参数自动创建锚点，但某些情况需要自定义锚点，这正是{{SfnRef}}的用途。
当使用引文格式1和2系列的引用模板时，会从前四位作者（如果未指定作者，则使用编者）的姓氏生成默认锚点ID。但是，如果|last=、|author=、|editor-last=或其等效参数均不存在，则在CS1/CS2模板的|ref=参数内使用{{SfnRef}}来创建链接锚点（可能使用出版机构名称、作品标题或其缩写）。
参见
[编辑]{{Wikicite}}– 用于为手动创建的、没有使用引用模板的引用创建锚点
注释
[编辑]- ^ 例如
{{Sfnp}}、{{Sfn}}、{{Harvp}}和{{Harvnb}}。 - ^ 包括{{Cite patent}}、{{Cite comic}}、{{Cite court}}等。未使用引用模板可以使用{{wikicite}}模板分配锚点。
- ^ 此锚点会在CS1引用模板中使用
|last=Smith和|date=2024时自动创建。|author=与|last=作用相同。如果既未使用"last"也未使用"author"，则会使用|editor=或|editor-last=来创建锚点。如果这些参数都未使用，则必须手动创建锚点。 - ^ 此锚点会在CS1引用模板中使用
|last1=Doe、|last2=Pérez等参数以及|Date=2024时自动创建。 - ^ 此锚点会在CS1引用模板中使用
|Author=Anonymous时自动创建。 - ^ 此锚点会在CS1引用模板中使用
|date=n.d.时自动创建。 - ^ 此锚点会在CS1引用模板中
|date=留空时自动创建。 - ^ 此锚点会在CS1引用模板中使用
|date=n.d.和|title=[Description]时自动创建。 - ^ 同样适用于漫画的
{{cite comic}}；美国法院案例的{{cite court}}；以及包裹手动编写引用的{{wikicite}}。