మూస:Cite iucn/doc పేజీ సోర్సు చూడండి

{{Documentation subpage}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
{{Lua|Module:Cite iucn}}
{{High-use}}
A template for citing the ''[[IUCN Red List of Threatened Species]]''.

== Usage ==

This template uses {{tlx|cite journal}} to render IUCN ''Red List'' citations.  It will accept all parameters that are available to {{tld|cite journal}} though only a few are needed because this template will automatically provide a standardized set of parameters.  Data for the parameters that editors need to provide can be found on the appropriate ''Red List'' page.  The parameters that editors need to provide are:
*'''title''': usually the species name; italics for proper formatting are not provided
*'''page''': the electronic page number; the template will use this value to create a correct url to link the value in {{para|title}}; in the form <code>e.T&lt;{{var|digits}}>A&lt;{{var|digits}}></code> where <code>&lt;{{var|digits}}></code> is one or more of the <code>0–9</code> digits
*'''last{{var|n}}''' / '''first{{var|n}}''' or any of the author name parameters available to {{tld|cite journal}} see {{slink|Template:Cite_journal#Authors}}
*'''year''': the year of publication; alias: '''date'''
*'''errata''': the year that an assessment errata is published – from IUCN citation text: <code>(errata version published in {{var|year}})</code>
*'''amends''': the year that 'this assessment' amends – from IUCN citation text: <code>(amended version of {{var|year}} assessment)</code>
*'''volume''': usually same as '''year'''; may be omitted if '''year''' set

A handy tool for creating these templates is {{tlx|make cite iucn}}.

==Examples==
*{{cite iucn |author1=Sillero-Zubiri, C. |author2=Do Linh San, E. |name-list-style=amp |year=2016 |title=''Mungos gambianus'' |journal=[[The IUCN Red List of Threatened Species]] |volume=2016 |page=e.T13922A45199653 |url=https://www.iucnredlist.org/species/13922/45199653 |doi=10.2305/IUCN.UK.2016-1.RLTS.T13922A45199653.en |access-date=18 October 2018}} [new-style url provided]
*{{Cite iucn |author1=Goodrich, J. |author2=Lynam, A. |author3=Miquelle, D. |author4=Wibisono, H. |author5=Kawanishi, K. |author6=Pattanavibool, A. |author7=Htun, S. |author8=Tempa, T. |author9=Karki, J. |author10=Jhala, Y. |author11=Karanth, U. |title=''Panthera tigris'' |journal=[[The IUCN Red List of Threatened Species]] |volume=2015 |page=e.T15955A50659951 |publisher=[[IUCN]] |date=2015 |url=http://www.iucnredlist.org/details/15955/0 |doi=10.2305/IUCN.UK.2015-2.RLTS.T15955A50659951.en |access-date=15 January 2018}} [old-style url provided and replaced]
*{{cite iucn |author=BirdLife International |year=2017 |title=''Passer domesticus'' |journal=The IUCN Red List of Threatened Species |volume=2017 |page=e.T103818789A111172035 |access-date=26 October 2018 |url=http://oldredlist.iucnredlist.org/details/103818789/0}} [old-style url provided and replaced]
*{{Cite iucn |title=''Motacilla alba'' |author1=BirdLife International |author1-link=BirdLife International |version=2019.3 |year=2019 |page=e.T22718348A137417893 |url=https://www.iucnredlist.org/species/22718348/137417893 |access-date=14 December 2019}} [no journal parameter provided]

==Error and maintenance messaging==
This template emits a variety of error and maintenance messages.

===Error messages===
*<span class="error" style="font-size:100%">malformed {{para|doi|plain=yes}} identifier</span> 
*<span class="error" style="font-size:100%">malformed {{para|page|plain=yes}} identifier</span> 
*:IUCN uses an identifier to point to a particular page in their database.  For {{para|page}} and {{para|doi}} the identifier portion of these parameter values has the form: <code>T&lt;{{var|digits}}>A&lt;{{var|digits}}></code> where <code>&lt;{{var|digits}}></code> is one or more of the <code>0–9</code> digits.  The template emits these error messages when the identifier portions of the parameter values do not match the expected form.
*<span class="error" style="font-size:100%">|doi= / |page= mismatch</span>
*<span class="error" style="font-size:100%">|doi= / |url= mismatch</span>
*<span class="error" style="font-size:100%">|page= / |url= mismatch</span>
*:This template uses {{tlx|cite journal}} for rendering.  cs1|2 templates are designed to cite single sources.  Because IUCN identifiers in {{para|doi}} and {{para|page}} point to individual pages in the IUCN database, all of the identifiers should match.  The template emits these errors when the identifiers in a {{tld|cite iucn}} template do not match.  {{lang|la|Caveat lector}}: regardless of the value assigned to {{para|doi}} (or urls that link to IUCN through the dx.doi.org resolver), doi links are redirected to the most recent assessment, not to the assessment specified in the {{para|doi}} parameter's value.  For example, this template taken from [[Springbok]] at the time of this writing:
*::<code><nowiki>{{cite iucn |publisher=[[IUCN]] |title=''Antidorcas marsupialis'' |author=IUCN SSC Antelope Specialist Group |year=2016 |volume=2016 |page=e.T1676A115056763 |doi=10.2305/IUCN.UK.2016-3.RLTS.T1676A50181753.en |url=https://www.iucnredlist.org/species/1676/115056763}}</nowiki></code>
*:::{{cite iucn |publisher=[[IUCN]] |title=''Antidorcas marsupialis'' |author=IUCN SSC Antelope Specialist Group |year=2016 |volume=2016 |page=e.T1676A115056763 |doi=10.2305/IUCN.UK.2016-3.RLTS.T1676A50181753.en |url=https://www.iucnredlist.org/species/1676/115056763}}
*:{{para|page}} and {{para|url}} have the same identifiers (to the current version of the assessment) but {{para|doi}} has a different (older identifier) yet clicking the doi-link takes the reader to the current assessment.  Rewriting the url value to use the identifier from {{para|doi}} gives working link to the older assessment:
*::https://www.iucnredlist.org/species/1676/50181753

===Maintenance messages===
Maintenance messages emitted by this template are normally hidden.  To make these maintenance messages visible, include the following text in your common [[Cascading Stylesheets|CSS]] page ([[Special:MyPage/common.css|common.css]]) or your specific skin's CSS page ([[Special:MyPage/skin.css|skin.css]]):
:<syntaxhighlight lang="css">.citation-comment {display: inline !important;}  /* display cite iucn maintenance messages (also shows cs1|2 maint messages) */</syntaxhighlight>

*<span style="color: #33aa33">|volume= / |date= mismatch</span>
*<span style="color: #33aa33">|volume= / |doi= mismatch</span>
*<span style="color: #33aa33">|date= / |doi= mismatch</span>
*:{{tlx|cite iucn}} validates the volume information in {{para|volume}} against the volume information in {{para|doi}} and compares these values with the content of {{para|date}} or {{para|year}}.  These values should all be the same.
*<span style="color: #33aa33">old-form url</span>
*:There are two old-form urls for the IUCN Red List.  {{tld|cite iucn}} modifies these old-form urls into a new-form url using identifier data from {{para|page}} or {{para|doi}}, in that order if available.  If an identifier is not available, the template will switch from the <code>http</code> scheme to the <code>https</code> scheme which will sometimes make a 'dead' old-form url work.  When either of these changes is made, the template emits this message.  Templates cannot save changes like this to the wiki-text so editors should evaluate the results of these url changes and modify the template's wiki text to remove the url and add {{para|page}} (preferred) and/or {{para|doi}}.
*<span style="color: #33aa33">new-form url</span>
*:{{tld|cite iucn}} emits this message when {{para|url}} holds a new-form url.  This form of url is acceptable but, for consistency, should be removed so that the template may create the url from {{para|page}} (preferred) and/or {{para|doi}}.
*<span style="color: #33aa33">unknown url</span>
*:When the content of {{para|url}} is not recognized as old-, original-, or new-form, the template emits this message.  Commonly, such urls are doi links (<code><nowiki>https://doi.org/10.2305/IUCN...</nowiki></code> or <code><nowiki>https://dx.doi.org/10.2305/IUCN...</nowiki></code>).  When {{para|url}} holds a doi link, the parameter should be changed to {{para|doi|10.2305/IUCN...}}
*<span style="color: #33aa33">no identifier</span>
*:When {{para|url}}, {{para|page}}, and {{para|doi}} are all empty or omitted, {{tld|cite iucn}} cannot construct a url.  To resolve this issue add {{para|page}} (preferred) and/or {{para|doi}}.
*<span style="color: #33aa33">title has extraneous text</span>
*:The template emits this message when {{para|title}} has either of these annotations:
*:*errata annotation: <code>(errata version published in {{var|year}})</code> – remove this text and add {{para|errata|{{var|year}}}}
*:*amendment annotation: <code>(amended version of {{var|year}} assessment)</code> – remove this text and add {{para|amends|{{var|year}}}}

===Tracking categories===
*{{clc|Cite iucn maint}}
*{{clc|Cite iucn errors}}

== TemplateData ==
{{TemplateData header}}
{{Collapse top|TemplateData}}
<templatedata>
{
	"params": {
		"title": {
			"label": "Title",
			"description": "Usually the species name (in which case it should be italicised)",
			"type": "string",
			"required": true,
			"suggested": true
		},
		"page": {
			"label": "Page",
			"description": "The electronic page number",
			"suggested": true,
			"type": "line"
		},
		"last": {
			"aliases": [
				"last1",
				"author",
				"author1"
			],
			"label": "Family name",
			"description": "Last name or surname of the first author, or the whole name for an author with only given names or an organisation; don't wikilink, use \"author-link\"",
			"type": "line",
			"suggested": true
		},
		"first": {
			"aliases": [
				"first1"
			],
			"label": "Given name",
			"description": "Given name of the first author; if an author has only given names, use \"last\"; don't wikilink, use \"author-link\"",
			"type": "line",
			"suggested": true
		},
		"year": {
			"aliases": [
				"date"
			],
			"label": "Year",
			"description": "Year of publication",
			"type": "date",
			"suggested": true
		},
		"volume": {
			"label": "Volume",
			"description": "Usually same as \"year\", may be omitted if \"year\" is set",
			"type": "line"
		},
		"author-link": {
			"aliases": [
				"author-link1",
				"author1-link"
			],
			"label": "Author link",
			"description": "Title of existing Wikipedia page on the first author",
			"type": "wiki-page-name"
		},
		"last2": {
			"aliases": [
				"author2"
			],
			"label": "Family name 2",
			"description": "Last name or surname of the second author, or the whole name for an author with only given names or an organisation; don't wikilink, use \"author-link2\"",
			"type": "line",
			"suggested": false
		},
		"first2": {
			"label": "Given name 2",
			"description": "Given name of the second author; if an author has only given names, use \"last2\"; don't wikilink, use \"author-link2\"",
			"type": "line",
			"suggested": false
		},
		"author-link2": {
			"aliases": [
				"author2-link"
			],
			"label": "Author link 2",
			"description": "Title of existing Wikipedia page on the second author",
			"type": "wiki-page-name"
		},
		"last3": {
			"aliases": [
				"author3"
			],
			"label": "Family name 3",
			"description": "Last name or surname of the third author, or the whole name for an author with only given names or an organisation; don't wikilink, use \"author-link3\"",
			"type": "line",
			"suggested": false
		},
		"first3": {
			"label": "Given name 3",
			"description": "Given name of the third author; if an author has only given names, use \"last3\"; don't wikilink, use \"author-link3\"",
			"type": "line",
			"suggested": false
		},
		"author-link3": {
			"aliases": [
				"author3-link"
			],
			"label": "Author link 3",
			"description": "Title of existing Wikipedia page on the third author",
			"type": "wiki-page-name"
		},
		"last4": {
			"aliases": [
				"author4"
			],
			"label": "Family name 4",
			"description": "Last name or surname of the fourth author, or the whole name for an author with only given names or an organisation; don't wikilink, use \"author-link4\"",
			"type": "line",
			"suggested": false
		},
		"first4": {
			"label": "Given name 4",
			"description": "Given name of the fourth author; if an author has only given names, use \"last4\"; don't wikilink, use \"author-link4\"",
			"type": "line",
			"suggested": false
		},
		"author-link4": {
			"aliases": [
				"author4-link"
			],
			"label": "Author link 4",
			"description": "Title of existing Wikipedia page on the fourth author",
			"type": "wiki-page-name"
		},
		"last5": {
			"aliases": [
				"author5"
			],
			"label": "Family name 5",
			"description": "Last name or surname of the fifth author, or the whole name for an author with only given names or an organisation; don't wikilink, use \"author-link5\"",
			"type": "line",
			"suggested": false
		},
		"first5": {
			"label": "Given name 5",
			"description": "Given name of the fifth author; if an author has only given names, use \"last5\"; don't wikilink, use \"author-link5\"",
			"type": "line",
			"suggested": false
		},
		"author-link5": {
			"aliases": [
				"author5-link"
			],
			"label": "Author link 5",
			"description": "Title of existing Wikipedia page on the fifth author",
			"type": "wiki-page-name"
		},
		"last6": {
			"aliases": [
				"author6"
			],
			"label": "Family name 6",
			"description": "Last name or surname of the sixth author, or the whole name for an author with only given names or an organisation; don't wikilink, use \"author-link6\"",
			"type": "line",
			"suggested": false
		},
		"first6": {
			"label": "Given name 6",
			"description": "Given name of the sixth author; if an author has only given names, use \"last6\"; don't wikilink, use \"author-link6\"",
			"type": "line",
			"suggested": false
		},
		"author-link6": {
			"aliases": [
				"author6-link"
			],
			"label": "Author link 6",
			"description": "Title of existing Wikipedia page on the sixth author",
			"type": "wiki-page-name"
		},
		"last7": {
			"aliases": [
				"author7"
			],
			"label": "Family name 7",
			"description": "Last name or surname of the seventh author, or the whole name for an author with only given names or an organisation; don't wikilink, use \"author-link7\"",
			"type": "line",
			"suggested": false
		},
		"first7": {
			"label": "Given name 7",
			"description": "Given name of the seventh author; if an author has only given names, use \"last7\"; don't wikilink, use \"author-link7\"",
			"type": "line",
			"suggested": false
		},
		"author-link7": {
			"aliases": [
				"author7-link"
			],
			"label": "Author link 7",
			"description": "Title of existing Wikipedia page on the seventh author",
			"type": "wiki-page-name"
		},
		"last8": {
			"aliases": [
				"author8"
			],
			"label": "Family name 8",
			"description": "Last name or surname of the eighth author, or the whole name for an author with only given names or an organisation; don't wikilink, use \"author-link8\"",
			"type": "line",
			"suggested": false
		},
		"first8": {
			"label": "Given name 8",
			"description": "Given name of the eighth author; if an author has only given names, use \"last8\"; don't wikilink, use \"author-link8\"",
			"type": "line",
			"suggested": false
		},
		"author-link8": {
			"aliases": [
				"author8-link"
			],
			"label": "Author link 8",
			"description": "Title of existing Wikipedia page on the eighth author",
			"type": "wiki-page-name"
		},
		"access-date": {
			"label": "Access date",
			"description": "Date that the citation was verified to support the text",
			"type": "date",
			"suggested": true
		}
	},
	"description": "Formats a citation of the IUCN Red List of Threatened Species",
	"format": "inline",
	"paramOrder": [
		"title",
		"page",
		"last",
		"first",
		"year",
		"volume",
		"access-date",
		"author-link",
		"last2",
		"first2",
		"author-link2",
		"last3",
		"first3",
		"author-link3",
		"last4",
		"first4",
		"author-link4",
		"last5",
		"first5",
		"author-link5",
		"last6",
		"first6",
		"author-link6",
		"last7",
		"first7",
		"author-link7",
		"last8",
		"first8",
		"author-link8"
	]
}
</templatedata>
{{Collapse bottom}}

<includeonly>{{sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Templates that add a tracking category]]
[[Category:Specific-source templates]]
}}</includeonly>