ઢાંચો: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:Iucn}}
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'''
*'''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. | last-author-amp = yes | 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|id=22718348/137417893 |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]
*{{cite iucn|id=22718348/137417893 |title=''Motacilla alba'' |author=BirdLife International |author-link=BirdLife International |version=2019.3 |year=2019 |access-date=14 December 2019}}

==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|id|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; for {{para|id}} the form is <code>&lt;{{var|digits}}>/&lt;{{var|digits}}></code>.  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= / |id= mismatch</span>
*<span class="error" style="font-size:100%">|doi= / |url= mismatch</span>
*<span class="error" style="font-size:100%">|page= / |id= mismatch</span>
*<span class="error" style="font-size:100%">|page= / |url= mismatch</span>
*<span class="error" style="font-size:100%">|id= / |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}}, {{para|id}} 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]]):
:<source lang="css">.citation-comment {display: inline !important;}  /* display cite iucn maintenance messages (also shows cs1|2 maint messages) */</source>

*<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}}, {{para|id}}, 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), {{para|id}}, 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), {{para|id}}, 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}}, {{para|id}}, and {{para|doi}} are all empty or omitted, {{tld|cite iucn}} cannot construct a url.  To resolve this issue add {{para|page}} (preferred), {{para|id}}, or {{para|doi}}.

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

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