Template:Citation/doc - Revision history

Matt at 10:48, 14 April 2025

2025-04-14T10:48:44Z

← Older revision		Revision as of 06:48, 14 April 2025
Line 653:		Line 653:
	In this example the {{tl\|citation}} template defines, and the template uses, the HTML ID "<code>CITEREFWrightEvans1851</code>", composed by concatenating the string "<code>CITEREF</code>" with the last names of the authors and the year. The {{tl\|harvid}} template can be used to generate such IDs, for example, <code><nowiki>{{harvid\|Wright\|Evans\|1851}}</nowiki></code> generates "<code>{{harvid\|Wright\|Evans\|1851}}</code>".		In this example the {{tl\|citation}} template defines, and the template uses, the HTML ID "<code>CITEREFWrightEvans1851</code>", composed by concatenating the string "<code>CITEREF</code>" with the last names of the authors and the year. The {{tl\|harvid}} template can be used to generate such IDs, for example, <code><nowiki>{{harvid\|Wright\|Evans\|1851}}</nowiki></code> generates "<code>{{harvid\|Wright\|Evans\|1851}}</code>".

	Related methods which leave only a number in the text are to use the {{tl\|harvnb}} template enclosed in the <nowiki><ref></ref></nowiki> html code, or to use the ~~{{tl\|sfn}}~~ template alone. The example above would be <code><nowiki><ref>{{harvnb\|Wright\|Evans\|1851\|p=ix}}</ref></nowiki></code> or <code><nowiki>~~{{sfn\|Wright\|Evans\|1851\|p=ix}}~~</nowiki></code> both of which generate a footnote, such as		Related methods which leave only a number in the text are to use the {{tl\|harvnb}} template enclosed in the <nowiki><ref></ref></nowiki> html code, or to use the template alone. The example above would be <code><nowiki><ref>{{harvnb\|Wright\|Evans\|1851\|p=ix}}</ref></nowiki></code> or <code><nowiki></nowiki></code> both of which generate a footnote, such as
	:17. {{harvnb\|Wright\|Evans\|1851\|p=ix}}		:17. {{harvnb\|Wright\|Evans\|1851\|p=ix}}

Matt at 10:14, 14 April 2025

2025-04-14T10:14:22Z

Matt at 09:11, 14 April 2025

2025-04-14T09:11:39Z

← Older revision		Revision as of 05:11, 14 April 2025
Line 2,941:		Line 2,941:
	{{Reflist}}		{{Reflist}}

	~~{{Wikipedia referencing}}~~
	{{Wikipedia help pages}}<includeonly>{{Sandbox other\|\|		{{Wikipedia help pages}}<includeonly>{{Sandbox other\|\|
	<!-- Categories go below this line, please; interwikis go to Wikidata, thank you! -->		<!-- Categories go below this line, please; interwikis go to Wikidata, thank you! -->
	[[Category:Citation Style 2 templates]]		[[Category:Citation Style 2 templates]]
	}}</includeonly>		}}</includeonly>

Matt at 08:59, 14 April 2025

2025-04-14T08:59:33Z

