Editing Template:Automatic taxobox/doc (section)

==Available parameters and how to use them==
===All parameters===
{{pre|<nowiki>{{automatic taxobox</nowiki>
{{para|color_as}}
[[#Italic title|{{para|italic_title}}]]
[[#Parameter %7Cname=|{{para|name}}]]
[[#Parameter %7Cfossil_range=|{{para|fossil_range}}]]
[[#Parameter %7Coldest_fossil=|{{para|oldest_fossil}}]]
[[#Parameter %7Cyoungest_fossil=|{{para|youngest_fossil}}]]
{{para|status}}
{{para|status_system}}
{{para|status_ref}}
{{para|status2}}
{{para|status2_system}}
{{para|status2_ref}}
{{para|trend}}
{{para|image}}
{{para|image_upright}}
{{para|image_alt}}
{{para|image_caption}}
{{para|image2}}
{{para|image2_upright}}
{{para|image2_alt}}
{{para|image2_caption}}
{{para|classification_status}}
[[#Parameter %7Ctaxon=|{{para|taxon}}]]
[[#Parameter %7Cauthority=|{{para|authority}}]]
[[#Parameter %7Cparent_authority=, etc.|{{para|parent_authority}}]]
[[#Parameter %7Cparent_authority=, etc.|{{para|grandparent_authority}}]]
[[#Parameter %7Cparent_authority=, etc.|{{para|greatgrandparent_authority}}]]
[[#Parameter %7Cparent_authority=, etc.|{{para|greatgreatgrandparent_authority}}]]
[[#Parameter %7Cdisplay_parents=|{{para|display_parents}}]]
[[#Exceptional cases|{{para|genus_text}}]]
[[#Exceptional cases|{{para|species_text}}]]
[[#Exceptional cases|{{para|binomial_text}}]]
<!--{{para|binomial}}
{{para|binomial_authority}}
{{para|trinomial}}
{{para|trinomial_authority}}
-->{{para|type_genus}}
{{para|type_genus_authority}}
{{para|type_species}}
{{para|type_species_authority}}
{{para|diversity}}
{{para|diversity_link}}
{{para|diversity_ref}}
{{para|subdivision_ranks}}
{{para|subdivision_ref}}
{{para|subdivision}}
{{para|type_strain}}
{{para|range_map}}
{{para|range_map_upright}}
{{para|range_map_alt}}
{{para|range_map_caption}}
{{para|range_map2}}
{{para|range_map2_upright}}
{{para|range_map2_alt}}
{{para|range_map2_caption}}
{{para|synonyms}}
{{para|synonyms_ref}}
<nowiki>}}</nowiki>}}

===Italic title===
It is not usually necessary to do anything to italicize the page title and supply an italicized taxobox name if {{para|name}} is absent; both are normally handled automatically. Since 28 May 2021, this includes page titles that are botanical names containing a connecting term, like [[Banksia ser. Banksia|''Banksia'' ser. ''Banksia'']].

The automatic italicization fails for pages whose title contains a parenthesised subgenus, such as [[Camponotus (Dendromyrmex)|''Camponotus'' (''Dendromyrmex'')]], because by default parenthesised terms are treated as a disambiguators and not italicized. In this case, add {{para|italic_title|taxon}} to force the page title to be treated as a complete taxon name.

In a very few special cases, the correct italicization has to be produced manually. In such cases:
* put {{para|italic_title|no}} in the taxobox to prevent the automatic attempt to italicize the page title and to add an italicized taxobox name
* add <code><nowiki>{{DISPLAYTITLE:}}</nowiki></code> above the taxobox template with the fully formatted page title after the colon
* put {{para|name}} in the taxobox with a fully formatted taxobox name.

===Parameter {{para|taxon}}===
Generally, this is the name of the taxon the article is about. In the resulting taxobox, this parameter is the one that is bolded. (To bold multiple taxa, see [[#Making the links bold]].)

More accurately, if {{para|taxon|TAXON}}, the system will expect there to be a page at "Template:Taxonomy/TAXON". In some circumstances, TAXON may not be the name of the taxon, e.g. if a plant and animal share the same genus name, there may be two taxonomy templates called "Template:Taxonomy/GENUS (plant)" and "Template:Taxonomy/GENUS (animal)". In such cases, something like the following is required:

<code><nowiki>{{Automatic taxobox</nowiki><br>
<nowiki>| taxon = GENUS (plant)</nowiki></code>

This ensures that the system links to the right taxonomy template.

If this parameter is omitted, {{as of|2012|December|lc=yes}} the system will attempt to infer what its value should be from the page name. '''Omitting the <code>taxon</code> parameter is strongly deprecated and may not be supported in future.'''

===Parameter {{para|name}}===
If the title of the taxobox should be different from the default value, enter it here. This is most commonly used for common names.

===Parameter {{para|authority}}===
This parameter is similar to the authority parameters in the {{tl|Taxobox}}. The only difference is that you don't have to specify the rank this authority matches up with – it will pair it with the taxon listed in the {{para|taxon}} parameter.

===Parameter {{para|fossil_range}}===
There are two ways of using this parameter.
#{{para|fossil_range|''recognized period name''}}, e.g. {{para|fossil_range|Devonian}} – assumes the taxon has fossils only in this period and produces a display accordingly.
#{{para|fossil_range|''any other value''}} – displays the value provided. Often this will be a use of the template {{tl|Geological range}}, e.g. {{para|fossil_range|<code><nowiki>{{Geological range|Devonian|Jurassic}}</nowiki></code>}}; however, it can also be plain text, e.g. {{para|fossil_range|Probably Devonian–Jurassic}}.
See also {{para|oldest_fossil}} and {{para|youngest_fossil}} below.

===Parameters {{para|oldest_fossil}} and {{para|youngest_fossil}}===
These parameters are an alternative way of specifying the fossil range. If {{para|youngest_fossil}} is omitted, its value defaults to "Recent". {{para|oldest_fossil|Devonian}} with {{para|youngest_fossil|Jurassic}} has the same effect as {{para|fossil_range|<code><nowiki>{{Geological range|Devonian|Jurassic}}</nowiki></code>}}. If either parameter has a value that is not recognized as a period name, then plain text is output.

===Parameters {{para|status}}, {{para|status_system}}, and {{para|status_ref}}===
See [[Template:Taxobox/species/doc]].

Tracking categories:
* {{clc|Taxoboxes with an unrecognised status system}}
* {{clc|Taxoboxes needing a status system parameter}}
* {{clc|Invalid conservation status}}

===Parameter {{para|display_parents}}===
If you need to display a certain number of parent taxa, adding a number here will force that many parent taxa to appear.

===Parameter {{para|parent_authority}}, etc.===
'''Parameter {{para|parent_authority}}'''

'''Parameter {{para|grandparent_authority}}'''

'''Parameter {{para|greatgrandparent_authority}}'''

'''Parameter {{para|greatgreatgrandparent_authority}}'''

These function just like {{para|authority}}, except they match up with the parent taxon, grandparent taxon, etc.

;Warning: The "ancestor" taxon is the one defined by the taxonomy templates (i.e. the various "Template:Taxonomy/<taxon>" pages, where <taxon> is the name of a taxon). This "ancestor" taxon may not be the taxon you expect! Further, if someone later changes the taxonomic hierarchy defined in the taxonomy templates by adding or removing a taxon, the authority can become incorrect. For example, if you are setting up a taxobox for a genus and the parent taxon is currently the family, {{para|parent_authority}} shows the authority for the family in the taxobox. If someone later adds a subfamily between the genus and the family, {{para|parent_authority}} will now refer to the subfamily, and the authority will be displayed incorrectly. These parameters should only be used if really necessary.