Template:Taxonbar/doc

Description
This metadata template links Wikipedia articles to various biological and taxonomic databases. Taxonbar displays these links as short strings, indicating the unique identifier each database has assigned the taxon for catalogue purposes.

Taxonomic identifiers of each taxon are stored and retrieved from each taxon's corresponding Wikidata entry, but can be overridden in individual articles with locally entered data. Adding the data to Wikidata is preferable.

This project is based on the work of Authority Control and Wikidata:WikiProject Taxonomy. If you are a template editor or Wikipedia administrator, you may contribute at Module:Taxonbar. Please discuss ideas/thoughts for improvement or use on Template:Taxonbar/talk.

Position
Please place Taxonbar correctly. As a metadata template, Taxonbar should be placed: • Below all references, footnotes, and external links.

• Below all navigation templates—except Authority control

• Above the Authority control template.

• Above all [[Wikipedia:Categories| and stub template codes in the editor.

• |undefined

Usage
Add Taxonbar to an article:


 * 1) In Source editing mode, insert  below all other navigation templates except Authority control &mdash; it is preferable to add the   parameter even if just a single Wikidata item points to the article.
 * 2) Click "Show preview" to check placement, and to see which taxon identifiers are automatically pulled from Wikidata.
 * 3) If you have more identifiers to add, consider adding them to the article's Wikidata item, so that all versions of Wikipedia automatically benefit. Be careful not to edit the structure or names of Wikidata taxa until you have become familiar with Wikidata:WikiProject Taxonomy and Wikidata:WikiProject Taxonomy/Tutorial.

Basic code:

Taxon example


when placed in the Pileated woodpecker article:

Basic use samples
Examples of articles demonstrating its use include: Agaricus bisporus

Arabidopsis thaliana

Bombus terrestris

Canis

Chordate

Conifer

Escherichia coli

Eukaryote

European robin

Salicaceae

Influenza A virus

Insect

Lambda phage

Nitrosopumilus

Physcomitrella patens

Plasmodium falciparum

Protozoa

Red algae

Squamata

Taxon identifiers
The template can automatically get its information from the following properties on Wikidata. This is configured in Module:Taxonbar/conf.

Manual identifiers
Some taxon identifiers not currently in Wikidata can be added via additional parameters listed above; however, adding the data to Wikidata is preferable, so that all versions of Wikipedia automatically benefit.

Example:

On Lilium, the result is the following, where the taxon identifier in the Plants of the World Online has been added to those picked up from Wikidata:

If there are multiple Wikidata entries resulting in multiple rows, the row to which an identifier is added can be specified by appending a number matching the relevant parameter.

A Wikispecies page can be also added manually. However, it is preferable to link it to the Wikidata item; this can be done at the Wikidata page within the "Multilingual sites" section, entering "species" as the "wiki".

Hide specific identifier (optional)
Individual identifiers listed in the table above can be removed/hidden from the bar by setting the corresponding parameter to no. This is useful when trying to reduce the number of unhelpful links within Taxonbar. Spaces are optional. There is no sense in removing too many identifiers, for example: removing plant or fungi identifiers from an animal taxon would have no effect, as these parameters will not show up on an animal taxon in the first place. It is best to preview Taxonbar on the page and decide what entries provide little relevant data. Plant species will have the most entries and are most likely in need of hiding some entries.

Example: To remove FOC, IPNI, and AFPD, the code would look like:

On Coffea arabica, the result is:

Displaying excluded databases (optional)
These databases are available at Wikidata but are excluded by default on the English-language Wikipedia as they are not in the English language. They can be included in the taxonbar by setting the corresponding parameter to yes (e.g. yes), which will then retrieve the value from Wikidata, or by setting the value of the parameter manually (e.g. 395235).

Multiple Wikidata entries
The parameter from / from1 will be implicitly determined by the Wikidata item linked to the article. For maintenance purposes it is preferable to explicitly provide the linked Wikidata item in the from / from1 parameter, although it is not strictly required. If it is not provided the article will be listed at Category:Taxonbars without from parameter.

Parameters from2, from3, etc., can also be added, for example, if the linked Wikidata item differs from the taxon name of the English-language Wikipedia article. Some taxa exist under multiple names (synonyms) on Wikidata. To add these synonyms, use the from2, from3, etc., parameters to specify their Wikidata IDs. If there is more than one row, the taxon name from Wikidata will be shown in the leftmost column — to overwrite this, use the title / title1, title2, title3, etc. parameters.

For example,, when placed on the page Dog produces:

The same approach can be used when monotypic taxa have a single article, but there are multiple entries in Wikidata. For example, at Haptanthus, which covers the genus and its sole species, produces:

You can manually add taxon identifiers not present in Wikidata to a specific row by appending the appropriate number to the end of the parameter name — for example, to add an inaturalist identifier to the second row, use inaturalist2.

Basionyms
Basionyms available on Wikidata (via ) are automatically appended. You may also manually specify the basionym via from# to manually specify its position.

For example, both
 * and

would produce identical taxonbars for Ponerorchis cucullata:

However, changing the order of the IDs will alter their position in the taxonbar so

produces a taxonbar with the basionym in a different position:

More taxon examples
Arabica coffee, Coffea arabica

Jaguar, Panthera onca

Fly agaric, Amanita muscaria

Lactobacillus acidophilus

Plasmodium falciparum

Module editing — to-do list

 * Continue to add support for new, useful parameters (search)

Module editing — to-don't list

 * Import synonym QIDs via from Wikidata (talk)

Other links

 * ThePlantList
 * Authority control
 * Taxobox
 * Automated taxobox system/intro
 * Other templates in Category:Biology external link templates
 * Other templates in Category:Botany external link templates

Maintenance desired

 * — add Taxonbar, if appropriate


 * — find/add taxon IDs to the primary Wikidata item
 * — find/add taxon IDs to secondary Wikidata item(s)
 * — migrate IDs to Wikidata, if possible
 * — remove duplicate(s) on Wikipedia


 * — add from parameter
 * — swap from1/from2 parameter values (maybe)
 * — swap from1/from2 parameter values (probably)
 * — add QIDs of related monotypic ranks to from2, etc.
 * — add QIDs of related monotypic ranks to from2, etc.


 * — verify monotypic status of both genus and species on Wikidata
 * — verify monotypic status of both genus and species on Wikidata

TemplateData
{	"params": { "from": { "label": "Wikidata item", "example": "Q1", "suggested": true }	},	"description": "Links to taxonomic databases via Wikidata", "paramOrder": [ "from" ],	"format": "inline" }