Bản mẫu:Speciesbox/doc

Tài liệu về hệ thống Bảng phân loại tự động

{{Speciesbox}} is one of the automated taxobox templates used to generate a taxobox automatically. (Tính đến tháng 2 năm 2019 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. 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.

Cách sử dụng

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:

• Simple cases, where the species is not a hybrid so that the × symbol is not present, the genus name is unique and not duplicated between kingdoms, and the species is not the only one in the genus.
• Hybrid species names, where the symbol × is required.
• Species where the genus name is duplicated between kingdoms, so the taxonomy for the genus must distinguish between kingdoms (e.g. Acanthocarpus (plant) and Acanthocarpus (crab)).
• Monospecific genera, where the species and genus articles are combined, with the article title being the genus name.
• Parent taxon not the genus, where the parent taxon must be specified as it cannot be deduced from the binomial.

Simple cases

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:

• |taxon=name of the species without any formatting (e.g. Quercus major, Lobatus gigas)

(Alternatively you can use the 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)

This slightly reduces the processing needed.)

If necessary, you can also use:

• |subgenus=link to subgenus – deprecated, use |parent= – see below

It's not necessary to include {{Nhan đề nghiêng}} in the article; this will be added automatically by the Speciesbox template if needed.

For more complicated cases, see the other sections below.

Simple examples

• Page at the binomial name; displayed taxobox to have the binomial name as its title, e.g. Lobatus gigas.

{{Speciesbox

| taxon = Lobatus gigas --recommended 

| authority = (Linnaeus, 1758) --optional; this is the authority for the binomial (species) name

... --other optional parameters, e.g. for an image

}}

Alternatively, use separate parameters for the genus name and the specific name/epithet.

{{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

}}

• Page at the binomial name; displayed taxobox to have the common name as its title, e.g. Allium moly.

{{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

}}

• Page at the common name; displayed taxobox to have the same common name as its title, e.g. Lily of the valley.

{{Speciesbox

| name = Lily of the valley --optional (defaults to page title)

| taxon = Convallaria majalis --essential

... --other optional parameters, e.g. for an image

}}

Extinct species

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.

Hybrid botanical species

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:

• The × character is available in the list under the edit text box. Alternatively, use ×. (If you use {{hybrid}}, the automatic italicization of the article title won't work.)
• In the article body, you can either use ''Polygonatum'' × ''hybridum'', ''Polygonatum'' × ''hybridum''or ''Polygonatum {{hybrid}} hybridum'' to obtain the correct italicization.

Genus names duplicated across kingdoms

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.

Monospecific genera

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.

Parent taxon is not the genus

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:

• "Template:Taxonomy/Genus (Subgenus)" for a zoological subgenus, e.g. Template:Taxonomy/Mus (Coelomys)
• "Template:Taxonomy/Genus subg. Subgenus" for a botanical subgenus, e.g. Template:Taxonomy/Pinus subg. Pinus
• "Template:Taxonomy/Genus sect. Section" for a botanical section, e.g. Template:Taxonomy/Pinus sect. Trifoliae

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

Italicizing the article title

The template can normally determine whether the page title matches the species or the genus in the taxobox, and if so outputs {{Nhan đề nghiêng}}, 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). Automatic italicization can be over-ridden by setting |italic_title=no.

Requirement for correct display

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.

Xem thêm

• An example: Template:Speciesbox/example
• {{Paraphyletic group}}
• {{Taxonbar}}

Template Data

Đây là tài liệu Dữ liệu bản mẫu cho bản mẫu này được sử dụng bởi Trình soạn thảo trực quan và các công cụ khác; xem báo cáo sử dụng tham số hàng tháng cho bản mẫu này.

Dữ liệu bản mẫu cho Speciesbox

An infobox for species of organisms where {{tl|Automatic taxobox}} is used at the genus and higher ranks

Tham số bản mẫu

Nên dùng bản mẫu này với các tham số đặt thành khối.

Tham số		Miêu tả	Kiểu	Trạng thái
color_as	color_as	không có miêu tả	Chuỗi dài	tùy chọn
name	name	không có miêu tả	Chuỗi dài	tùy chọn
fossil_range	fossil_range	không có miêu tả	Không rõ	tùy chọn
image	image	không có miêu tả	Tập tin	khuyên dùng
image_width	image_width	không có miêu tả	Chuỗi dài	lỗi thời
image_upright	image_upright	không có miêu tả	Không rõ	tùy chọn
image_alt	image_alt	không có miêu tả	Chuỗi dài	tùy chọn
image_caption	image_caption	không có miêu tả	Chuỗi dài	tùy chọn
image2	image2	không có miêu tả	Tập tin	tùy chọn
image2_width	image2_width	không có miêu tả	Chuỗi dài	lỗi thời
image2_upright	image2_upright	không có miêu tả	Số	tùy chọn
image2_alt	image2_alt	không có miêu tả	Chuỗi dài	tùy chọn
image2_caption	image2_caption	không có miêu tả	Chuỗi dài	tùy chọn
status	status	không có miêu tả	Không rõ	tùy chọn
status_system	status_system	không có miêu tả	Không rõ	tùy chọn
status_ref	status_ref	không có miêu tả	Không rõ	tùy chọn
status2	status2	không có miêu tả	Không rõ	tùy chọn
status2_system	status2_system	không có miêu tả	Không rõ	tùy chọn
status2_ref	status2_ref	không có miêu tả	Không rõ	tùy chọn
extinct	extinct	không có miêu tả	Không rõ	tùy chọn
classification_status	classification_status	không có miêu tả	Không rõ	tùy chọn
display_parents	display_parents	không có miêu tả	Không rõ	tùy chọn
greatgrandparent_authority	greatgrandparent_authority	không có miêu tả	Không rõ	tùy chọn
grandparent_authority	grandparent_authority	không có miêu tả	Không rõ	tùy chọn
parent_authority	parent_authority	không có miêu tả	Không rõ	tùy chọn
taxon	taxon	không có miêu tả	Chuỗi dài	tùy chọn
genus	genus	không có miêu tả	Chuỗi dài	tùy chọn
subgenus	subgenus	không có miêu tả	Chuỗi dài	tùy chọn
parent	parent	không có miêu tả	Không rõ	tùy chọn
species	species	không có miêu tả	Chuỗi dài	tùy chọn
authority	authority	không có miêu tả	Chuỗi dài	khuyên dùng
subdivision_ranks	subdivision_ranks	không có miêu tả	Chuỗi dài	tùy chọn
subdivision	subdivision	không có miêu tả	Không rõ	tùy chọn
range_map	range_map	không có miêu tả	Tập tin	tùy chọn
range_map_width	range_map_width	không có miêu tả	Chuỗi dài	lỗi thời
range_map_upright	range_map_upright	không có miêu tả	Không rõ	tùy chọn
range_map_alt	range_map_alt	không có miêu tả	Chuỗi dài	tùy chọn
range_map_caption	range_map_caption	không có miêu tả	Chuỗi dài	tùy chọn
range_map2	range_map2	không có miêu tả	Tập tin	tùy chọn
range_map2_width	range_map2_width	không có miêu tả	Chuỗi dài	lỗi thời
range_map2_upright	range_map2_upright	không có miêu tả	Số	tùy chọn
range_map2_alt	range_map2_alt	không có miêu tả	Chuỗi dài	tùy chọn
range_map2_caption	range_map2_caption	không có miêu tả	Chuỗi dài	tùy chọn
synonyms	synonyms	không có miêu tả	Không rõ	tùy chọn
synonyms_ref	synonyms_ref	không có miêu tả	Không rõ	tùy chọn