View source for Template:SfnRef/doc

{{Documentation subpage}}
{{High-use}}
{{Template shortcut|sfnref|harvid}}
{{Lua|Module:Footnotes}}
<!-- PLEASE ADD CATEGORIES AND INTERWIKIS AT THE BOTTOM OF THIS PAGE -->

This template creates an identifier that is used as a [[Template:Citation/doc#Anchors for Harvard referencing templates|link anchor for short citations]]. Many articles are cited with [[WP:SFN|shortened footnotes]], which usually [[Help:Shortened footnotes#Linking|link to full citations]] at the bottom of the page. {{tl|SfnRef}} accepts the same parameters as most short citation templates<ref>Such as {{tlx|Sfnp}}, {{tlx|Sfn}}, {{tlx|Harvp}}, and {{tlx|Harvnb}}.</ref> and create matching anchors when used in the {{para|ref}} parameter of the full citation. Most {{cite xxx}} templates will automatically generate the anchor, or landing point, for links. The anchor can be created manually in situations where the automatic anchors would cause issues including:

* Multiple authors with the same last name
* No known last name for the author
* Unusual characters in the author field
* Multiple works in the same year by the same author
* Year of publication unknown

Additionally some less commonly used citation templates, and all full citations written by hand can only be linked to with a manually created anchor.<ref>This is includes {{tl|Cite patent}}, {{tl|Cite comic}}, and {{tl|Cite court}}. Hand-written citations can be assigned an anchor with the {{tl|wikicite}} template.</ref>

==Examples==

When citing an article published in the December 2004 edition of ''Rolling Stone'' where the author is unknown, you might create a short footnote as follows:

{{block indent|1=<code><nowiki>{{Sfn|Rolling Stone|2004}}</nowiki></code> }}

You may code the value for the {{para|ref}} parameter manually, or you can use {{tlc|SfnRef}} and specify the same parameters as used with {{tlc|Sfn}}:

{{block indent|1=<code><nowiki>{{SfnRef|Rolling Stone|2004}}</nowiki></code> }}

The full footnote:

{{block indent|1=<code><nowiki>{{Cite news |work=[[Rolling Stone]] |title=The RS 500 Greatest Songs of All Time |ref={{SfnRef|Rolling Stone|2004}} |date=December 2004}}</nowiki></code>}}

You can copy and paste the {{tlc|Sfn}} template code and change the name of the template from "Sfn" to "SfnRef". If your short footnote includes page numbers such as {{tlc|Sfn|Rolling&nbsp;Stone|2004|p{{=}}48}}, you can copy and paste it to create {{tlc|SfnRef|Rolling&nbsp;Stone|2004|p{{=}}48}}; the {{para|p|48}} parameter is not necessary but will do no harm.

== Usage ==

{{block indent|1=<code><nowiki>{{</nowiki>SfnRef{{!}}{{var|Name}}{{!}}''Year''<nowiki>}}</nowiki></code><br />
<code><nowiki>{{</nowiki>SfnRef{{!}}{{var|Name 1}}{{!}}{{var|Name 2}}{{!}}{{var|Name 3}}{{!}}{{var|Name 4}}{{!}}''Year''<nowiki>}}</nowiki></code>
}}

The template accepts up to four names and a year of publication. If there are more than four authors, list only the first four. The last parameter is the year of publication, optionally with a letter suffixed if there are multiple citations by the same set of authors in the same year. All named parameters, such as {{para|p}} are ignored.

{| class="wikitable"
|+
!Reference
!Sfnref anchor markup
!Full citation
!Short citation 
|-
!Author and date are present
|<code><nowiki>{{SfnRef|Smith|2024}}</nowiki></code><ref>This anchor would be created automatically in [[Help:Citation Style 1|CS1]] citation templates using {{para|last|Smith}} and {{para|date|2024}} in the full citation. {{Para|author}} works the same as {{para|last}}. If neither "last" nor "author" are used, {{para|editor}} or {{para|editor-last}} will be used to create the anchor. If none of these parameters are used, the anchor must be created manually.</ref>
|{{Citation |last=Smith |title=Title |date=2024 |publisher=Publisher |mode=cs1}}
|{{harvnb|Smith|2024}}
|-
!Many authors and date are present
|<code><nowiki>{{SfnRef |Doe |Pérez |Kowalski |Al-Fulani |2024}}</nowiki></code><ref>This anchor would be created automatically in [[Help:Citation Style 1|CS1]] citation templates using {{para|last1|Doe}}, {{para|last2|Pérez}}, and so on, along with {{para|Date|2024}} in the full citation.</ref>
|{{Citation |last1=Doe |first1=John |last2=Pérez |first2=Juan |last3=Kowalski |first3=Jan |last4=Al-Fulani |first4=Fulan |last5=Horvat |first5=Ivan |author6=Hudjefa |title=Title |date=2024 |publisher=Publisher |mode=cs1}}
|{{harvnb|Doe|Pérez|Kowalski|Al-Fulani|2024|2024}}
|-
!rowspan=2 |Author is publisher
|<code><nowiki>{{SfnRef|Museum of Modern Art|2024}}</nowiki></code>
|{{Citation |title=Title |date=2024 |publisher=Museum of Modern Art |ref={{sfnref|Museum of Modern Art|2024}} |mode=cs1}}
|{{harvnb|Museum of Modern Art|2024}}
|-
|<code><nowiki>{{SfnRef|MoMA|2024}}</nowiki></code>
|MoMA (2024). {{Citation |title=Title |date=2024 |publisher=Museum of Modern Art |ref={{sfnref|MoMA|2024}} |mode=cs1}}
|{{harvnb|MoMA|2024}}
|-
!Author is anonymous
|<code><nowiki>{{SfnRef|Anonymous|2024}}</nowiki></code><ref> This anchor would be created automatically in [[Help:Citation Style 1|CS1]] citation templates using {{para|Author|Anonymous}}.</ref>
|{{Citation |last=Anonymous |title=Title |date=2024 |publisher=Publisher |mode=cs1}}
|{{harvnb|Anonymous|2024}}
|-
!rowspan=2 |Author is missing
|<code><nowiki>{{SfnRef|''Title''|2024}}</nowiki></code>
|{{Citation |title=Title |date=2024 |publisher=Publisher |ref={{sfnref|''Title''|2024}} |mode=cs1}}
|{{harvnb|''Title''|2024}}
|-
|<code><nowiki>{{SfnRef|"Title"|2024}}</nowiki></code>
|{{Citation |title=Title |date=2024 |work=Work |publisher=Publisher |ref={{sfnref|"Title"|2024}} |mode=cs1}}
|{{harvnb|"Title"|2024}}
|-
!Authors with the same name
|
* <code><nowiki>{{SfnRef|F. Beauregard|2024}}</nowiki></code>
* <code><nowiki>{{SfnRef|P. Beauregard |2024}}</nowiki></code>
|
*{{Citation |last=Beauregard |first=Fred |title=Title |date=2024 |publisher=Publisher |ref={{sfnref|F. Beauregard|2024}} |mode=cs1}}
* {{Citation |last=Beauregard |first=Paul |title=Title |date=2024 |publisher=Publisher |ref={{sfnref|P. Beauregard|2024}} |mode=cs1}}
|
* {{harvnb|F. Beauregard|2024}}
* {{harvnb|P. Beauregard |2024}}
|-
!rowspan=2 |Date is missing
|<code><nowiki>{{SfnRef|Smith|n.d.}}</nowiki></code><ref>This anchor would be created automatically in [[Help:Citation Style 1|CS1]] citation templates using {{para|date|n.d.}} in the full citation.</ref>
|{{Citation |last=Smith |title=Title |date=n.d. |publisher=Publisher |mode=cs1}}
|{{harvnb|Smith|n.d.}}
|-
|<code><nowiki>{{SfnRef|Smith}}</nowiki></code><ref>This anchor would be created automatically in [[Help:Citation Style 1|CS1]] citation templates leaving {{para|date|<!--none-->}} blank in the full citation.</ref>
|{{Citation |last=Smith |title=Title |publisher=Publisher |mode=cs1}}
|{{harvnb|Smith}}
|-
!Date and author are missing
|<code><nowiki>{{SfnRef|[Description]|n.d.}}</nowiki></code><ref>This anchor would be created automatically in [[Help:Citation Style 1|CS1]] citation templates using {{para|date|n.d.}} and {{para|title|[Description]}} in the full citation.</ref>
|{{Citation |title=[Description] |date=n.d. |publisher=Publisher |ref={{sfnref|[Description]|n.d.}} |mode=cs1}}
|{{harvnb|[Description]|n.d.}}
|}

==Purpose==

This template creates the proper value for the {{para|ref}} parameter of [[Help:Citation Style 1|Citation Style 1]] templates ({{tlx|Cite journal}}, {{tlx|Cite book}}, {{tlx|Cite web}}, etc.) and the generic [[Help:Citation Style 2|Citation Style 2]] template {{tlx|Citation}}.<ref>As well as {{tlx|cite comic}} for comics; {{tlx|cite court}} for U.S. court cases; and {{tlx|wikicite}} which wraps around handwritten citations.</ref> It is intended to be paired with {{tlx|Sfnp}}, {{tlx|Sfn}}, {{tlx|Harvp}}, {{tlx|Harvnb}}, and related templates, and uses the same arguments. As explained above, {{tnull|SfnRef}} is only necessary in a subset of the cases where those are used.

{{tlc|Sfnp}} and its variants create a short footnote that is linked to a full footnote. The templates create the link automatically, but the full footnote must be assigned the proper ID value to be a valid target for that link. This usually happens automatically using the full-citation template's author/editor and date/year parameters, but some cases need a custom anchor, and that is what {{tnull|SfnRef}} is for.

When using the Citation Style 1 and 2 family of citation templates, a default ID is generated from the last names of the first four authors (or editors if there are no authors specified). However, if none of {{para|last}}, {{para|author}}, {{para|editor-last}}, or their equivalents are present, use {{tlc|SfnRef}} inside the CS1/CS2 template's {{para|ref}} parameter to create a link anchor (perhaps using the publisher name or work title or an abbreviation thereof) without having to know the rules for how {{tlc|Sfnp}}, etc., interpret the anchor ID string which is normally auto-generated.

{{Strong|Consistent output:}} For use with CS1/CS2 templates, {{tlx|Sfnp}} and its {{tlx|Harvp}} companion produce the most [[WP:CITESTYLE|consistent citation formatting]].  For other citation styles that do not put dates in parentheses or brackets, matching short-footnote templates include {{tlx|Sfn}} and {{tlx|Harvnb}}.

== See also ==
* {{tlx|sfnref inline}} – a {{tag|span|o}}-based version for use with manually formatted, non-templated citations
* {{tlx|citeref}} – a wrapper for {{tnull|SfnRef}} to create wikilinks with either superscript <sup>[n]</sup> or plain-text labels to other citations from inside a citation

==TemplateData==
{{TemplateData header}}
{{TemplateData needed}}

{{Wikipedia referencing}}

<includeonly>{{Sandbox other||
[[Category:Author–date citation templates]]
[[Category:Footnote templates]]
}}</includeonly>

== Notes ==
{{reflist}}