ಟೆಂಪ್ಲೇಟ್:SfnRef/doc
This is a documentation subpage for ಟೆಂಪ್ಲೇಟ್:SfnRef. It may contain usage information, categories and other content that is not part of the original ಟೆಂಪ್ಲೇಟ್ page. |
Generate an identifier suitable as an anchor for a Harvard citation. This template, which can be used with either the name {{SfnRef}}
or the name {{harvid}}
, is intended to be paired with Harvard citation templates such as {{Sfn}}, {{harv}}, and {{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
[ಸಂಪೊಲಿಪುಲೆ]{{SfnRef|Last name of author(s)|Year}}
or
{{harvid|Last name of author(s)|Year}}
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 |p=
are ignored.
Purpose
[ಸಂಪೊಲಿಪುಲೆ]This template creates the proper value for the |ref=
parameter for use with {{cite journal}}, {{cite book}}, {{citation}}, and the other Citation Style 1 and 2 templates, and for use by {{vcite journal}}, {{vcite book}} and other templates that generate Vancouver system references. It is intended to be paired with {{Sfn}} and uses the same arguments. As explained below, {{SfnRef}}
/{{harvid}}
is only necessary in a subset of the cases where {{Sfn}}
is used.
{{Sfn}}
creates a short footnote that is linked to a full footnote. {{Sfn}}
creates the link automatically, but the full footnote must be assigned the proper ID value to be a valid target for that link.
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. A custom ID can be created via the |ref=
parameter. However, if none of |last1=
, |editor-last=
, or their equivalents are used, use {{SfnRef}}
to create the proper value without having to know the rules for how {{Sfn}}
creates the ID.
The {{vcite journal}} etc. templates (with "vcite
", not "cite
") require the use of {{SfnRef}}
/{{harvid}}
to work with Harvard citations.
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:
{{Sfn|Rolling Stone|2004}}
|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 |ref=
parameter manually, or you can use {{SfnRef}}
and specify the same parameters as used with {{Sfn}}
:
{{SfnRef|Rolling Stone|2004}}
The full footnote:
{{cite news |work=[[Rolling Stone]] |title=The RS 500 Greatest Songs of All Time |ref={{SfnRef|Rolling Stone|2004}} |date=December 2004}}
You can copy and paste the {{Sfn}}
template code and change the name of the template from "Sfn" to "SfnRef". If your short footnote includes page numbers such as {{Sfn|Rolling Stone|2004|p=48}}
, you can copy and paste it to create {{SfnRef|Rolling Stone|2004|p=48}}
; the |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:
{{vcite journal |author=Peh WC, Ng KH |title=Preparing the references |journal=Singapore Med J |volume=50 |issue=7 |pages=659–661 |date=2009 |pmid=19644619 |url=http://smj.sma.org.sg/5007/5007emw1.pdf |format=PDF |ref={{harvid|Peh|Ng|2009}} }}
This markup uses {{harvid|Peh|Ng|2009}}
to generate the anchor identifier "CITEREFPehNg2009", used internally to link Harvard references to citations. (This identifier is not visible to the article's reader.) The generated citation looks like this:
Article prose can link to this citation with markup like the following:
{{harv|Peh|Ng|2009}}
which generates the following:
To see how it works, click on the "(Peh & Ng 2009)".
See also
[ಸಂಪೊಲಿಪುಲೆ]- {{citeref}} (a wrapper for
harvid
to create #internal wikilinks with either superscript [n] or plain-text labels to other citations from inside a citation)