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.
 * 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 will automatically benefit). Be careful not to edit the structure or names of Wikidata taxon until you have become familiar with Wikidata:WikiProject Taxonomy and Wikidata:WikiProject Taxonomy/Tutorial.

Basic code:

Taxon example


when placed in the Scarlet macaw article:

Basic use samples
Blue jay

European robin

Agaricus bisporus

American chestnut

Nelumbo lutea

Escherichia coli

Plasmodium falciparum

Bombus terrestris

Canis

Monarch butterfly

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

Hide specific identifier (optional)
Individual identifiers listed in the table above can be removed(hidden) from the bar by setting the corresponding parameter to. This is useful when trying to reduce the number of 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 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 if the goal is to keep the bar on one line.

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

On Coffea arabica, the result is:

Additional parameters
Some taxon identifiers not at present in Wikidata can be added via extra parameters, however adding the data to Wikidata is preferable.

Example:

On Lilium, the result is:

where the taxon identifier in the World Checklist of Selected Plant Families has been added to those picked up from Wikidata.

Multiple Wikidata entries
Some taxa will exist under multiple names (synonyms) on Wikidata. To add these synonyms, you can use the from2, from3, etc. parameters to specify their Wikidata IDs. The parameter from / from1 will be automatically determined by the associated Wikidata entry. While not required, it is preferable, from a maintenance perspective, to specify the Wikidata entry via the from / from1 parameter. Parameters from2, etc., can be specified manually; this can be useful if the associated Wikidata entry differs from the taxon name of the en:Wikipedia article.

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. You can add taxon identifiers not present in Wikidata by appending the appropriate number to the end of the parameter name — for example, to add emonocot to the second row, use emonocot2.

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:

More taxon examples
Arabica coffee, Coffea arabica

Common Milkweed, Asclepias syriaca

Monarch butterfly, Danaus plexippus

Jaguar, Panthera onca

Eastern bluebird, Sialia sialis

Firefly, Lampyridae

fly agaric, Amanita muscaria

, Saccharomyces cerevisiae

Lactobacillus acidophilus

Plasmodium falciparum

Module editing — to-do list

 * See Taxonbar/testcases.
 * Add documentation for grinurl=.
 * Continue to add support for new, useful parameters.
 * Add tracking for entries not on Wikidata? Suggest differences be resolved?
 * Implement Category:Taxonbar template pages requiring a Wikidata item‎
 * Implement Category:Taxonbar templates with duplicate from parameters
 * Implement Category:Taxonbar templates using manual IDs
 * Implement Category:Taxonbar template pages without Wikidata taxon IDs
 * Implement Category:Taxonbar templates with manual IDs differing from Wikidata
 * Program Module:Taxonbar to create it's own documentation table of parameters.
 * Program Module:Taxonbar to support disabled(hidden) databases which can shown when called.

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

Tracking categories

 * – not an error
 * – not an error
 * – not an error
 * – not an error