Template:Cite iucn/doc
This is a documentation subpage for Template:Cite iucn It may contain usage information, categories and other content that is not part of the original template page. |
This template uses Lua: |
This template is used on approximately 32,000 pages and changes may be widely noticed. Test changes in the template's /sandbox or /testcases subpages, or in your own user subpage. Consider discussing changes on the talk page before implementing them.
Transclusion count updated automatically (see documentation). |
A template for citing the IUCN Red List of Threatened Species.
Usage
This template uses {{cite journal}}
to render IUCN Red List citations. It will accept all parameters that are available to {{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
|title=
; in the forme.T<digits>A<digits>
where<digits>
is one or more of the0–9
digits - lastn / firstn or any of the author name parameters available to
{{cite journal}}
see 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 {{make cite iucn}}
.
Examples
- Sillero-Zubiri, C.; Do Linh San, E. (2016). "Mungos gambianus". The IUCN Red List of Threatened Species 2016: e.T13922A45199653. doi:10.2305/IUCN.UK.2016-1.RLTS.T13922A45199653.en. https://www.iucnredlist.org/species/13922/45199653. Retrieved 18 October 2018. [new-style url provided]
- Goodrich, J.; Lynam, A.; Miquelle, D.; Wibisono, H.; Kawanishi, K.; Pattanavibool, A.; Htun, S.; Tempa, T. et al. (2015). "Panthera tigris". The IUCN Red List of Threatened Species (IUCN) 2015: e.T15955A50659951. doi:10.2305/IUCN.UK.2015-2.RLTS.T15955A50659951.en. https://www.iucnredlist.org/species/15955/50659951. Retrieved 15 January 2018. [old-style url provided and replaced]
- BirdLife International (2017). "Passer domesticus". The IUCN Red List of Threatened Species 2017: e.T103818789A111172035. https://www.iucnredlist.org/species/103818789/111172035. Retrieved 26 October 2018. [old-style url provided and replaced]
- BirdLife International (2019). "Motacilla alba". IUCN Red List of Threatened Species. 2019.3 2019: e.T22718348A137417893. https://www.iucnredlist.org/species/22718348/137417893. Retrieved 14 December 2019. [no journal parameter provided]
- BirdLife International (2019). "Motacilla alba". IUCN Red List of Threatened Species. 2019.3 2019. https://www.iucnredlist.org/species/22718348/137417893. Retrieved 14 December 2019.
Error and maintenance messaging
This template emits a variety of error and maintenance messages.
Error messages
- malformed
|doi=
identifier - malformed
|id=
identifier - malformed
|page=
identifier- IUCN uses an identifier to point to a particular page in their database. For
|page=
and|doi=
the identifier portion of these parameter values has the form:T<digits>A<digits>
where<digits>
is one or more of the0–9
digits; for|id=
the form is<digits>/<digits>
. The template emits these error messages when the identifier portions of the parameter values do not match the expected form.
- IUCN uses an identifier to point to a particular page in their database. For
- |doi= / |page= mismatch
- |doi= / |id= mismatch
- |doi= / |url= mismatch
- |page= / |id= mismatch
- |page= / |url= mismatch
- |id= / |url= mismatch
- This template uses
{{cite journal}}
for rendering. cs1|2 templates are designed to cite single sources. Because IUCN identifiers in|doi=
,|id=
and|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{{cite iucn}}
template do not match. Caveat lector: regardless of the value assigned to|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|doi=
parameter's value. For example, this template taken from Springbok at the time of this writing:{{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}}
- IUCN SSC Antelope Specialist Group (2016). "Antidorcas marsupialis". IUCN Red List of Threatened Species (IUCN) 2016: e.T1676A115056763. doi:10.2305/IUCN.UK.2016-3.RLTS.T1676A50181753.en. https://www.iucnredlist.org/species/1676/115056763.{{cite iucn}}: error: |doi= / |url= mismatch (help)
|page=
and|url=
have the same identifiers (to the current version of the assessment) but|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|doi=
gives working link to the older assessment:
- This template uses
Maintenance messages
Maintenance messages emitted by this template are normally hidden. To make these maintenance messages visible, include the following text in your common CSS page (common.css) or your specific skin's CSS page (skin.css):
.citation-comment {display: inline !important;} /* display cite iucn maintenance messages (also shows cs1|2 maint messages) */
- |volume= / |date= mismatch
- |volume= / |doi= mismatch
- |date= / |doi= mismatch
{{cite iucn}}
validates the volume information in|volume=
against the volume information in|doi=
and compares these values with the content of|date=
or|year=
. These values should all be the same.
- old-form url
- There are two old-form urls for the IUCN Red List.
{{cite iucn}}
modifies these old-form urls into a new-form url using identifier data from|page=
,|id=
, or|doi=
, in that order if available. If an identifier is not available, the template will switch from thehttp
scheme to thehttps
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|page=
(preferred),|id=
, or|doi=
.
- There are two old-form urls for the IUCN Red List.
- new-form url
{{cite iucn}}
emits this message when|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|page=
(preferred),|id=
, or|doi=
.
- unknown url
- When the content of
|url=
is not recognized as old-, original-, or new-form, the template emits this message. Commonly, such urls are doi links (https://doi.org/10.2305/IUCN...
orhttps://dx.doi.org/10.2305/IUCN...
). When|url=
holds a doi link, the parameter should be changed to|doi=10.2305/IUCN...
- When the content of
- no identifier
- When
|url=
,|page=
,|id=
, and|doi=
are all empty or omitted,{{cite iucn}}
cannot construct a url. To resolve this issue add|page=
(preferred),|id=
, or|doi=
.
- When
Tracking categories