模组:Autotaxobox/doc
这是Module:Autotaxobox的文档页面
 | 此模块使用Lua语言： |
 | 此模块文档被引用于约181,000个页面。 为了避免造成大规模的影响，所有对此模块文档的编辑应先于沙盒或测试样例上测试。 测试后无误的版本可以一次性地加入此模块文档中，但是修改前请务必于讨论页发起讨论。 模板引用数量会自动更新。 |
 | 此模块文档已被保护。此为高度可见模块文档，其已用于大量条目或被频繁替换引用。由于破坏或失误会影响诸多页面，即便细小的改动也可能导致大量服务器负载，因此已被保护，不可编辑。 |
Module:Autotaxobox （talk · · hist · links · doc · subpages · sandbox · testcases）
The purpose of this module is to provide support for the automated taxobox system (including templates such as {{Speciesbox}} and {{Automatic taxobox}}), avoiding Mediawiki template expansion depth errors in the traversal of the taxonomic hierarchies encoded in taxonomy templates.
Currently, processing is arbitrarily limited to hierarchies containing at most 100 levels.
See the automated taxobox system map for information on how the module's functions are used in the system.
taxoboxColour
编辑Given a taxon name, this function returns the correct colour of an automated taxobox for that taxon. It does so by searching up the taxonomic hierarchy for a 'real' taxon (i.e. not incertae sedis) that sets the taxobox colour, and then returning that colour. If no 'real' taxon is found, then if an incertae sedis taxon was found, the incertae sedis colour is returned, otherwise "transparent" is returned. (If the taxonomic hierarchy is too deep to process, the error colour is returned.)
Usage:
{{#invoke:Autotaxobox|taxoboxColour|taxon_name}}
Parameters:
- The unnamed parameter should be the name of a taxon for which "Template:Taxonomy/taxon_name" exists.
Examples:
- {{#invoke:Autotaxobox|taxoboxColour|Felis}} → rgb(235,235,210)
- {{#invoke:Autotaxobox|taxoboxColour|Acacia}} → rgb(180,250,180)
taxoboxList
编辑Given the name of a taxon, this function returns the rows of taxa in an automated taxobox, based on the taxonomic hierarchy for the supplied taxon. If the lowest taxon displayed in the taxobox is below the rank of genus, the supplied taxon will usually be at a higher rank than the taxobox's target taxon, so that there is an offset to be taken into account.
Usage:
{{#invoke:Autotaxobox|taxoboxList
|the name of taxon upwards from which the taxonomic hierarchy is to be displayed by this function
|display_taxa = the number of taxa above taxon to force to be displayed
|authority = taxonomic authority for the lowest level taxon in the taxobox (the taxobox_target) (see also offset below)
|parent_authority = taxonomic authority for taxobox_target's parent
|gparent_authority = taxonomic authority for taxobox_target's grandparent
|ggparent_authority = taxonomic authority for taxobox_target's greatgrandparent
|gggparent_authority = taxonomic authority for taxobox_target's greatgreatgrandparent
|bold_first = bold to embolden taxon in its row
|offset = the offset of taxon from taxobox_target – the number of steps from taxobox_target to taxon
}}
Parameters:
- The unnamed parameter should be the name of a taxon for which "Template:Taxonomy/taxon_name" exists. The others are explained above.
Examples:
{| class="wikitable"
{{#invoke:Autotaxobox|taxoboxList|Felis|authority=Linnaeus, 1758}}
|}→
| 界： | 动物界 Animalia |
| 门： | 脊索动物门 Chordata |
| 纲： | 哺乳纲 Mammalia |
| 目： | 食肉目 Carnivora |
| 科： | 猫科 Felidae |
| 演化级： | 假猫级 Pseudaelurus |
| 亚科： | 猫亚科 Felinae |
| 属： | 猫属 Felis Linnaeus, 1758 |
taxonomyList
编辑Given a taxon name, this function returns the rows of the taxonomy table displayed on the "Template:Taxonomy/taxon_name" page, based on the taxonomic hierarchy for the supplied taxon name.
When descending the taxonomic hierarchy, if a rank is found that is at either the same or a higher level than a rank already encountered (e.g. a family is found below a subfamily), the cell displaying the rank is given a reddish background; if it's the supplied taxon, the article is put into the tracking category Category:Taxonomy templates showing anomalous ranks. The numerical values defined in getRankTable() are used to determine the correct sequence of ranks. Ranks without values in this table do not have their order checked.
Usage:
{{#invoke:Autotaxobox|taxonomyList|taxon_name}}
Parameters:
- The unnamed parameter should be the name of a taxon for which "Template:Taxonomy/taxon_name" exists.
Examples:
{{#invoke:Autotaxobox|taxonomyList|Felis}}→
粗体层级代表主要层级或者已被设置
为“总是显示”（always_display=yes）
| 上级分类单元 | |||
|---|---|---|---|
| 域： | 真核域 Eukaryota | [查看 · 编辑] | |
| 演化支： | 单鞭毛生物 Amorphea | [查看 · 编辑] | |
| 演化支： | OBA 超类群 Obazoa | [查看 · 编辑] | |
| 演化支： | 后鞭毛生物 Opisthokonta | [查看 · 编辑] | |
| 总界： | 动物总界 Holozoa | [查看 · 编辑] | |
| 演化支： | 蜷丝动物 Filozoa | [查看 · 编辑] | |
| 演化支： | 领鞭毛动物 Choanozoa | [查看 · 编辑] | |
| 界： | 动物界 Animalia | [查看 · 编辑] | |
| 亚界： | 真后生动物亚界 Eumetazoa | [查看 · 编辑] | |
| 演化支： | 副同源异形基因动物 ParaHoxozoa | [查看 · 编辑] | |
| 演化支： | 两侧对称动物 Bilateria | [查看 · 编辑] | |
| 演化支： | 肾管动物 Nephrozoa | [查看 · 编辑] | |
| 总门： | 后口动物总门 Deuterostomia | [查看 · 编辑] | |
| 门： | 脊索动物门 Chordata | [查看 · 编辑] | |
| ..... | ..... | ||
| 纲： | 哺乳纲 Mammalia | /skip | [查看 · 编辑] |
| 演化支： | 兽形类 Theriimorpha | [查看 · 编辑] | |
| 演化支： | 兽型类 Theriiformes | [查看 · 编辑] | |
| 演化支： | Trechnotheria | [查看 · 编辑] | |
| 演化支： | 歧兽类 Cladotheria | [查看 · 编辑] | |
| 演化支： | 原磨楔齿类 Prototribosphenida | [查看 · 编辑] | |
| 演化支： | Zatheria | [查看 · 编辑] | |
| 演化支： | 磨楔齿类 Tribosphenida | [查看 · 编辑] | |
| 亚纲： | 兽亚纲 Theria | [查看 · 编辑] | |
| 下纲： | 真兽下纲 Eutheria | [查看 · 编辑] | |
| 演化支： | 有胎盘类 Placentalia | [查看 · 编辑] | |
| 高目： | 北方真兽高目 Boreoeutheria | [查看 · 编辑] | |
| 总目： | 劳亚兽总目 Laurasiatheria | [查看 · 编辑] | |
| 演化支： | 有阴囊类 Scrotifera | [查看 · 编辑] | |
| 大目： | 猛兽有蹄大目 Ferungulata | [查看 · 编辑] | |
| 上目： | 猛兽上目 Ferae | [查看 · 编辑] | |
| 演化支： | 泛食肉类 Pan-Carnivora | [查看 · 编辑] | |
| 演化支： | 食肉形类 Carnivoramorpha | [查看 · 编辑] | |
| 演化支： | 食肉型类 Carnivoraformes | [查看 · 编辑] | |
| 目： | 食肉目 Carnivora | [查看 · 编辑] | |
| 亚目： | 猫型亚目 Feliformia | [查看 · 编辑] | |
| 总科： | 猫总科 Feloidea | [查看 · 编辑] | |
| 科： | 猫科 Felidae | [查看 · 编辑] | |
| 演化级： | 假猫级 Pseudaelurus | /grade | [查看 · 编辑] |
| 亚科： | 猫亚科 Felinae | [查看 · 编辑] | |
| 属： | 猫属 Felis | [查看 · 编辑] | |
callTaxonomyKey
编辑This function prepares for, and then calls, {{Taxonomy key}} to display a taxonomy
template page. It does this by building up the information the template
requires, following one same_as link if present, and then calling it.
It is used by {{Don't edit this line}}.
Usage:
{{#invoke:Autotaxobox|callTaxonomyKey
|taxon=
|parent=
|rank=
|extinct=
|always_display=
|link_target=value of the 'link' parameter in the taxonomy template
|link_text=value of the unnamed parameter in the taxonomy template
|refs=
|same_as=
}}
showRefs
编辑Shows the refs field in a taxonomy template, handing incertae sedis taxa and using '–' for absent refs.
Usage:
- {{#invoke:Autotaxobox|showRefs|taxon_name|refs}}
Examples:
- {{#invoke:Autotaxobox|showRefs|Neoscona|{{Taxon info|Neoscona|refs}}}} → –
- {{#invoke:Autotaxobox|showRefs|Incertae sedis/Characidae|}} → not applicable (incertae sedis)
taxonLink
编辑Returns a wikilink to a taxon, if required including '†' before it and ' (?)' after it, and optionally italicized or bolded without a wikilink. It can be used externally via {{Taxon link}}. Some parameters can, under some circumstances, be omitted.
Usage:
{{#invoke:Autotaxobox|taxonLink(having '/?' at the end triggers the output of ' (?)')
|taxon=
|extinct=
|bold=
|italic=
|link_target=target for the wikilink
|plain_link_text= text of the wikilink
}}
Examples:
- {{#invoke:Autotaxobox|taxonLink|taxon=Felis|italic=yes}} → Felis
- {{#invoke:Autotaxobox|taxonLink|taxon=Incertae sedis/Animalia}} → 地位未定 incertae sedis
- {{#invoke:Autotaxobox|taxonLink|link_target=Pterosaur|plain_link_text=Pterosauromorpha|extinct=yes}} → †Pterosauromorpha
- {{#invoke:Autotaxobox|taxonLink|taxon=Dinosauria/?|link_target=Dinosaur|plain_link_text=Dinosauria|extinct=yes}} → †Dinosauria (?)
Utilities
编辑These functions are intended to be used only in analysing and understanding the automated taxobox system, including the taxonomic hierarchies encoded in taxonomy templates – for example in testing and debugging. They are not part of the functioning of the automated taxobox system.
showRankTable
编辑Returns a sortable wikitable containing the ranks and corresponding numerical values defined in getRankTable() and used in checking the consistency of a taxonomic hierarchy. If a taxon has a value in the rank table, it should always be lower than one higher in the taxonomic hierarchy.
Usage:
{{#invoke:Autotaxobox|showRankTable}}
taxonInfo
编辑Given the names of a taxon and the required item of information stored in the taxon's taxonomy template, this function returns the value of the item, following one "same as" link if available and the value would otherwise be the empty string.
Usage:
{{#invoke:Autotaxobox|taxonInfo|taxon_name|item_name}}
Parameters:
- The first unnamed parameter should be the name of a taxon for which "Template:Taxonomy/taxon_name" exists.
- The possible values of the second unnamed parameter are given at {{Taxon info/doc}}.
Examples:
- {{#invoke:Autotaxobox|taxonInfo|Felis|rank}} → genus
- {{#invoke:Autotaxobox|taxonInfo|Aves/skip|same_as}} → Aves
- {{#invoke:Autotaxobox|taxonInfo|Aves/skip|parent}} → Chordata
getMaxSearchLevels
编辑Returns the maximum number of levels of a taxonomic hierarchy encoded in taxonomy templates that the system will search.
Usage:
{{#invoke:Autotaxobox|getMaxSearchLevels}}→ 100
find
编辑Given a taxon name and a rank, this function returns the taxon's ancestor of the given rank.
Usage:
{{#invoke:Autotaxobox|find|taxon_name|rank}}
Parameters:
- The first unnamed parameter should be the name of a taxon for which "Template:Taxonomy/taxon_name" exists.
- The second unnamed parameter should be the Latinized name of a rank.
Examples:
{{#invoke:Autotaxobox|find|Felis|ordo}}→ Carnivora{{#invoke:Autotaxobox|find|Felis|classis}}→ Mammalia/skip{{#invoke:Autotaxobox|find|Pteranodon|phylum}}→ Chordata{{#invoke:Autotaxobox|find|Pteranodon|classis}}→ Sauropsida
nth
编辑Given a taxon name, this function returns the nth taxon above it in the taxonomic hierarchy.
Usage:
{{#invoke:Autotaxobox|nth|taxon_name|n=integer}}
Parameters:
- The unnamed parameter should be the name of a taxon for which "Template:Taxonomy/taxon_name" exists.
- n is the level whose taxon is to be found
Examples:
- {{#invoke:Autotaxobox|nth|Felis|n=1}} → Felis
- {{#invoke:Autotaxobox|nth|Felis|n=15}} → Boreoeutheria
nLevels
编辑Given a taxon name, this function returns the number of levels at and above it in the taxonomic hierarchy.
Usage:
{{#invoke:Autotaxobox|nLevels|taxon_name}}
Parameters:
- The unnamed parameter should be the name of a taxon for which "Template:Taxonomy/taxon_name" exists.
Examples:
- {{#invoke:Autotaxobox|nLevels|Felis}} → 41
- {{#invoke:Autotaxobox|nLevels|Pteranodon}} → 52
listAll
编辑Given a taxon name, this function returns a comma-separated list of all the levels at and above it in the taxonomic hierarchy.
Usage:
{{#invoke:Autotaxobox|listAll|taxon_name}}
Parameters:
- The unnamed parameter should be the name of a taxon for which "Template:Taxonomy/taxon_name" exists.
Examples:
- {{#invoke:Autotaxobox|listAll|Plantae}} → Plantae-regnum, Archaeplastida-cladus, CAM-cladus, Diaphoretickes-cladus, Eukaryota-domain, Life-
- {{#invoke:Autotaxobox|listAll|Felis}} → Felis-genus, Felinae-subfamilia, Pseudaelurus/grade-grade, Felidae-familia, Feloidea-superfamilia, Feliformia-subordo, Carnivora-ordo, Carnivoraformes-cladus, Carnivoramorpha-cladus, Pan-Carnivora-cladus, Ferae-mirordo-mb, Ferungulata-grandordo-mb, Scrotifera-cladus, Laurasiatheria-superordo, Boreoeutheria-magnordo, Placentalia-cladus, Eutheria-infraclassis, Theria-subclassis, Tribosphenida-cladus, Zatheria-cladus, Prototribosphenida-cladus, Cladotheria-cladus, Trechnotheria-cladus, Theriiformes-cladus, Theriimorpha-cladus, Mammalia/skip-classis, Chordata-phylum, Deuterostomia-superphylum, Nephrozoa-cladus, Bilateria-cladus, ParaHoxozoa-cladus, Eumetazoa-subregnum, Animalia-regnum, Choanozoa-cladus, Filozoa-cladus, Holozoa-superregnum, Opisthokonta-cladus, Obazoa-cladus, Amorphea-cladus, Eukaryota-domain, Life-