查看“模板:SfnRef/doc”的源代码

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

Generate an identifier suitable as an [[Template:Citation/doc#Anchors for Harvard referencing templates|anchor for a Harvard citation]]. This template, which can be used with either the name {{tlc|SfnRef}} or the alias {{tlc|harvid}}, is intended to be paired with Harvard citation templates such as {{tlx|Sfnp}}, {{tlx|Sfn}}, {{tlx|Harvp}}, and {{tlx|Harvnb}}. This template uses the same arguments as the other citation templates. As explained below, this template is needed only in some cases when the Harvard citation templates are used.

== Usage ==

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

The first parameter is the first author's last name. Up to four authors can be given as parameters; if there are more than four authors, list only the first four. The last parameter is the year of publication, possibly with a letter suffixed to avoid ambiguity if there are multiple citations by the same set of authors in the same year.

All named parameters such as {{para|p}} are ignored.

==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|Citation}}) and the generic [[Help:Citation Style 2|Citation Style 2]] template {{tlx|Citation}} (as well as {{tlx|Vcite journal}}, {{tlx|Vcite journal}}, {{tlx|Vcite book}} and other templates that generate [[Vancouver system]] references). 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 below, {{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|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.

The {{tl|Vcite journal}} etc. templates (with <code>Vcite</code>, not <code>Cite</code> names) {{em|require}} the use of {{tlc|SfnRef}} to work with {{tnull|Sfn}}, {{tnull|Harvnb}}, and related templates.

{{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 use with Vancouver citation templates (and any other citation styles that do not put dates in parentheses/round-brackets), the matching short-footnote templates are {{tlx|Sfn}} and {{tlx|Harvnb}}.

==Examples==

'''With the shortened footnote template'''

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> }}

{{para|ref|harv}} will not work in this case because "Rolling Stone" is not the name of the author. 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.

'''With other Harvard templates'''

For example, a ''References'' section might contain the following markup:

{{block indent|1=<code><nowiki>{{</nowiki>[[Template:Vcite journal|Vcite journal]]<nowiki> |author=Peh WC, Ng KH |title=Preparing the references |journal=Singapore Medical Journal |volume=50 |issue=7 |pages=659–661 |date=2009 |pmid=19644619 |url=http://smj.sma.org.sg/5007/5007emw1.pdf |format=PDF |ref={{SfnRef|Peh|Ng|2009}} }}</nowiki></code> }}

This markup uses <code><nowiki>{{SfnRef|Peh|Ng|2009}}</nowiki></code> to generate the anchor identifier "{{SfnRef|Peh|Ng|2009}}", used internally to link Harvard references to citations. (This identifier is not visible to the article's reader.) The generated citation looks like this:

{{block indent|1={{Vcite journal |author=Peh WC, Ng KH |title=Preparing the references |journal=Singapore Medical Journal |volume=50 |issue=7 |pages=659–661 |date=2009 |pmid=19644619 |url=http://smj.sma.org.sg/5007/5007emw1.pdf |format=PDF |ref={{SfnRef|Peh|Ng|2009}} }}
}}

==Deprecated inline use==
Running text can link to this citation with markup like the following:
: {{tlx|harv|Peh|Ng|2009}}
which generates the following:
: {{harv|Peh|Ng|2009}}
To see how it works, click on the "{{harv|Peh|Ng|2009}}". 

{{Strong|Note:}} Use of inline parenthetical referencing of that sort within articles has been [[WP:PARENTHETICAL|deprecated by the Wikipedia community]] since 2022. This usage has not been deprecated within internal pages such as Wikipedia documentation, user pages, or wikiprojects, though there is rarely a practical use for it instead of just using normal [[Help:Footnotes|citation footnotes]].

== 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

{{Wikipedia referencing}}

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

[[bn:টেমপ্লেট:SfnRef]]
[[ja:Template:SfnRef]]
[[sl:Template:SfnRef]]
[[simple:Template:SfnRef]]
}}</includeonly>