మూస:Taxonbar/doc
 | This is a documentation subpage for మూస:Taxonbar. It may contain usage information, categories and other content that is not part of the original మూస page. |
 | This template is used on approximately 4,61,000 pages, or roughly 125% of all pages. To avoid major disruption and server load, any changes should be tested in the template's /sandbox or /testcases subpages, or in your own user subpage. The tested changes can be added to this page in a single edit. Consider discussing changes on the talk page before implementing them. |
 | This template uses Lua: |
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 [[Category:]] and stub template codes in the editor.
Usage
[మార్చు]Add Taxonbar to an article:
- In Source editing mode, insert
{{Taxonbar}}below all other navigation templates except Authority control. - Click "Show preview" to check placement and to see which Taxon identifiers are automatically pulled from Wikidata.
- 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:
{{Taxonbar}}
Taxon example
[మార్చు]
{{Taxonbar}} when placed in the Scarlet macaw article:
Basic use samples
[మార్చు]Taxon identifiers
[మార్చు]The template can automatically get its information from the following properties on Wikidata. This is configured in Module:Taxonbar/conf.
| Parameter | Wikidata ID | Authority | Description |
|---|---|---|---|
| adw | P4024 | identifier for a taxon in the Animal Diversity Web database | |
| apdb | P2036 | identifier for a plant taxon, in the Conservatoire et Jardin botaniques de Genève's African Plant Database of scientific names | |
| algaebase | P1348 | URL for a taxon in AlgaeBase.org | |
| araneae | P3594 | identifier for a taxon in araneae.nmbe.ch | |
| arkive | P2833 | identifier for a taxon, in the ARKive database | |
| avibase | P2026 | identifier for a species, subspecies, or genus in the global bird database Avibase | |
| bacdive | P2946 | identifier for a microorganism, in the BacDive database | |
| bamona | P3398 | identifier for taxa in the "Butterflies and Moths of North America" database | |
| biolib | P838 | identifier for a taxon in the biological encyclopedia BioLib | |
| bhl | P687 | Biodiversity Heritage Library | identifier for a page in the Biodiversity Heritage Library (BHL) |
| bugguide | P2464 | identifier in BugGuide.net | |
| butmoth | P3060 | identifier for a butterfly or moth genus in the UK Natural History Museum's 'Butterflies and Moths of the World' database | |
| conifers | P1940 | identifier for a taxon in the conifers.org database | |
| ebird | P3444 | identifier for a species or subspecies, in the eBird database | |
| eol | P830 | eol.org item reference number | |
| faunaeuropaea | P1895 | identifier for a taxon in Fauna Europaea | |
| fishbase | P938 | identifier for a species in FishBase | |
| florabase | P3101 | identifier for a plant taxon, in the Government of Western Australia's FloraBase database | |
| fna | P1727 | identifier for a taxon in the Flora of North America database | |
| foao | P3100 | identifier for a plant taxon, in the Flora of Australia Online | |
| foc | P1747 | Flora of China | identifier for a taxon in Flora of China (English-language revision of Flora Reipublicae Popularis Sinicae) |
| fossilworks | P842 | identifier for an animal, plant, or microorganism in the Fossilworks database | |
| gbif | P846 | taxon identifier in GBIF | |
| grassbase | P1832 | identifier in GrassBase - The Online World Grass Flora | |
| grin | P1421 | GRIN Taxonomy for Plants | URL for a taxon in the GRIN website |
| ibc | P3099 | identifier for a species of bird, in the Internet Bird Collection database | |
| ictv | P1076 | ||
| inaturalist | P3151 | identifier in iNaturalist | |
| indexfungorum | P1391 | Index Fungorum | identifier for a fungus taxon in Index Fungorum |
| ipni | P961 | numerical identifier for a plant name in the International Plant Names Index | |
| ipni | P586 | numerical identifier for a person in the International Plant Names Index | |
| itis | P815 | identifier for a taxon in the Integrated Taxonomic Information System | |
| iucn | P627 | identifier for a taxon in the International Union for Conservation of Nature database; source for conservation status (P141) | |
| lepindex | P3064 | The Global Lepidoptera Names Index | identifier for a Lepidoptera taxon, in the UK Natural History Museum's 'Global Lepidoptera Names Index' |
| lpsn | P1991 | LPSN | URL for the website List of Prokaryotic names with Standing in Nomenclature (LPSN) |
| msw | P959 | identifier from Mammal Species of the World database | |
| mycobank | P962 | identifier per MycoBank - a database that provides an authoritative and comprehensive list of names of fungi | |
| ncbi | P685 | identifier for a taxon in the Taxonomy Database by the National Center for Biotechnology Information | |
| paldat | P4122 | identifier for a plant species in the Palynological Database (PalDat) for pollen of the University of Vienna | |
| panartic | P2434 | identifier for a taxon in the Panarctic Flora | |
| plantarium | P3102 | identifier for a plant taxon, in the Plantarium database | |
| plantlist | P1070 | identifier in The Plant List database from the Royal Botanic Gardens, Kew | |
| plants | P1772 | identifier in the United States Department of Agriculture PLANTS Database | |
| plazi | P1992 | identifier for a taxon treatment at Plazi.org | |
| species | P2040 | identifier for a taxon in the Species+ database (CITES) | |
| sprat | P2455 | identifier from Species Profile and Threats Database managed by Australian Government Department of the Environment | |
| tropicos | P960 | identifier for a taxon name in the Tropicos database | |
| vascan | P1745 | identifier for a taxon in the Database of Vascular Plants of Canada | |
| watson | P1761 | familyID in Watson & Dallwitz: The families of flowering plants | |
| wcsp | P3591 | identifier of a plant taxon, in the World Checklist of Selected Plant Families | |
| worms | P850 | identifier in the World Register of Marine Species | |
| wsc | P3288 | identifier of a taxon in the World Spider Catalog | |
| xeno-canto | P2426 | identifier of a bird species in the Xeno-canto database | |
| zoobank | P1746 | identifier for a name or nomenclatural act at ZooBank |
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 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 if the goal is to keep the bar on one line.
Example: To remove FOC, IPNI, and AFPD, the code would look like:
{{taxonbar | foc = no | ipni = no| apdb = no }}
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:
{{taxonbar | emonocot = 280381 |Wikispecies = Lilium }}
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.
| Parameter | Database | Property URL/Interwiki link |
|---|---|---|
| eMonocot | eMonocot | http://e-monocot.org/taxon/urn:kew.org:wcs:taxon:$1 |
| emonocotfamily | eMonocot | http://e-monocot.org/taxon/urn:kew.org:wcs:family:$1 |
| ubio | uBio | http://www.ubio.org/browser/details.php?namebankID=$1 |
| wsc-species | World Spider Catalog | http://www.wsc.nmbe.ch/search?sFamily=&fMt=begin&sGenus=&gMt=begin&sSpecies=&sMt=begin&mMt=exact&multiPurpose=slsid&sMulti=$1 |
| wsc-genus | World Spider Catalog | http://www.wsc.nmbe.ch/search?sFamily=&fMt=begin&sGenus=&gMt=begin&sSpecies=&sMt=begin&mMt=exact&multiPurpose=glsid&sMulti=$1 |
| wsc-family | World Spider Catalog | http://www.wsc.nmbe.ch/search?sFamily=&fMt=begin&sGenus=&gMt=begin&sSpecies=&sMt=begin&mMt=exact&multiPurpose=flsid&sMulti=$1 |
| Wikispecies | Wikispecies | Wikispecies:$1 |
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, {{Taxonbar|from=Q26972265|from2=Q20717272}}, 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, {{Taxonbar|from1=Q15715555|from2=Q133951}} produces:
Basionyms
[మార్చు]Basionyms available on Wikidata (via d:Property:P566) are automatically appended. You may also manually specify the basionym via |from#= to customize its location.
For example, both {{Taxonbar|from1=Q43372357|from2=Q164254}} and {{Taxonbar|from1=Q43372357|from2=Q164254|from3=Q21977691}} would produce identical taxonbars on Ponerorchis cucullata:
or {{Taxonbar|from1=Q43372357|from2=Q21977691|from3=Q164254}} for:
More taxon examples
[మార్చు]
Arabica coffee, Coffea arabica
_(14911935302).jpg){kind=small}
Common Milkweed, Asclepias syriaca
.jpg){kind=small}
Monarch butterfly, Danaus plexippus
Jaguar, Panthera onca
Eastern bluebird, Sialia sialis
Firefly, Lampyridae
fly agaric, Amanita muscaria
Module editing — to-do list
[మార్చు]- Add documentation for grinurl=.
- Continue to add support for new, useful parameters.
- 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.
Import synonym QIDs via d:Property:P1420 from Wikidata (with duplicates ignored)(struck, per talk)
See also
[మార్చు]- Help:Taxon identifiers
- Module:Taxonbar - the backend of this template.
- Module:Taxonbar/sandbox
- Template:Taxonbar/testcases
Other links
[మార్చు]- {{ThePlantList}}
- {{Authority control}}
- {{Taxobox}}
- Wikipedia:Automated taxobox system/intro
- Other templates in Category:Biology external link templates
- Other templates in Category:Botany external link templates
Tracking categories
[మార్చు]Maintenance required
[మార్చు]- Category:Taxonbar templates desynced from Wikidata (0)
- Category:Taxonbar templates with invalid from parameters (0)
- Category:Taxonbar templates with duplicate from parameters (0)
- Category:Taxonbar templates with manual IDs differing from Wikidata (0)
- Category:Taxonbar template pages requiring a Wikidata item (0)
Maintenance desired
[మార్చు]- Category:Taxonbar templates without from parameter (0) – add from
- Category:Taxonbar templates using manual IDs (0) – migrate IDs to Wikidata, if possible
- Category:Taxonbar template pages without Wikidata taxon IDs (0) – find/add taxon IDs to Wikidata
- Category:Taxonbar templates with manual IDs identical to Wikidata (0) – remove duplicate(s) on Wikipedia
Tracking only (no error)
[మార్చు]