This is an
essay. It contains the advice or opinions of one or more Wikipedia contributors. This page is not an encyclopedia article, nor is it one of
Wikipedia's policies or guidelines, as it has not been
thoroughly vetted by the community. Some essays represent widespread norms; others only represent minority viewpoints. |
This page in a nutshell: A quick intro to using the {{
sfnp}} and {{
harvp}}
shortened-footnotes citation templates. They're not new, but lots of editors haven't figured out how they worked yet, and their official documentation at
Template:Harvard citation documentation is rather geeky. |
The {{
sfnp}}
(for "shortened footnotes, with parenthetical dates") template is a means of concisely citing the same source at different pages many times throughout the same article. In short, something like {{sfnp|Miller|2017|p=37}}
is used to replace something like <ref name="Miller 2017 p37">Miller (2017), p. 37.</ref>
, and will not only link automatically to the full citation (the detailed {{
cite book|last=Miller|first=Dawn|date=2017|title= ...}}
cite), but will also automatically merge duplicate citations to the same source and page! It's great, but not everyone is fully up-to-speed on how to use it, so below is a crash course in getting it to work and avoiding problems. There are a number variations on this template, distinguished below. The full-length citation is usually put at the bottom of the page; there are several ways of doing this, also covered below.
{{
sfnp}}
– Replaces a <
ref>...</ref>
with a shortened footnote in it which links to the full-length citation. Designed to be
in a consistent citation style with the full citations generated by the
CS1 ({{
Cite book}}
, {{
Cite journal}}
, etc.) and
CS2 ({{
Citation}}
) templates. Example: {{sfnp|Miller|2017|p=37}}
.{{
harvp}}
– Same as {{
sfnp}}
except used inside a <
ref>
to provide a link to the full cite, plus additional annotations which can include more such templates, as in: <ref>{{harvp|Miller|2017|p=37}}. The classification system decribed there is a simplification of that first published in {{harvp|Chen|Gonzales|1999|pp=127–128}}.</ref>
{{
sfn}}
or {{
sfnnb}}
– No brackets/parentheses version of {{sfnp}}
. This is appropriate for use with citation styles that do not put parentheses/round-brackets around dates, such as the
Vancouver system (which is very disused in Wikipedia). Unfortunately, because {{sfn}}
was developed first and has a shorter name and is mentioned in more of our documentation, it is often mistaken to be the "default" or the "normal" option, but should actually be replaced with {{sfnp}}
in any article using CS1/CS2 citations.{{
harvnb}}
– No brackets/parentheses variant of {{harvp}}
to go along with {{sfn}}
, for use with citation styles like Vancouver that require no parentheses/round-brackets around dates. In most articles, should be replaced with {{harvp}}
.Several templates in this family are deprecated and should be replaced with other citation methods when encountered in articles:
|
---|
All of the following were used for inline parenthetical referencing, which puts citation information directly into the main article text. This practice (done with or without any template) was deprecated by the Wikipedia community in 2022, as creating too much reader-distracting clutter.
|
There are also multi-citation versions of these, for bundling multiple reference citations for the same claim into a single [1]-style footnote. These are complicated and beyond the scope of this primer, but they are listed here for future reference:
{{
sfnmp}}
– Multi-citation version of {{sfnp}}
; does not require a <ref>...</ref>
.{{
sfnm}}
or {{
sfnmnb}}
– Multi-citation version of {{sfn}}
; i.e., it is {{sfnmp}}
without the parentheses, for Vancouver-style citations.{{
multiref}}
– A simple multi-citation list wrapper that can be used with several {{harvp}}
(or {{harvnb}}
) instances.{{
harvc}}
– Specialized multi-citation template, used inside <ref>...</ref>
, for citing multiple authors' different contributions to the same edited volume; defaults to CS1/CS2-style dates by default (for Vancouver-style, add |nb=yes
).{{sfnp|Miller|2017|p=37}}
or for multiple pages: {{sfnp|Miller|2017|pp=37, 39–40}}
. Output: Miller (2017), pp. 37, 39–40.
|
), a date, and a |p=
or |pp=
parameter for the page number(s).{{harvp}}
is the same, but inside <ref>...</ref>
: <ref>{{harvp|Miller|2018|p=37}}. Additional notes here.</ref>
This is often used for providing a quotation from the page cited.
{{harvp}}
(or Vancouver variant {{harvnb}}
) will not add a .
at the end, so one has to be added manually where appropriate. {{sfnp}}
(and Vancouver variant {{sfn}}
) will automatically add a .
{{sfnp}}
supported a |ps=
that can theoretically be used for adding quotations or other annotations; however,
it is broken and has been deprecated and should not be used. (If two citations to the same page have |ps=
(as in {{sfnp|Miller|2017|p=37|ps="Quote 1."}}
then {{sfnp|Miller|2017|p=37|ps="Quote 2."}}
) then a big red error message will result. Thus, it is recommended to use the {{harvp}}
method for such things.{{sfnp|Chen|Jones|López-Garcia|Le Fevre|2021|p=99|loc=footnote 7}}
. Output: Chen et al. (2021), p. 99, footnote 7.
|loc=
parameter is optional and can also be used in place of, instead of along with, |p=
or its plural form |pp=
: {{
sfnp|Chen|Jones|López-Garcia|Le Fevre|2021|loc=errata sheet}}
{{sfn|2017|Eshkol|Levitov}}
will fail. Doing something like {{sfn|Eshkol, David|Levitov, Irina M.|2017}}
or {{sfn|Eshkol D|Levitov IM|2017}}
will fail.
|ref={{
sfnref|...}}
to create a custom anchor name.sfnp
/harvp
is 4, no matter how many authors the work has specified in the full-length citation. If you put in 5 or more, the template will throw a red error message. (This applies to {{
sfnp}}
, {{
harvp}}
, and all their variants.)
{{
sfnp|Chen|Jones|López-Garcia|2021|p=32}}
will not work because |Le Fevre
is missing.
{{sfnp|Chen et al.|2021|p=32}}
, see the section below on using |ref={{
sfnref|...}}
to create a custom anchor name.{{Cite journal |last1=Chen |first1=Amy B. |last2=Jones |first2=C. D. |last3=López-Garcia |first3=Carlos |last4=Le Fevre |first4=Jean-Paul |last5= ... |date=2021 ...}}
, matches with a specific-page citation like {{sfnp|Chen|Jones|López-Garcia|Le Fevre|2021|p=23}}
{{Citation |last1=Chen |first1=Amy B. |last2=Jones |first2=C. D. |last3=López-Garcia |first3=Carlos |last4=Le Fevre |first4=Jean-Paul |last5= ... |date=2021 ...}}
{{
Citation}}
are inconsistent injections of this sort into CS1 articles; the proportion (and probably also the raw number) of articles consistently templated in CS2 is decreasing all the time).|vauthors=
approach to specifying the authors, as long as it's actually coded in the proper format: {{Cite journal |vauthors=Chen AB, Jones CD, López-Garcia C, Le Fevre J-P, ... |date=2021 ...}}
|last1=
|first1=
, etc. (preferably with full author names instead of initials if known), when |vauthors=
is encountered in a article that is not consistetly using
Vancouver-style citations, which is almost all of the cases at this point. (Few articles remain using Vancouver consistently, but editors who are fans of that style commonly go around wrongly injecting it into articles that do not use it, which is against
WP:CITESTYLE).|editor1-last=
, etc. as author names for this purpose if there are no |last1=
, etc. If there are one or more specified authors, then any editor names are ignored (they do not concatenate onto the author(s) list).|last=
, |author=
, and |author1=
(and the rare |author-last=
, |author1-last=
, and |author-last1=
) are all aliases of |last1=
, and so forth. |editor-last=
, |editor=
, |editor-last1=
, |editor1=
are all aliases of |editor1-last=
, and so on.|author=
is typically used (or |editor=
, or numbered version of either of these); this works the same as a surname with these short-citation templates.|ref={{
sfnref|...}}
to build a custom name for {{sfnp}}
/{{harvp}}
to use (typically based on name of publication or publisher).|display-authors=etal
, to output "et al." after the last specified author name, is not detected or supported. If the citation is {{cite book |last=Adebayo |first=Mohamed |display-authors=etal |date=1997 ...}}
, this must be short-cited like {{
sfnp|Adebayo|1991|p=23}}
.{{
sfnp}}
and related templates have nothing to do with what is in <
ref name="...">
, only the surnames specified inside the full-length citation template. If you have <ref name="DeBroglieMacDuff2019">{{cite web |last1=De Broglie |first1=Matt |last2=MacDuff Samuelson |first2=Jennifer B. |date=2019 ...}}
, this would be short-cited like {{
sfnp|De Broglie|MacDuff Samuelson|2019}}
.
<ref name="DeBroglie & MacDuff Samuelson 2019">
. Note that the quotation marks are mandatory because of spaces and non-alphanumeric ASCII characters. The lazy practice of doing <ref name=DeBMacDS2019>
with very simple ref names that do not contain spaces, punctuation, or other special characters is a terrible idea because someone else is reasonably likely to clean up such messy refs later and may forget the quotation marks and break the citation. Even doing <ref name=DeB-MacDS-2019>
is technically invalid markup, though few editors realize it (MW seems to generally handle it okay, but this cannot be guaranteed in future versions because it's against
the documented requirements of <
ref>
). Every time it is encountered, <ref name=foo>
should be converted to <ref name="foo">
(though as part of a more substantive edit per
WP:COSMETICBOT).|ref={{
sfnref|...}}
comes in. If you have {{cite book |last=Tāwhiri |first=Koa |date=2023 ...}}
and {{cite journal |last=Tāwhiri |first=Moana |date=2023 ...}}
, the solution is this: {{cite book |last=Tāwhiri |first=Koa |date=2023 ... |ref={{sfnref|Tāwhiri|2023a}} }}
and {{cite journal |last=Tāwhiri |first=Moana |date=2023 ... |ref={{sfnref|Tāwhiri|2023b}} }}
, each short-cited as {{sfnp|Tāwhiri|2023a|pp=vi–ix}}
and {{sfnp|Tāwhiri|2023b|p=42}}
, respectively.
{{cite book |last=Tāwhiri |first=Koa |date=2023 ... |ref={{sfnref|Tāwhiri, K.|2023}} }}
and {{cite journal |last=Tāwhiri |first=Moana |date=2023 ... |ref={{sfnref|Tāwhiri, M.|2023}} }}
, each short-cited as {{sfnp|Tāwhiri, K.|2023|pp=vi–ix}}
and {{sfnp|Tāwhiri, M.|2023|p=42}}
, respectively. Doing both forms of disambiguation at once is not helpful. The name disambiguation is often helpful any time there are two authors by the same surname in the same article, even if the publication years do not collide.|year=
parameter as a form of disambiguation: {{cite book |last=Tāwhiri |first=Koa |year=2023a ...}}
, which would work with {{
sfnref|Tāwhiri|2023a|p=vi–ix}}
, but it pollutes the long-form citation's date output with an invalid year string: Tāwhiri, Koa (2022a) The
kluge to repair that was to do: {{cite book |last=Tāwhiri |first=Koa |year=2023a |date=2023 ...}}
. But this was all a case of the tail wagging the dog, the code forcing human editors to do confusing things that abuse template parameters for side purposes that don't match their citation-information intent. Worse, non-expert editors are apt to think that |year=2023a
|date=2023
is an error and "fix" it to just |date=2023
, thereby breaking short cites to that source. The |ref=
parameter was introduced to make such easily broken hoop-jumping unnecessary. Instances of |year=2023a
, with or without the compensating |date=2023
should be replaced with |date=2023
and an {{
sfnref}}
(also often called by the alias {{
harvid}}
) inside a {{
ref}}
. NB: Using |date=
instead of |year=
is universally better, because |date=
also handles bare years along with fuller dates, and editors who encounter a |year=2023
but see a full date in the cited work when verifying it are apt to improve the citation by giving the full date; |year=
is simply obsolete.|ref={{
sfnref|...}}
. If you have {{cite report |editor1-last=Yi |editor1-first=Xiu-Yīng |editor2=Committee on Reptile and Amphbian Nomenclature |date=2023 |publisher=World Herpetological Society ...}}
, you can add |ref={{sfnref|Yi|CRAN|2015}}
, and cite it as, e.g., {{sfnp|Yi|CRAN|2015|loc=§ Subspecies}}
.|ref={{sfnref|...}}
, e.g.: <ref>{{cite web |title=The snapd roadmap |date=2024 |url= https://snapcraft.io/docs/snapd-roadmap |website=SnapCraft.io |publisher=[[Canonical (company)|Canonical]] |access-date=13 January 2024 |ref={{sfnref|Canonical|2024}} }}
(or perhaps |ref={{sfnref|SnapCraft|2024}}
), then use {{sfnp|Canonical|2024|loc="snapd 2.58"}}
(or {{sfnp|SnapCraft|2024|loc="snapd 2.58"}}
, as the case may be).
|author=
(a.k.a. |last=
), just to force the templates to work. This pollutes both the visual and
metadata output of the citation with a false author claim. (Trying the "Staff" trick will now throw a maintenance warning message, though it is hidden from readers; editors have to use
user CSS to turn on visibility of most CS1/CS2 cleanup warnings other than severe errors, and this is
highly recommendable for all editors.) If you encounter anything like this, please fix it by removing the pseudo-author and using |ref={{sfnref|...}}
.{{
Vcite journal}}
, {{
Vcite journal}}
, {{
Vcite book}}
, etc.), which are rare but still occasionally found, cannot be used at all with {{
sfnp}}
, etc., without adding |ref={{sfnref|...}}
to them. Yet another reason to not use that citation style. Here's another: A citation like {{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}}
produces almost impenetrable gibberish output: "Peh WC, Ng KH. Preparing the references. Singapore Medical Journal. 2009;50(7):659–661.
PMID
19644619." – take note of that "2009;50(7):659–661" mess, which is only parseable by experts in Vancouver citation style, which is not more than probably 0.000001% of our readership. If you encounter an article using this citation style, consider proposing changing it to CS1 on the article's talk page, or just
doing it boldly if the citation style is not used consistently in the article.<
ref>
nor cited by anything like {{sfnp}}
, {{harvp}}
, etc. This is useful for identifying sources that have become "orphaned", e.g. because material that included short citations to them was deleted. But sometimes articles have some
"general references" that have been used to source part of the article content without an inline cite yet, and the article may also have a "
Further reading" section, in either/both cases with entries formatted using CS1/CS2 templates. Display of the recurrent big red error message on such citations ("Harv error: link from CITEREFMcDougall2011 doesn't point to any citation.", etc.) can be suppressed by adding |ref=none
to the citation. This should not be done on citations that are actually used inline in the article, directly or by way of short citations, since it will make them not addressable by any short citations. Since this error-hiding is cosmetic (not a reader-facing change and not required maintenance), it should be done as part of a more substantive edit, per
WP:COSMETICBOT. PS: There are other versions of the HarvErrors script, such as the one by Trappist the Monk (listed in the nutshell at the top of
User:Ucucha/HarvErrors), which hide these messages in "External links" and "Further reading" if you want to neither see them nor do anything about them.Sources reused with multiple citations on different pages are usually placed at the bottom of the article instead of kept inline. There are several ways of doing this that vary on an article-by-article basis:
==References==
and its {{
reflist}}
or <
references>
(which generate the short footnotes along with full citations cited only once), add a subheading such as ===Citations===
, ===Works cited===
, or ===Bibliography===
(the last is not recommendable for author bios, since it will seem to be about their own works, and there likely will already be a section by that name). Under this new subheading, use a bullet list with *
to add each of the full citations ({{
cite journal}}
, {{
cite book}}
, etc.) that are being used more than once, one per list line, and without a <
ref>...</ref>
around it. Putting {{
refbegin}}
above and {{
refend}}
below this list is optional; it makes this citation text more consistent with the auto-generated citations.
==Level-2 section==
for this instead of a level-3 subsection, and sometimes when this is done changing the standard "References" (which is used in over 95% of our articles) to something else like "Citations". Neither of these practices are helpful; they just makes our articles less consistent and more confusing to readers.{{reflist}}
or <
references>
, put {{refbegin}}
, your list of multi-cited sources, formatted as above, and then {{refend}}
.<
ref>...</ref>
, and these are in turn placed inside, not below, an extended {{reflist|1=...}}
or <
references>...</references>
. Each is just put on its own line (or sometimes formatting in the vertical multi-line style), with no *
markup. This is the most complicated option and not very popular.Technically speaking, you can do it all inline without anything actually breaking. E.g.: Article text here.<ref>{{cite book |last=Hughes |first=J. B. |date=2013 ... |page=117}}</ref> More article text here.{{sfnp|Hughes|2013|p=122}}</ref>
. However, many editors will consider this sloppy and may move the long cite (sans the page number) to the bottom of the article and replace its original instance with another page-specific short cite, {{sfnp|Hughes|2013|p=117}}
in this case.
This is an
essay. It contains the advice or opinions of one or more Wikipedia contributors. This page is not an encyclopedia article, nor is it one of
Wikipedia's policies or guidelines, as it has not been
thoroughly vetted by the community. Some essays represent widespread norms; others only represent minority viewpoints. |
This page in a nutshell: A quick intro to using the {{
sfnp}} and {{
harvp}}
shortened-footnotes citation templates. They're not new, but lots of editors haven't figured out how they worked yet, and their official documentation at
Template:Harvard citation documentation is rather geeky. |
The {{
sfnp}}
(for "shortened footnotes, with parenthetical dates") template is a means of concisely citing the same source at different pages many times throughout the same article. In short, something like {{sfnp|Miller|2017|p=37}}
is used to replace something like <ref name="Miller 2017 p37">Miller (2017), p. 37.</ref>
, and will not only link automatically to the full citation (the detailed {{
cite book|last=Miller|first=Dawn|date=2017|title= ...}}
cite), but will also automatically merge duplicate citations to the same source and page! It's great, but not everyone is fully up-to-speed on how to use it, so below is a crash course in getting it to work and avoiding problems. There are a number variations on this template, distinguished below. The full-length citation is usually put at the bottom of the page; there are several ways of doing this, also covered below.
{{
sfnp}}
– Replaces a <
ref>...</ref>
with a shortened footnote in it which links to the full-length citation. Designed to be
in a consistent citation style with the full citations generated by the
CS1 ({{
Cite book}}
, {{
Cite journal}}
, etc.) and
CS2 ({{
Citation}}
) templates. Example: {{sfnp|Miller|2017|p=37}}
.{{
harvp}}
– Same as {{
sfnp}}
except used inside a <
ref>
to provide a link to the full cite, plus additional annotations which can include more such templates, as in: <ref>{{harvp|Miller|2017|p=37}}. The classification system decribed there is a simplification of that first published in {{harvp|Chen|Gonzales|1999|pp=127–128}}.</ref>
{{
sfn}}
or {{
sfnnb}}
– No brackets/parentheses version of {{sfnp}}
. This is appropriate for use with citation styles that do not put parentheses/round-brackets around dates, such as the
Vancouver system (which is very disused in Wikipedia). Unfortunately, because {{sfn}}
was developed first and has a shorter name and is mentioned in more of our documentation, it is often mistaken to be the "default" or the "normal" option, but should actually be replaced with {{sfnp}}
in any article using CS1/CS2 citations.{{
harvnb}}
– No brackets/parentheses variant of {{harvp}}
to go along with {{sfn}}
, for use with citation styles like Vancouver that require no parentheses/round-brackets around dates. In most articles, should be replaced with {{harvp}}
.Several templates in this family are deprecated and should be replaced with other citation methods when encountered in articles:
|
---|
All of the following were used for inline parenthetical referencing, which puts citation information directly into the main article text. This practice (done with or without any template) was deprecated by the Wikipedia community in 2022, as creating too much reader-distracting clutter.
|
There are also multi-citation versions of these, for bundling multiple reference citations for the same claim into a single [1]-style footnote. These are complicated and beyond the scope of this primer, but they are listed here for future reference:
{{
sfnmp}}
– Multi-citation version of {{sfnp}}
; does not require a <ref>...</ref>
.{{
sfnm}}
or {{
sfnmnb}}
– Multi-citation version of {{sfn}}
; i.e., it is {{sfnmp}}
without the parentheses, for Vancouver-style citations.{{
multiref}}
– A simple multi-citation list wrapper that can be used with several {{harvp}}
(or {{harvnb}}
) instances.{{
harvc}}
– Specialized multi-citation template, used inside <ref>...</ref>
, for citing multiple authors' different contributions to the same edited volume; defaults to CS1/CS2-style dates by default (for Vancouver-style, add |nb=yes
).{{sfnp|Miller|2017|p=37}}
or for multiple pages: {{sfnp|Miller|2017|pp=37, 39–40}}
. Output: Miller (2017), pp. 37, 39–40.
|
), a date, and a |p=
or |pp=
parameter for the page number(s).{{harvp}}
is the same, but inside <ref>...</ref>
: <ref>{{harvp|Miller|2018|p=37}}. Additional notes here.</ref>
This is often used for providing a quotation from the page cited.
{{harvp}}
(or Vancouver variant {{harvnb}}
) will not add a .
at the end, so one has to be added manually where appropriate. {{sfnp}}
(and Vancouver variant {{sfn}}
) will automatically add a .
{{sfnp}}
supported a |ps=
that can theoretically be used for adding quotations or other annotations; however,
it is broken and has been deprecated and should not be used. (If two citations to the same page have |ps=
(as in {{sfnp|Miller|2017|p=37|ps="Quote 1."}}
then {{sfnp|Miller|2017|p=37|ps="Quote 2."}}
) then a big red error message will result. Thus, it is recommended to use the {{harvp}}
method for such things.{{sfnp|Chen|Jones|López-Garcia|Le Fevre|2021|p=99|loc=footnote 7}}
. Output: Chen et al. (2021), p. 99, footnote 7.
|loc=
parameter is optional and can also be used in place of, instead of along with, |p=
or its plural form |pp=
: {{
sfnp|Chen|Jones|López-Garcia|Le Fevre|2021|loc=errata sheet}}
{{sfn|2017|Eshkol|Levitov}}
will fail. Doing something like {{sfn|Eshkol, David|Levitov, Irina M.|2017}}
or {{sfn|Eshkol D|Levitov IM|2017}}
will fail.
|ref={{
sfnref|...}}
to create a custom anchor name.sfnp
/harvp
is 4, no matter how many authors the work has specified in the full-length citation. If you put in 5 or more, the template will throw a red error message. (This applies to {{
sfnp}}
, {{
harvp}}
, and all their variants.)
{{
sfnp|Chen|Jones|López-Garcia|2021|p=32}}
will not work because |Le Fevre
is missing.
{{sfnp|Chen et al.|2021|p=32}}
, see the section below on using |ref={{
sfnref|...}}
to create a custom anchor name.{{Cite journal |last1=Chen |first1=Amy B. |last2=Jones |first2=C. D. |last3=López-Garcia |first3=Carlos |last4=Le Fevre |first4=Jean-Paul |last5= ... |date=2021 ...}}
, matches with a specific-page citation like {{sfnp|Chen|Jones|López-Garcia|Le Fevre|2021|p=23}}
{{Citation |last1=Chen |first1=Amy B. |last2=Jones |first2=C. D. |last3=López-Garcia |first3=Carlos |last4=Le Fevre |first4=Jean-Paul |last5= ... |date=2021 ...}}
{{
Citation}}
are inconsistent injections of this sort into CS1 articles; the proportion (and probably also the raw number) of articles consistently templated in CS2 is decreasing all the time).|vauthors=
approach to specifying the authors, as long as it's actually coded in the proper format: {{Cite journal |vauthors=Chen AB, Jones CD, López-Garcia C, Le Fevre J-P, ... |date=2021 ...}}
|last1=
|first1=
, etc. (preferably with full author names instead of initials if known), when |vauthors=
is encountered in a article that is not consistetly using
Vancouver-style citations, which is almost all of the cases at this point. (Few articles remain using Vancouver consistently, but editors who are fans of that style commonly go around wrongly injecting it into articles that do not use it, which is against
WP:CITESTYLE).|editor1-last=
, etc. as author names for this purpose if there are no |last1=
, etc. If there are one or more specified authors, then any editor names are ignored (they do not concatenate onto the author(s) list).|last=
, |author=
, and |author1=
(and the rare |author-last=
, |author1-last=
, and |author-last1=
) are all aliases of |last1=
, and so forth. |editor-last=
, |editor=
, |editor-last1=
, |editor1=
are all aliases of |editor1-last=
, and so on.|author=
is typically used (or |editor=
, or numbered version of either of these); this works the same as a surname with these short-citation templates.|ref={{
sfnref|...}}
to build a custom name for {{sfnp}}
/{{harvp}}
to use (typically based on name of publication or publisher).|display-authors=etal
, to output "et al." after the last specified author name, is not detected or supported. If the citation is {{cite book |last=Adebayo |first=Mohamed |display-authors=etal |date=1997 ...}}
, this must be short-cited like {{
sfnp|Adebayo|1991|p=23}}
.{{
sfnp}}
and related templates have nothing to do with what is in <
ref name="...">
, only the surnames specified inside the full-length citation template. If you have <ref name="DeBroglieMacDuff2019">{{cite web |last1=De Broglie |first1=Matt |last2=MacDuff Samuelson |first2=Jennifer B. |date=2019 ...}}
, this would be short-cited like {{
sfnp|De Broglie|MacDuff Samuelson|2019}}
.
<ref name="DeBroglie & MacDuff Samuelson 2019">
. Note that the quotation marks are mandatory because of spaces and non-alphanumeric ASCII characters. The lazy practice of doing <ref name=DeBMacDS2019>
with very simple ref names that do not contain spaces, punctuation, or other special characters is a terrible idea because someone else is reasonably likely to clean up such messy refs later and may forget the quotation marks and break the citation. Even doing <ref name=DeB-MacDS-2019>
is technically invalid markup, though few editors realize it (MW seems to generally handle it okay, but this cannot be guaranteed in future versions because it's against
the documented requirements of <
ref>
). Every time it is encountered, <ref name=foo>
should be converted to <ref name="foo">
(though as part of a more substantive edit per
WP:COSMETICBOT).|ref={{
sfnref|...}}
comes in. If you have {{cite book |last=Tāwhiri |first=Koa |date=2023 ...}}
and {{cite journal |last=Tāwhiri |first=Moana |date=2023 ...}}
, the solution is this: {{cite book |last=Tāwhiri |first=Koa |date=2023 ... |ref={{sfnref|Tāwhiri|2023a}} }}
and {{cite journal |last=Tāwhiri |first=Moana |date=2023 ... |ref={{sfnref|Tāwhiri|2023b}} }}
, each short-cited as {{sfnp|Tāwhiri|2023a|pp=vi–ix}}
and {{sfnp|Tāwhiri|2023b|p=42}}
, respectively.
{{cite book |last=Tāwhiri |first=Koa |date=2023 ... |ref={{sfnref|Tāwhiri, K.|2023}} }}
and {{cite journal |last=Tāwhiri |first=Moana |date=2023 ... |ref={{sfnref|Tāwhiri, M.|2023}} }}
, each short-cited as {{sfnp|Tāwhiri, K.|2023|pp=vi–ix}}
and {{sfnp|Tāwhiri, M.|2023|p=42}}
, respectively. Doing both forms of disambiguation at once is not helpful. The name disambiguation is often helpful any time there are two authors by the same surname in the same article, even if the publication years do not collide.|year=
parameter as a form of disambiguation: {{cite book |last=Tāwhiri |first=Koa |year=2023a ...}}
, which would work with {{
sfnref|Tāwhiri|2023a|p=vi–ix}}
, but it pollutes the long-form citation's date output with an invalid year string: Tāwhiri, Koa (2022a) The
kluge to repair that was to do: {{cite book |last=Tāwhiri |first=Koa |year=2023a |date=2023 ...}}
. But this was all a case of the tail wagging the dog, the code forcing human editors to do confusing things that abuse template parameters for side purposes that don't match their citation-information intent. Worse, non-expert editors are apt to think that |year=2023a
|date=2023
is an error and "fix" it to just |date=2023
, thereby breaking short cites to that source. The |ref=
parameter was introduced to make such easily broken hoop-jumping unnecessary. Instances of |year=2023a
, with or without the compensating |date=2023
should be replaced with |date=2023
and an {{
sfnref}}
(also often called by the alias {{
harvid}}
) inside a {{
ref}}
. NB: Using |date=
instead of |year=
is universally better, because |date=
also handles bare years along with fuller dates, and editors who encounter a |year=2023
but see a full date in the cited work when verifying it are apt to improve the citation by giving the full date; |year=
is simply obsolete.|ref={{
sfnref|...}}
. If you have {{cite report |editor1-last=Yi |editor1-first=Xiu-Yīng |editor2=Committee on Reptile and Amphbian Nomenclature |date=2023 |publisher=World Herpetological Society ...}}
, you can add |ref={{sfnref|Yi|CRAN|2015}}
, and cite it as, e.g., {{sfnp|Yi|CRAN|2015|loc=§ Subspecies}}
.|ref={{sfnref|...}}
, e.g.: <ref>{{cite web |title=The snapd roadmap |date=2024 |url= https://snapcraft.io/docs/snapd-roadmap |website=SnapCraft.io |publisher=[[Canonical (company)|Canonical]] |access-date=13 January 2024 |ref={{sfnref|Canonical|2024}} }}
(or perhaps |ref={{sfnref|SnapCraft|2024}}
), then use {{sfnp|Canonical|2024|loc="snapd 2.58"}}
(or {{sfnp|SnapCraft|2024|loc="snapd 2.58"}}
, as the case may be).
|author=
(a.k.a. |last=
), just to force the templates to work. This pollutes both the visual and
metadata output of the citation with a false author claim. (Trying the "Staff" trick will now throw a maintenance warning message, though it is hidden from readers; editors have to use
user CSS to turn on visibility of most CS1/CS2 cleanup warnings other than severe errors, and this is
highly recommendable for all editors.) If you encounter anything like this, please fix it by removing the pseudo-author and using |ref={{sfnref|...}}
.{{
Vcite journal}}
, {{
Vcite journal}}
, {{
Vcite book}}
, etc.), which are rare but still occasionally found, cannot be used at all with {{
sfnp}}
, etc., without adding |ref={{sfnref|...}}
to them. Yet another reason to not use that citation style. Here's another: A citation like {{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}}
produces almost impenetrable gibberish output: "Peh WC, Ng KH. Preparing the references. Singapore Medical Journal. 2009;50(7):659–661.
PMID
19644619." – take note of that "2009;50(7):659–661" mess, which is only parseable by experts in Vancouver citation style, which is not more than probably 0.000001% of our readership. If you encounter an article using this citation style, consider proposing changing it to CS1 on the article's talk page, or just
doing it boldly if the citation style is not used consistently in the article.<
ref>
nor cited by anything like {{sfnp}}
, {{harvp}}
, etc. This is useful for identifying sources that have become "orphaned", e.g. because material that included short citations to them was deleted. But sometimes articles have some
"general references" that have been used to source part of the article content without an inline cite yet, and the article may also have a "
Further reading" section, in either/both cases with entries formatted using CS1/CS2 templates. Display of the recurrent big red error message on such citations ("Harv error: link from CITEREFMcDougall2011 doesn't point to any citation.", etc.) can be suppressed by adding |ref=none
to the citation. This should not be done on citations that are actually used inline in the article, directly or by way of short citations, since it will make them not addressable by any short citations. Since this error-hiding is cosmetic (not a reader-facing change and not required maintenance), it should be done as part of a more substantive edit, per
WP:COSMETICBOT. PS: There are other versions of the HarvErrors script, such as the one by Trappist the Monk (listed in the nutshell at the top of
User:Ucucha/HarvErrors), which hide these messages in "External links" and "Further reading" if you want to neither see them nor do anything about them.Sources reused with multiple citations on different pages are usually placed at the bottom of the article instead of kept inline. There are several ways of doing this that vary on an article-by-article basis:
==References==
and its {{
reflist}}
or <
references>
(which generate the short footnotes along with full citations cited only once), add a subheading such as ===Citations===
, ===Works cited===
, or ===Bibliography===
(the last is not recommendable for author bios, since it will seem to be about their own works, and there likely will already be a section by that name). Under this new subheading, use a bullet list with *
to add each of the full citations ({{
cite journal}}
, {{
cite book}}
, etc.) that are being used more than once, one per list line, and without a <
ref>...</ref>
around it. Putting {{
refbegin}}
above and {{
refend}}
below this list is optional; it makes this citation text more consistent with the auto-generated citations.
==Level-2 section==
for this instead of a level-3 subsection, and sometimes when this is done changing the standard "References" (which is used in over 95% of our articles) to something else like "Citations". Neither of these practices are helpful; they just makes our articles less consistent and more confusing to readers.{{reflist}}
or <
references>
, put {{refbegin}}
, your list of multi-cited sources, formatted as above, and then {{refend}}
.<
ref>...</ref>
, and these are in turn placed inside, not below, an extended {{reflist|1=...}}
or <
references>...</references>
. Each is just put on its own line (or sometimes formatting in the vertical multi-line style), with no *
markup. This is the most complicated option and not very popular.Technically speaking, you can do it all inline without anything actually breaking. E.g.: Article text here.<ref>{{cite book |last=Hughes |first=J. B. |date=2013 ... |page=117}}</ref> More article text here.{{sfnp|Hughes|2013|p=122}}</ref>
. However, many editors will consider this sloppy and may move the long cite (sans the page number) to the bottom of the article and replace its original instance with another page-specific short cite, {{sfnp|Hughes|2013|p=117}}
in this case.