Template:Cite iucn/doc

A template for citing the IUCN Red List of Threatened Species.

Usage
This template uses to render IUCN Red List citations. It will accept all parameters that are available to 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 form  where   is one or more of the   digits
 * lastn / firstn or any of the author name parameters available to see
 * year: the year of publication; alias: date
 * errata: the year that an assessment errata is published – from IUCN citation text:
 * amends: the year that 'this assessment' amends – from IUCN citation text:
 * volume: usually same as year; may be omitted if year set

A handy tool for creating these templates is.

Examples

 * [new-style url provided]
 * [old-style url provided and replaced]
 * [old-style url provided and replaced]
 * [no journal parameter provided]

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

Error messages

 * malformed doi 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:   where   is one or more of the   digits.  The template emits these error messages when the identifier portions of the parameter values do not match the expected form.
 * |doi= / |page= mismatch
 * |doi= / |url= mismatch
 * |page= / |url= mismatch
 * This template uses for rendering.  cs1|2 templates are designed to cite single sources.  Because IUCN identifiers in doi 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  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:
 * 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:
 * https://www.iucnredlist.org/species/1676/50181753
 * 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:
 * 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 CSS page (common.css) or your specific skin's CSS page (skin.css):


 * |volume= / |date= mismatch
 * |volume= / |doi= mismatch
 * |date= / |doi= mismatch
 * 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.  modifies these old-form urls into a new-form url using identifier data from page or doi, in that order if available.  If an identifier is not available, the template will switch from the   scheme to the   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) and/or doi.
 * new-form url
 * 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) and/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 (  or  ).  When url holds a doi link, the parameter should be changed to 10.2305/IUCN...
 * no identifier
 * When url, page, and doi are all empty or omitted, cannot construct a url.  To resolve this issue add page (preferred) and/or doi.
 * title has extraneous text
 * The template emits this message when title has either of these annotations:
 * errata annotation:  – remove this text and add year
 * amendment annotation:  – remove this text and add year

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" ] }