@@ Line 5: / Line 5: @@
 {{#ifeq: {{PAGENAME}}|{{ROOTPAGENAME}}|{{Cascade-protected template}}}}
 {{#ifeq: {{PAGENAME}}|{{ROOTPAGENAME}}|}}
 The '''Citation''' template generates a citation for a book, periodical, contribution in a collective work, or a web page. It determines the citation type by examining which parameters are used. As with other citation templates, this template can be used either in a footnote (between {{tag|ref}} tags) or in a section that lists sources. This template uses the same Lua code as citation style 1 (CS1) templates with parameters to change the displayed format to citation style 2 (CS2).
@@ Line 190: / Line 189: @@
 ==Parameters==
 ====URL====
-{{anchor|url}}{{csdoc|url}}
+{{anchor|url}}
 ====Chapter URL====
-{{anchor|chapterurl}}{{csdoc|chapterurl|lua=yes}}
+{{anchor|chapterurl}}
 ====Anchor====
 {{further|#Anchored citations}}
 ====Identifiers====
-{{anchor|id1}}{{csdoc|id1|lua=yes}}
+{{anchor|id1}}
-{{anchor|id2}}{{csdoc|id2|lua=yes}}
+{{anchor|id2}}
 ==Examples==

Matt at 22:34, 9 April 2025

2025-04-09T22:34:00Z

← Older revision		Revision as of 18:34, 9 April 2025
Line 4:		Line 4:
	-->		-->
	{{#ifeq: {{PAGENAME}}\|{{ROOTPAGENAME}}\|{{Cascade-protected template}}}}		{{#ifeq: {{PAGENAME}}\|{{ROOTPAGENAME}}\|{{Cascade-protected template}}}}
	{{#ifeq: {{PAGENAME}}\|{{ROOTPAGENAME}}\|~~{{High-risk\|189000+}}~~}}		{{#ifeq: {{PAGENAME}}\|{{ROOTPAGENAME}}\|}}
	{{csdoc\|lua\|lua=yes}}		{{csdoc\|lua\|lua=yes}}
	The '''Citation''' template generates a citation for a book, periodical, contribution in a collective work, or a web page. It determines the citation type by examining which parameters are used. As with other citation templates, this template can be used either in a footnote (between {{tag\|ref}} tags) or in a section that lists sources. This template uses the same Lua code as citation style 1 (CS1) templates with parameters to change the displayed format to citation style 2 (CS2).		The '''Citation''' template generates a citation for a book, periodical, contribution in a collective work, or a web page. It determines the citation type by examining which parameters are used. As with other citation templates, this template can be used either in a footnote (between {{tag\|ref}} tags) or in a section that lists sources. This template uses the same Lua code as citation style 1 (CS1) templates with parameters to change the displayed format to citation style 2 (CS2).

Matt at 14:06, 9 April 2025

2025-04-09T14:06:13Z

← Older revision		Revision as of 10:06, 9 April 2025
Line 1:		Line 1:
	{{wikipedia}}		{{wikipedia}}
	~~{{For-text\|the{{nbsp}} {{fake citation needed}} template\|{{tl\|citation needed}}}}~~
	{{Documentation subpage}}		{{Documentation subpage}}
	<!-- Categories go where indicated at the bottom of this page, please; interwikis go to Wikidata (see also: [[Wikipedia:Wikidata]]).		<!-- Categories go where indicated at the bottom of this page, please; interwikis go to Wikidata (see also: [[Wikipedia:Wikidata]]).

Matt at 11:10, 9 April 2025

2025-04-09T11:10:23Z

← Older revision		Revision as of 07:10, 9 April 2025
Line 9:		Line 9:
	The '''Citation''' template generates a citation for a book, periodical, contribution in a collective work, or a web page. It determines the citation type by examining which parameters are used. As with other citation templates, this template can be used either in a footnote (between {{tag\|ref}} tags) or in a section that lists sources. This template uses the same Lua code as citation style 1 (CS1) templates with parameters to change the displayed format to citation style 2 (CS2).		The '''Citation''' template generates a citation for a book, periodical, contribution in a collective work, or a web page. It determines the citation type by examining which parameters are used. As with other citation templates, this template can be used either in a footnote (between {{tag\|ref}} tags) or in a section that lists sources. This template uses the same Lua code as citation style 1 (CS1) templates with parameters to change the displayed format to citation style 2 (CS2).

	If the correct parameters are used, this template produces output identical to that of the Cite templates, such as ~~{{Tl\|Cite book}}~~ and ~~{{Tl\|Cite web}}~~, with one important exception: By default, this Citation template uses commas in places where the Cite templates use periods (full stops) by default; either type of template can use periods (full stops) or commas by using an optional parameter.		If the correct parameters are used, this template produces output identical to that of the Cite templates, such as and , with one important exception: By default, this Citation template uses commas in places where the Cite templates use periods (full stops) by default; either type of template can use periods (full stops) or commas by using an optional parameter.

	Regardless of which citation templates are used or even if none are used at all, all citations should have the same format throughout an article in the saved, rendered text.		Regardless of which citation templates are used or even if none are used at all, all citations should have the same format throughout an article in the saved, rendered text.

Matt at 08:39, 9 April 2025

2025-04-09T08:39:29Z

← Older revision		Revision as of 04:39, 9 April 2025
Line 49:		Line 49:
	{\| class="wikitable"		{\| class="wikitable"
	\|-		\|-
	\| ~~{{tj\|Citation~~		\|
	~~\| last: Turner~~
	~~\| first: Orsamus~~
	~~\| title: History of the pioneer settlement of Phelps and Gorham's purchase, and Morris' reserve~~
	~~\| publisher: William Alling~~
	~~\| place: Rochester, New York~~
	~~\| year: 1851~~
	~~\| ol: 7120924W~~
	}}
	\| {{Citation		\| {{Citation
	\| last = Turner		\| last = Turner
Line 3,000:		Line 2,992:

	{{UF-COinS}}		{{UF-COinS}}

	~~== See also ==~~
	* Wikipedia:Citation templates
	* Wikipedia:Inline citation
	* Wikipedia:Parenthetical referencing
	* For a comparison of citations using templates with citations written freehand, see Wikipedia:Citing sources/Example edits for different methods § Footnotes

	== Notes ==		== Notes ==

Matt at 08:06, 9 April 2025

2025-04-09T08:06:47Z

← Older revision		Revision as of 04:06, 9 April 2025
Line 250:		Line 250:

	====Anchor====		====Anchor====
	~~{{distinguish\|#Identifiers}}~~
	{{further\|#Anchored citations}}		{{further\|#Anchored citations}}
	{{csdoc\|ref\|lua=yes}}		{{csdoc\|ref\|lua=yes}}

	====Identifiers====		====Identifiers====
	~~{{distinguish\|#Anchor}}~~
	{{anchor\|id1}}{{csdoc\|id1\|lua=yes}}		{{anchor\|id1}}{{csdoc\|id1\|lua=yes}}
	{{anchor\|id2}}{{csdoc\|id2\|lua=yes}}		{{anchor\|id2}}{{csdoc\|id2\|lua=yes}}
Line 704:		Line 702:

	==Anchored citations==		==Anchored citations==
	~~{{distinguish\|#Identifiers}}~~
	This template can generate a citation that can be combined with shortened footnotes or parenthetical referencing. It does this by creating an HTML anchor containing an ID. The special parameter {{para\|ref}} generates an anchor ID suitable for Harvard referencing templates such as {{tl\|harv}} as specified in the next section; an anchor ID is generated by default.		This template can generate a citation that can be combined with shortened footnotes or parenthetical referencing. It does this by creating an HTML anchor containing an ID. The special parameter {{para\|ref}} generates an anchor ID suitable for Harvard referencing templates such as {{tl\|harv}} as specified in the next section; an anchor ID is generated by default.

Matt at 13:59, 8 April 2025

2025-04-08T13:59:02Z

← Older revision		Revision as of 09:59, 8 April 2025
Line 419:		Line 419:
	\| last = Smith		\| last = Smith
	\| first = Joseph III		\| first = Joseph III
	\| author-link = ~~Joseph Smith III~~		\| author-link =
	\| title = Last Testimony of Sister Emma		\| title = Last Testimony of Sister Emma
	\| newspaper = The Saints' Herald		\| newspaper = The Saints' Herald
Line 434:		Line 434:
	\| last = Smith		\| last = Smith
	\| first = Joseph III		\| first = Joseph III
	\| author-link = ~~Joseph Smith III~~		\| author-link =
	\| title = Last Testimony of Sister Emma		\| title = Last Testimony of Sister Emma
	\| newspaper = The Saints' Herald		\| newspaper = The Saints' Herald
Line 552:		Line 552:
	\| last = Kramer		\| last = Kramer
	\| first = Martin		\| first = Martin
	\| author-link = ~~Martin Kramer~~		\| author-link =
	\| year=1999		\| year=1999
	\| title = Bernard Lewis		\| title = Bernard Lewis
Line 568:		Line 568:
	\| last = Kramer		\| last = Kramer
	\| first = Martin		\| first = Martin
	\| author-link = ~~Martin Kramer~~		\| author-link =
	\| year = 1999		\| year = 1999
	\| title = Bernard Lewis		\| title = Bernard Lewis

← Older revision		Revision as of 06:48, 14 April 2025
Line 653:		Line 653:
	In this example the {{tl\|citation}} template defines, and the template uses, the HTML ID "<code>CITEREFWrightEvans1851</code>", composed by concatenating the string "<code>CITEREF</code>" with the last names of the authors and the year. The {{tl\|harvid}} template can be used to generate such IDs, for example, <code><nowiki>{{harvid\|Wright\|Evans\|1851}}</nowiki></code> generates "<code>{{harvid\|Wright\|Evans\|1851}}</code>".		In this example the {{tl\|citation}} template defines, and the template uses, the HTML ID "<code>CITEREFWrightEvans1851</code>", composed by concatenating the string "<code>CITEREF</code>" with the last names of the authors and the year. The {{tl\|harvid}} template can be used to generate such IDs, for example, <code><nowiki>{{harvid\|Wright\|Evans\|1851}}</nowiki></code> generates "<code>{{harvid\|Wright\|Evans\|1851}}</code>".

	Related methods which leave only a number in the text are to use the {{tl\|harvnb}} template enclosed in the <nowiki><ref></ref></nowiki> html code, or to use the ~~{{tl\|sfn}}~~ template alone. The example above would be <code><nowiki><ref>{{harvnb\|Wright\|Evans\|1851\|p=ix}}</ref></nowiki></code> or <code><nowiki>~~{{sfn\|Wright\|Evans\|1851\|p=ix}}~~</nowiki></code> both of which generate a footnote, such as		Related methods which leave only a number in the text are to use the {{tl\|harvnb}} template enclosed in the <nowiki><ref></ref></nowiki> html code, or to use the template alone. The example above would be <code><nowiki><ref>{{harvnb\|Wright\|Evans\|1851\|p=ix}}</ref></nowiki></code> or <code><nowiki></nowiki></code> both of which generate a footnote, such as
	:17. {{harvnb\|Wright\|Evans\|1851\|p=ix}}		:17. {{harvnb\|Wright\|Evans\|1851\|p=ix}}

← Older revision		Revision as of 06:14, 14 April 2025
Line 639:		Line 639:

	==Anchored citations==		==Anchored citations==
	This template can generate a citation that can be combined with shortened footnotes or parenthetical referencing. It does this by creating an HTML anchor containing an ID. The special parameter {{para\|ref}} generates an anchor ID suitable for Harvard referencing templates such as ~~{{tl\|harv}}~~ as specified in the next section; an anchor ID is generated by default.		This template can generate a citation that can be combined with shortened footnotes or parenthetical referencing. It does this by creating an HTML anchor containing an ID. The special parameter {{para\|ref}} generates an anchor ID suitable for Harvard referencing templates such as as specified in the next section; an anchor ID is generated by default.

	To disable anchor generation, specify {{para\|ref\|none}}. You can also specify the ID directly, using the {{para\|ref\|<var>ID</var>}} parameter. For example, suppose an article's ''References'' section contains the markup:		To disable anchor generation, specify {{para\|ref\|none}}. You can also specify the ID directly, using the {{para\|ref\|<var>ID</var>}} parameter. For example, suppose an article's ''References'' section contains the markup:
Line 648:		Line 648:

	===Anchors for Harvard referencing templates===		===Anchors for Harvard referencing templates===
	IDs compatible with Harvard referencing templates such as ~~{{tl\|harv}}~~ are computed from the last names of the authors (or editors, if no authors are given) and the year of the cited source. For example, the markup "<code><nowiki>~~{{harv\|Wright\|Evans\|1851\|p=ix}}~~</nowiki></code>" generates the Harvard reference "~~{{harv\|Wright\|Evans\|1851\|p=ix}}~~", which wikilinks to the citation whose markup and appearance are shown below:		IDs compatible with Harvard referencing templates such as are computed from the last names of the authors (or editors, if no authors are given) and the year of the cited source. For example, the markup "<code><nowiki></nowiki></code>" generates the Harvard reference "", which wikilinks to the citation whose markup and appearance are shown below:
	* <code><nowiki>{{Citation \|last1=Wright \|first1=Thomas \|last2=Evans \|first2=R. H. \|title=Historical and Descriptive Account of the Caricatures of James Gillray \|location=London \|publisher=Henry G. Bohn \|date=1851 \|oclc=59510372}}</nowiki></code>		* <code><nowiki>{{Citation \|last1=Wright \|first1=Thomas \|last2=Evans \|first2=R. H. \|title=Historical and Descriptive Account of the Caricatures of James Gillray \|location=London \|publisher=Henry G. Bohn \|date=1851 \|oclc=59510372}}</nowiki></code>
	* {{Citation \|last1=Wright \|first1=Thomas \|last2=Evans \|first2=R. H. \|title=Historical and Descriptive Account of the Caricatures of James Gillray \|location=London \|publisher=Henry G. Bohn \|date=1851 \|oclc=59510372}}		* {{Citation \|last1=Wright \|first1=Thomas \|last2=Evans \|first2=R. H. \|title=Historical and Descriptive Account of the Caricatures of James Gillray \|location=London \|publisher=Henry G. Bohn \|date=1851 \|oclc=59510372}}
	In this example the {{tl\|citation}} template defines, and the ~~{{tl\|harv}}~~ template uses, the HTML ID "<code>CITEREFWrightEvans1851</code>", composed by concatenating the string "<code>CITEREF</code>" with the last names of the authors and the year. The {{tl\|harvid}} template can be used to generate such IDs, for example, <code><nowiki>{{harvid\|Wright\|Evans\|1851}}</nowiki></code> generates "<code>{{harvid\|Wright\|Evans\|1851}}</code>".		In this example the {{tl\|citation}} template defines, and the template uses, the HTML ID "<code>CITEREFWrightEvans1851</code>", composed by concatenating the string "<code>CITEREF</code>" with the last names of the authors and the year. The {{tl\|harvid}} template can be used to generate such IDs, for example, <code><nowiki>{{harvid\|Wright\|Evans\|1851}}</nowiki></code> generates "<code>{{harvid\|Wright\|Evans\|1851}}</code>".

	Related methods which leave only a number in the text are to use the {{tl\|harvnb}} template enclosed in the <nowiki><ref></ref></nowiki> html code, or to use the {{tl\|sfn}} template alone. The example above would be <code><nowiki><ref>{{harvnb\|Wright\|Evans\|1851\|p=ix}}</ref></nowiki></code> or <code><nowiki>{{sfn\|Wright\|Evans\|1851\|p=ix}}</nowiki></code> both of which generate a footnote, such as		Related methods which leave only a number in the text are to use the {{tl\|harvnb}} template enclosed in the <nowiki><ref></ref></nowiki> html code, or to use the {{tl\|sfn}} template alone. The example above would be <code><nowiki><ref>{{harvnb\|Wright\|Evans\|1851\|p=ix}}</ref></nowiki></code> or <code><nowiki>{{sfn\|Wright\|Evans\|1851\|p=ix}}</nowiki></code> both of which generate a footnote, such as
Line 658:		Line 658:
	The names of only the first four authors are used; other author names are not concatenated to the ID. If no author names are given, editor names are used instead.		The names of only the first four authors are used; other author names are not concatenated to the ID. If no author names are given, editor names are used instead.

	Last names are used, as specified by the parameters {{para\|last1}} (or {{para\|last}}), {{para\|last2}}, {{para\|last3}}, and {{para\|last4}}, and similarly for {{para\|editor1-last}} etc. and for {{para\|inventor1-last}} etc. If a full name is given but no last name is specified, this template falls back on the full name, but this usage is not recommended. For example, in "<code><nowiki>{{Citation \|author=Sigmund Freud \|title=The Ego and the Id \|date=1923}}</nowiki></code>" no last name is given, so this citation cannot be combined with the Harvard reference "<code><nowiki>~~{{harv\|Freud\|1923}}~~</nowiki></code>". To make these {{tl\|citation}} and ~~{{tl\|harv}}~~ invocations compatible, either replace "{{para\|author\|Sigmund Freud}}" with "{{para\|first\|Sigmund}} {{para\|last\|Freud}}", or add "{{para\|ref\|<nowiki>{{harvid\|Freud\|1923}}</nowiki>}}" to the {{tl\|citation}} invocation, or add the same ref parameter (say, "{{para\|ref\|EgoId}}") to both the {{tl\|citation}} and the ~~{{tl\|harv}}~~ invocations.		Last names are used, as specified by the parameters {{para\|last1}} (or {{para\|last}}), {{para\|last2}}, {{para\|last3}}, and {{para\|last4}}, and similarly for {{para\|editor1-last}} etc. and for {{para\|inventor1-last}} etc. If a full name is given but no last name is specified, this template falls back on the full name, but this usage is not recommended. For example, in "<code><nowiki>{{Citation \|author=Sigmund Freud \|title=The Ego and the Id \|date=1923}}</nowiki></code>" no last name is given, so this citation cannot be combined with the Harvard reference "<code><nowiki></nowiki></code>". To make these {{tl\|citation}} and invocations compatible, either replace "{{para\|author\|Sigmund Freud}}" with "{{para\|first\|Sigmund}} {{para\|last\|Freud}}", or add "{{para\|ref\|<nowiki>{{harvid\|Freud\|1923}}</nowiki>}}" to the {{tl\|citation}} invocation, or add the same ref parameter (say, "{{para\|ref\|EgoId}}") to both the {{tl\|citation}} and the invocations.

	<!-- This paragraph appears to be outdated and probably needs to be updated to reflect current CS1/CS2 functionality: -->Similarly, the year is used, as specified by {{para\|year}}. If no year is given, this template attempts to derive the year from {{para\|date}} (or, if no date is given, from {{para\|publication-date}}) by applying the MediaWiki § Time function. This heuristic works with most common date formats (American, International and ISO 8601 standard format YYYY-MM-DD as listed in WP:MOS), but may not work as expected with other formats, so when in doubt it may be safer to use {{para\|year}}.		<!-- This paragraph appears to be outdated and probably needs to be updated to reflect current CS1/CS2 functionality: -->Similarly, the year is used, as specified by {{para\|year}}. If no year is given, this template attempts to derive the year from {{para\|date}} (or, if no date is given, from {{para\|publication-date}}) by applying the MediaWiki § Time function. This heuristic works with most common date formats (American, International and ISO 8601 standard format YYYY-MM-DD as listed in WP:MOS), but may not work as expected with other formats, so when in doubt it may be safer to use {{para\|year}}.

	===IDs must be unique===		===IDs must be unique===
	Names, years, and hand-specified IDs must be chosen so that the IDs are unique within a page; otherwise the HTML will not conform to the W3C standards, and any references to the citations will not work reliably. For example, suppose a page contains the following two citations with ~~{{tl\|harv}}~~-compatible IDs:		Names, years, and hand-specified IDs must be chosen so that the IDs are unique within a page; otherwise the HTML will not conform to the W3C standards, and any references to the citations will not work reliably. For example, suppose a page contains the following two citations with -compatible IDs:
	* {{Citation \|last1=Montes \|first1=G. \|last2=Halterman \|first2=J. S. \|date=2008a \|journal=Pediatrics \|volume=121 \|issue=4 \|pages=e821–e826 \|title=Association of Childhood Autism Spectrum Disorders and Loss of Family Income \|doi=10.1542/peds.2007-1594 \|pmid=18381511 \|url=http://pediatrics.aappublications.org/cgi/content/full/121/4/e821}}		* {{Citation \|last1=Montes \|first1=G. \|last2=Halterman \|first2=J. S. \|date=2008a \|journal=Pediatrics \|volume=121 \|issue=4 \|pages=e821–e826 \|title=Association of Childhood Autism Spectrum Disorders and Loss of Family Income \|doi=10.1542/peds.2007-1594 \|pmid=18381511 \|url=http://pediatrics.aappublications.org/cgi/content/full/121/4/e821}}
	* {{Citation \|last1=Montes \|first1=G. \|last2=Halterman \|first2=J. S. \|date=2008b \|journal=Pediatrics \|volume=122 \|issue=1 \|pages=e202–e208 \|title=Child Care Problems and Employment Among Families with Preschool-aged Children with Autism in the United States \|doi=10.1542/peds.2007-3037 \|pmid=18595965 \|url=http://pediatrics.aappublications.org/cgi/content/full/122/1/e202}}		* {{Citation \|last1=Montes \|first1=G. \|last2=Halterman \|first2=J. S. \|date=2008b \|journal=Pediatrics \|volume=122 \|issue=1 \|pages=e202–e208 \|title=Child Care Problems and Employment Among Families with Preschool-aged Children with Autism in the United States \|doi=10.1542/peds.2007-3037 \|pmid=18595965 \|url=http://pediatrics.aappublications.org/cgi/content/full/122/1/e202}}