మూస:Automatic taxobox/doc పేజీ సోర్సు చూడండి

{{Documentation subpage}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->
{{High-use|38680}}
{{Lua|Module:Automated taxobox}}{{clear}}
{{Autotaxobox system navbox}}

This page gives more details on using the {{tl|Automatic taxobox}} template, one of a number of "automated taxobox templates". <strong>Please ensure that you are using the right template; see [[Wikipedia:Automated_taxobox_system/which|Which taxobox should I use?]]</strong>. In particular, articles about species should almost always use {{tl|Speciesbox}}, not this template.

If this is your first time using any of the automated taxobox templates, the pages linked in the navigation box provide information on different parts of the system. It's a good idea to at least read the [[Wikipedia:Automated taxobox system/intro|introduction]].

Every automatic taxobox should contain the following general layout, often with many additional parameters:

'''For zoological taxa:'''
<pre>{{Automatic taxobox
|taxon = Canis
|authority = [[Carl Linnaeus|Linnaeus]], 1758
}}</pre>

'''For botanical<ref name="botanical">Fungi and algae are classically treated as botanical subjects; see [[International Code of Nomenclature for algae, fungi, and plants]].</ref> taxa:'''
<pre>{{Automatic taxobox
|taxon = Nepenthes
|authority = [[Carl Linnaeus|L.]]
}}</pre>

The taxon is the scientific name for whatever the article is about. If you've never entered an authority, you can get help with that from the relevant WikiProject (see a directory at [[WP:TOL#Scope and descendant projects]].

Hit "preview". If it looks correct, you're done. Save your changes. '''Please don't save the page until you've first checked for and resolved all issues with the automatic taxobox.'''

At the end of this guide is a list of all parameters available as well as definitions for all the parameters introduced by <nowiki>{{Automatic taxobox}}</nowiki>. Most parameters from the manual {{tl|Taxobox}} template are valid in an automatic taxobox, and for descriptions of some of the parameters, see the [[Template:Taxobox/doc|documentation]] for that template.

==Creating and manipulating==
==="Missing taxonomy template"===
If you see the message "{{red|Missing taxonomy template}} (fix):", you didn't mess up the automatic taxobox. This error means that there isn't yet a [[Wikipedia:Automated taxobox system/taxonomy templates|taxonomy template]] for the value you've given {{para|taxon}}.

====Creating the taxonomy template====
To begin resolving this ugly red error, right-click the "fix" link and open that link in either a new tab or a new window. On the landing page, you should be editing a template corresponding to whatever taxon is at the end of the page's title. (For a complete guide to taxonomy templates, start at [[Wikipedia:Automated taxobox system/taxonomy templates|Introduction to taxonomy templates]].)

First, fill in the rank parameter. Use the Latin name. Your options are pretty vast here (see [[Wikipedia:TX#Complete blank template]] for an extensive list of supported ranks). Some examples are as follows:
*regnum
*phylum
*classis
*ordo
*familia
*tribus
*genus
*clade or cladus
*unranked

If what you need is something extremely atypical, you can actually just type it there instead of one of the supported ranks. It might break the taxobox, but that's what [[Wikipedia talk:Automated taxobox system]] is for.

You'll see {{para|link}} is already filled in for you with to give
<pre>link={{subst:#titleparts:{{subst:PAGENAME}}|2|2}}</pre>

which happens to be wikisyntax for "the part of the title of the page that comes after "Template:Taxonomy/". In other words, it will be the name of the taxon. You can leave it alone <em>unless</em> the name of the taxon isn't the name of the page it links to. For example, the taxon Spheniscidae is at [[Penguin]]. In this case, you would add <code>Penguin|</code> before <code><nowiki>{{subst:#titleparts:{{subst:PAGENAME}}|2|2}}</nowiki></code> to give
<pre>link=Penguin|{{subst:#titleparts:{{subst:PAGENAME}}|2|2}}</pre>
or you could replace what is there already to give
<pre>link=Penguin|Spheniscidae</pre>

Next, we have the {{para|parent}} parameter. All that you need to type here is the name of the immediate parent taxon, beginning with a capital letter. Use the {{para|refs}} parameter to cite a source which says that the taxon belongs in that parent taxon –  in case someone challenges it later. (The only case in which you might consider omitting this parameter is if you're using a WikiProject approved taxonomy, e.g. [[APG system|APG]] for flowering plants.)

If it's an extinct taxon, fill in the {{para|extinct}} parameter with {{code|yes}} (or {{code|true}}). If it's extant, you can delete the whole line (or leave the value blank).

Now preview the taxonomy template page. If there are no error messages, then close it. Go back to the automatic taxobox you were making. Press "preview" again and now it should be ok. If there are error messages on the taxonomy template page, it probably means you have to repeat the process to create the taxon's parent' taxonomy template. Continue previewing and creating taxonomy templates for the ancestor taxa until the "taxonomy missing" errors cease.

===Special instructions for species===

Species articles only use this template in exceptional circumstances; instead use {{tl|Speciesbox}}. See that page and its documentation.

:The reason is that whenever <nowiki>{{Automatic taxobox}}</nowiki> is used with {{para|taxon|''taxon-name''}}, a template named "Template:Taxonomy/''taxon-name''" must either exist or be created in order to specify the taxonomic position of ''taxon-name''. However, for species this is not necessary, because the taxonomic position of the species can be found by extracting the genus name from the full binomial, and then looking for "Template:Taxonomy/''genus-name''". So using {{tl|Speciesbox}} considerably reduces the number of taxonomy templates needed and avoids there being different taxonomies for different species in a genus.

===Making the links bold===
When a taxobox appears in an article, the taxon the article is about should have its name displayed in bold. For this to work, the {{para|link}} parameter in its taxonomy template must be right. Suppose the taxon in question has the name ''taxon-name'' and the article it appears in has the title ''article-title''. Then in the template "Taxonomy/''taxon-name''":
* if ''taxon-name'' and ''article-title'' are the same, you should see {{para|link|''taxon-name''}}
* if ''taxon-name'' and ''article-title'' are different, you should see {{para|link|''article-title''{{!}}''taxon-name''}}.
Ensure the link is entered so that it points directly to the article on that taxon ''without'' being redirected first. If the page gets moved, the taxon template that links to that article will need to be updated in order to maintain the proper bolding.

===Change the taxobox header===

By default the header to the taxobox will be based on the target taxon and the page title and it will automatically be italicized if it's a genus (this template, <nowiki>{{Automatic taxobox}}</nowiki>, shouldn't normally be used for species).

If you want a different header (e.g. the common name), then specify {{para|name}}.

===Add an image===
Use the {{para|image}} and {{para|image_caption}} parameters just like you would with the {{tl|Taxobox}}.

If you want a second image, add {{para|image2}} and {{para|image2_caption}}.

===పర్యాయపదాలు===
Here's an example of what to add to a taxobox where ''Genius'' and ''Geniosus'' happen to be synonyms of the named zoological taxon:
<source lang="moin">
 |synonyms=
 * ''Genius'' {{small|[[Baggins]], 1934}}
 * ''Geniosus'' {{small|[[Harvey]], 1734}}
</source>
(Dates are omitted for botanical taxa.) For long lists of synonyms, {{tl|Genus list}} and {{tl|Taxon list}} make entry easier. Don't forget to complete {{para|synonyms_ref}}.

===Forcing a taxon to display===
If there's a particularly notable taxon of a minor rank, such as [[Theropoda]] (which contains all carnivorous dinosaurs) chances are that you'd like the taxon to display in every single taxobox that it could possibly be displayed in. Navigate to that taxon's taxonomy template. The link should be "Template:Taxonomy/" followed by the name of the taxon. In the case of Theropoda, the link would be "Template:Taxonomy/Theropoda". Add the code {{para|always_display|true}} anywhere you'd like inside braces, and that should force the taxon to display all the time regardless of its rank.

===Correcting a taxonomy===
Every automatic taxobox has an edit link on the right end of the bar that says "Scientific classification" (it was a red pencil icon {{as of|2019|April|lc=yes}}). That link should give you access to a full listing of that taxon's taxonomy.

From there, you may edit a taxon by clicking "Edit" next to its name. Doing so allows you to access the corresponding Template:Taxonomy/ page, where you can assign a different parent, rank, display text, link, references, extinction status, or "display always" value. Any edits you make to one of these templates will affect ''all its descendent taxa'', so keep that in mind while editing.

==Available parameters and how to use them==
Available parameters (note that all parameters are optional, although to produce the desired results, many may be required):

===All parameters===
{{pre|<nowiki>{{automatic taxobox</nowiki>
[[#Italic title|{{para|italic_title}}]]
[[#Parameter %7Ctaxon=|{{para|taxon}}]]
[[#Parameter %7Cname=|{{para|name}}]]
[[#Parameter %7Cauthority=|{{para|authority}}]]
[[#Parameter %7Cdisplay_parents=|{{para|display_parents}}]]
[[#Parameter %7Cedit_link=|{{para|edit_link}}]]
[[#Parameter %7Cfossil_range=|{{para|fossil_range}}]]
[[#Parameter %7Coldest_fossil=|{{para|oldest_fossil}}]]
[[#Parameter %7Cyoungest_fossil=|{{para|youngest_fossil}}]]
[[#Parameter %7Cdisplay_parents=|{{para|display_parents}}]]
[[#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}}]]
{{para|color_as}}
{{para|status}}
{{para|status_system}}
{{para|status_ref}}
{{para|status2}}
{{para|status2_system}}
{{para|status2_ref}}
{{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}}
{{para|diversity}}
{{para|diversity_link}}
{{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|subdivision}}
{{para|subdivision_ranks}}
{{para|type_strain}}
{{para|range_map}}
{{para|range_map_upright}}
{{para|range_map_alt}}
{{para|range_map_caption}}
{{para|binomial2}}
{{para|binomial2_authority}}
{{para|range_map2}}
{{para|range_map2_upright}}
{{para|range_map2_alt}}
{{para|range_map2_caption}}
{{para|binomial3}}
{{para|binomial3_authority}}
{{para|range_map3}}
{{para|range_map3_upright}}
{{para|range_map3_alt}}
{{para|range_map3_caption}}
{{para|binomial4}}
{{para|binomial4_authority}}
{{para|range_map4}}
{{para|range_map4_upright}}
{{para|range_map4_alt}}
{{para|range_map4_caption}}
{{para|synonyms}}
{{para|synonyms_ref}}
<nowiki>}}</nowiki>}}

===Italic title===
It is not usually necessary to add {{tl|Italic title}} to an article that uses the Automatic taxobox template. If the title should be italicized, based on whether the page title matches the name of the taxon and the taxon's rank is genus or below, it will be added automatically.

In a few cases, the italicization produced by {{tl|Italic title}} is incorrect. For example, if the article title is a subgenus formatted like "Mus (Coelomys)", the parenthesized subgenus will be treated as a disambiguation term, so that the title would appear incorrectly as "''Mus'' (Coelomys)". In such cases:
* put {{para|italic_title|no}} in the taxobox to prevent the automatic addition of {{tl|Italic title}}
* use <nowiki>{{DISPLAYTITLE:...}}</nowiki> to italicize the page title, e.g. <nowiki>{{DISPLAYTITLE:''Mus'' (''Coelomys'')}}</nowiki>

===Parameters unique to <nowiki>{{Automatic taxobox}}</nowiki>===
In the following sections, parameters used by {{tl|Taxobox}} may not be covered in detail. See its documentation.

====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.

====Parameter {{para|edit_link}}====
In most cases, there is no reason to use this parameter. If used, whatever is entered here will display in single brackets in place of the letter "e". This is the "edit taxonomy" link which allows readers to easily access the taxonomy for quick, universal edits.

====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.

====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.

== TemplateData ==
{{TemplateData header}}
<templatedata>
{
	"params": {
		"color_as": {
			"type": "string",
			"description": "Taxon defining the taxobox color if needed (normally not) ",
			"example": "Animalia"
		},
		"taxon": {
			"type": "string",
			"required": true,
			"description": "Scientific name of group with no formatting ",
			"example": "Pectinidae"
		},
		"name": {
			"type": "string",
			"description": "Title of the taxobox; may be the English name of the group ",
			"example": "Scallop"
		},
		"authority": {
			"type": "string",
			"description": "The desribing authority for the group in the appropriate format, which differs between nomenclature codes; presence or absence of parentheses is meaningful ",
			"example": "Wilkes, 1810 – animal; (L.) Mill. – plant",
			"required": true
		},
		"display_parents": {
			"type": "number"
		},
		"fossil_range": {
			"type": "wiki-template-name",
			"description": "The geologic time span during which the group is generally known to have existed, given in eras; the template {{Fossil range}} is the most common method of presenting this information ",
			"example": "{{Fossil range|Middle Triassic|Present}} "
		},
		"oldest_fossil": {
			"type": "string",
			"description": "The geological era of the oldest known fossil; paired with youngest_fossil, an alternative to fossil_range ",
			"example": "Devonian "
		},
		"youngest_fossil": {
			"type": "string",
			"description": "The geological era of the youngest known fossil; paired with oldest_fossil, an alternative to fossil_range; defaults to 'Recent' ",
			"example": "Jurassic "
		},
		"status_system": {
			"type": "string",
			"description": "The authority assigning a conservation status",
			"example": "IUCN3.1",
			"deprecated": "Automatic taxoboxes are used for taxa above species rank. Conservation status is very rarely assigned to taxa above species rank."
		},
		"status_ref": {
			"type": "string",
			"description": "A citation that supports the displayed status and status_system parameters",
			"deprecated": "Automatic taxoboxes are used for taxa above species rank. Conservation status is very rarely assigned to taxa above species rank"
		},
		"image": {
			"type": "wiki-file-name",
			"suggested": true,
			"description": "An image of  member of the group, given without the File: or Image: prefix and without double brackets ",
			"example": "Argopecten irradians.jpg"
		},
		"image_caption": {
			"type": "string",
			"description": "A caption for the image, if any is necessary ",
			"example": "The Atlantic bay scallop in a feeding pose "
		},
		"subdivision_ranks": {
			"type": "string",
			"suggested": true
		},
		"subdivision": {
			"type": "string",
			"suggested": true
		},
		"synonyms_ref": {
			"type": "string"
		},
		"type_species": {
			"type": "string",
			"description": "The original name of the species that was initially used to describe a genus, without regard to its present-day nomenclature"
		},
		"type_species_authority": {
			"type": "string",
			"description": "The describer of the original name of the species, so without parentheses"
		},
		"parent_authority": {
			"type": "string",
			"description": "The describing authority for the parent taxon of a group. Should only be specified when the parent taxon is monotypic"
		},
		"diversity": {
			"type": "string"
		},
		"diversity_link": {},
		"diversity_ref": {
			"type": "string"
		},
		"range_map": {
			"type": "wiki-file-name",
			"description": "The name of the image file, if any, showing the group's geographic habitat range, without the File: or Image: prefix and without double brackets ",
			"example": "Aplodontia rufa distribution map.png"
		},
		"range_map_caption": {
			"type": "string"
		},
		"type_genus": {
			"type": "string",
			"description": "The original name of the genus that was initially used to define a taxon at a rank above genus, without regard to its present-day nomenclature"
		},
		"type_genus_authority": {
			"type": "string"
		},
		"image2": {
			"type": "wiki-file-name"
		},
		"image2_caption": {
			"type": "string"
		},
		"image_alt": {
			"type": "string"
		},
		"grandparent_authority": {
			"type": "string",
			"description": "The describing authority for the grandparent taxon of a group. Should only be specified when the grandparent and parent taxa are monotypic"
		},
		"image_upright": {
			"type": "number",
			"description": "Used to adjust the displayed size of an image with an extreme aspect ratio. Values under 1.0 decrease the size of an image (most useful for very tall, narrow images) Values over 1.0 increase the size of an image (possibly useful for short, wide images)"
		},
		"range_map_upright": {},
		"range_map_alt": {},
		"greatgrandparent_authority": {
			"description": "The describing authority for the greatgrandparent taxon of a group. Should only be specified when the greatgrandparent, grandparent and parent taxa are monotypic"
		},
		"image2_alt": {},
		"image2_upright": {},
		"range_map2": {},
		"range_map2_alt": {},
		"range_map2_caption": {},
		"synonyms": {},
		"classification_status": {
			"description": "The status of the scientific group, usually presented as either Disputed or Accepted ",
			"example": "Disputed ",
			"type": "string"
		},
		"status": {
			"description": "The conservation status of the taxon",
			"deprecated": "Automatic taxoboxes are used for taxa above species rank. Conservation status is very rarely assigned to taxa above species rank"
		}
	},
	"description": "An infobox for plants, animals and other biological taxa, normally at the rank of genus and above",
	"paramOrder": [
		"color_as",
		"name",
		"fossil_range",
		"oldest_fossil",
		"youngest_fossil",
		"image",
		"image_upright",
		"image_alt",
		"image_caption",
		"image2",
		"image2_upright",
		"image2_alt",
		"image2_caption",
		"status",
		"status_system",
		"status_ref",
		"classification_status",
		"greatgrandparent_authority",
		"grandparent_authority",
		"parent_authority",
		"display_parents",
		"taxon",
		"authority",
		"type_species",
		"type_species_authority",
		"type_genus",
		"type_genus_authority",
		"subdivision_ranks",
		"subdivision",
		"diversity",
		"diversity_link",
		"diversity_ref",
		"range_map",
		"range_map_upright",
		"range_map_alt",
		"range_map_caption",
		"range_map2",
		"range_map2_alt",
		"range_map2_caption",
		"synonyms",
		"synonyms_ref"
	],
	"format": "block"
}
</templatedata>

== Tracking/maintenance categories ==
* {{clc|Automatic taxobox cleanup}}
* {{clc|Automatic taxoboxes using binomial parameter}}

==Footnotes==
{{reflist}}

<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox | |
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Biology infobox templates]]
[[Category:Infobox templates|Automatic taxobox]]
[[Category:Taxobox templates]]
[[Category:Templates that add a tracking category]]
}}</includeonly>