This is a documentation subpage for Template:Speciesbox. It may contain usage information, categories and other content that is not part of the original template page. |
This template is used on approximately 156,000 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 changing this template. |
This template uses Lua: |
Taxonomy templates
Taxobox templates
((Speciesbox)) is one of the automated taxobox templates used to generate a taxobox automatically. (As of February 2019[update], there were 8 such templates.) It's part of the "automated taxobox system", and is used for taxa (groups of organisms) at the rank of species (excluding viruses). The pages linked in the navigation box provide information on different parts of the system.
Note: If you are a new user, it's a good idea to read the automated taxobox system introduction first; in particular to be sure that you are using the right automated taxobox.
This template is used to display a taxobox for a species whose parent's taxonomy is stored in taxonomy templates. A requirement is that the name of the species is displayed as a simple binomial (i.e. in the form Genus species). In a few special cases, the name of the species is displayed differently (as for example at Halictus? savenyei), when ((Automatic taxobox)) is used.
Note that the Speciesbox template does not require or make use of a taxonomy template for the species; it only uses the taxonomy template for the parent taxon, normally the genus.
Usage is basically the same as ((Automatic taxobox)) (with a few variations noted below).
There are five main cases to consider in using this template:
If the article is about a species whose binomial and genus name are both straightforward (e.g., no rank between the species and its genus, no hybrid symbol, no parenthesized disambiguation in the genus name), then the minimum requirement is to specify the taxon
parameter:[note 1]
|taxon=name of the species without any formatting (e.g. Quercus major, Lobatus gigas)
genus
and species
parameters separately – this is different from ((Automatic taxobox)):
|genus=name of the genus without any formatting (e.g. Quercus, Lobatus)
|species=specific epithet or name without any formatting (e.g. major, gigas)
It's not necessary to include ((italic title)) in the article; this will be added automatically by the Speciesbox template if needed.
For more complicated cases, see the other sections below.
((Speciesbox
| taxon = Lobatus gigas
--recommended [note 1]| authority = (Linnaeus, 1758)
--optional; this is the authority for the binomial (species) name...
--other optional parameters, e.g. for an image))
((Speciesbox
| genus = Lobatus
| species = gigas
| authority = (Linnaeus, 1758)
--optional; this is the authority for the binomial (species) name...
--other optional parameters, e.g. for an image))
((Speciesbox
| name = Golden garlic
--required if title of taxobox ≠ taxon name| taxon = Allium moly
| authority = L.
--optional; this is the authority for the binomial (species) name...
--other optional parameters, e.g. for an image))
((Speciesbox
| name = Lily of the valley
--optional (defaults to page title)| taxon = Convallaria majalis
--essential...
--other optional parameters, e.g. for an image))
If the genus is extinct, the extinct status will be picked up automatically from the taxonomy template for the genus, and a † placed before the species name in the taxobox.
If the species is extinct, but the genus is not, then to achieve the same effect, use one of
|extinct=yes
(true
is also accepted)|extinct=DATE
– for recently extinct species, such as the Dodo, to show when it became extinct. DATE is free-form text: examples are "1780", "about 1700", "after 1791". The DATE text will be displayed if (and only if) |status=
is set to "EX" or equivalents in different status systems.The hybrid sign, ×, should not be italicized, whereas the rest of the binomial should be. The example below shows how to achieve the desired effect. In this case, the single taxon
parameter can't be used.
((Speciesbox
| genus = Polygonatum
| species = × hybridum
| ...
))
Notes:
((hybrid))
, the automatic italicization of the article title won't work.)''Polygonatum'' × ''hybridum''
, or ''Polygonatum ((hybrid)) hybridum''
to obtain the correct italicization.A special case is where the name of the genus is duplicated in different kingdoms, e.g. Acanthocarpus, which is used for a plant and a crab. The taxonomy template for the plant has to be at Template:Taxonomy/Acanthocarpus (plant) to allow there to be a separate page at "Template:Taxonomy/Acanthocarpus (crab)". Consider the page Acanthocarpus preissii. The taxobox has to be set up in this way:
((Speciesbox | genus = Acanthocarpus (plant) | species = preissii | ... ))
The corresponding taxonomy template for the genus, Template:Taxonomy/Acanthocarpus (plant), contains the line:
| link = Acanthocarpus (plant)|Acanthocarpus
to ensure that wikilinks are to "Acanthocarpus (plant)" whereas the displayed genus name is "Acanthocarpus".
Note that this approach is only necessary when the disambiguation is needed because genus names are duplicated across kingdoms.
Another special case is where the article is about a genus with only one species. The article will be at the genus name, but the final taxon to be displayed in the taxobox should be the species. An example is Aphyllanthes, with the sole species Aphyllanthes monspeliensis.
((Speciesbox
|taxon = Aphyllanthes monspeliensis
|parent_authority = L.
--authority for genus|authority = L.
--authority for binomial (i.e. the species)|...
--other optional parameters))
The use of the Speciesbox template with the taxon
parameter set to the species name ensures that the taxobox ends with the binomial name even though the page title is the genus name. The mediawiki software automatically replaces the generated wikilink [[Aphyllanthes]] by bold text since it goes to the same page. In this case we want to display the authority for both the species and the genus, since there is no other article. The parameters parent_authority
, grandparent_authority
, etc. are the way to display authorities up the classification hierarchy.
By default, the Speciesbox template uses the genus name as the name of the parent taxon. If this is not the case, because the parent taxon is at a rank between the species and its genus, such as subgenus or botanical section, then use:
|parent=parent_taxon
"Template:Taxonomy/parent_taxon" must then exist. Conventions for the name of a taxonomy template at a rank between species and genus include:
Thus if a zoological subgenus is to be shown, then the taxobox is set up in this way:
((Speciesbox | name = House mouse | parent = Mus (Mus) | taxon = Mus musculus | ... ))
Further information: Template:Automatic_taxobox/doc § Exceptional_cases |
In some exceptional cases the values shown for the species name and the binomial may require some non-standard formatting. A "binomial" with more than two "words", non-alphabetic characters other than a hyphen, or a need to leave some elements of the name unitalicized require nonstandard formatting. These cases are handled by ((Automatic taxobox)), not Speciesbox. Examples of exceptional cases include: provisional names for undescribed species (e.g. Quassia sp. 'Mount Nardi', where the provisional name should not be italicized), and uncertain genus placement (which may be specified with a ? as in Halictus? savenyei, or with "" as in "Colostethus" poecilonotus.
The template can normally determine whether the page title matches the species or the genus in the taxobox, and if so outputs ((italic title)), so usually it is not necessary to add this template. In a very few cases the automatic italicization will be wrong (e.g. if the article is at the English name and this is the same as the genus name, such as Hippopotamus). Automatic italicization can be over-ridden by setting |italic_title=no
.
The template will generate a taxobox which will display correctly only if the taxonomy for the genus (or |parent=
) has already been created (i.e. "Template:Taxonomy/genusname" or "Template:Taxonomy/parent" already exists). If it does not, you will be asked to create it. One way is to look for the "fix" link and open it.
By default, only major ranks are displayed. The parameter |display_parents=
can be set to display intermediate ranks, for example setting |display_parents=4
will show the next four parent taxa even if they would not otherwise be shown. Note that the genus counts as one of these.