模板: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}}。