Rox: 1 revision imported

2026-09-21T16:46:50Z

1 revision imported

← Older revision		Revision as of 11:46, 21 September 2026
(No difference)

Wikipedia>Cedar101: /* taxonomyList */ {{markupv}}

2026-02-20T00:48:49Z

taxonomyList: {{markupv}}

New page

{{High-risk}}
{{Module rating|protected}}
{{Lua|Module:TaxonItalics|Module:Taxobox ranks}}


[[Module:Autotaxobox]] {{Toolbar|style=font-size:90% |separator=dot
| 1 = [[:Module talk:Autotaxobox|talk]]
| 2 = {{edit|1=Module:Autotaxobox|2=edit}}
| 3 = {{history|Module:Autotaxobox|hist}}
| 4 = [{{fullurl:Special:WhatLinksHere/:Module:Autotaxobox|limit=999}} links]
| 5 = [[Module:Autotaxobox/doc|doc]]
| 6 = [[Special:PrefixIndex/Module:Autotaxobox|subpages]]
| 7 = [[Module:Autotaxobox/sandbox|sandbox]]
| 8 = [[Module:Autotaxobox/testcases|testcases]]
}}

The purpose of this module is to provide support for the [[WP:Automated taxobox system|automated taxobox system]] (including templates such as {{tl|Speciesbox}} and {{tl|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 {{#invoke:Autotaxobox|getMaxSearchLevels}} levels.

See the [[WP:Automated taxobox system/map|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:

:{{mlx|Autotaxobox|taxoboxColour|''taxon_name''}}

Parameters:

:The unnamed parameter should be the name of a taxon for which "Template:Taxonomy/''taxon_name''" exists.

Examples:

:{{mlx|Autotaxobox|taxoboxColour|Felis}} → {{#invoke:Autotaxobox|taxoboxColour|Felis}}
:{{mlx|Autotaxobox|taxoboxColour|Acacia}} → {{#invoke:Autotaxobox|taxoboxColour|Acacia}}

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

<syntaxhighlight lang="wikitext">{{#invoke:Autotaxobox|taxoboxList
| 
|display_taxa = 
|authority = 
|parent_authority = 
|gparent_authority = 
|ggparent_authority = 
|gggparent_authority = 
|bold_first = 
|offset = 
}}</syntaxhighlight>

===Parameters===

:The unnamed parameter should be the name of a taxon for which "Template:Taxonomy/''taxon_name''" exists. The others are explained above.

===Examples===
{|
|<syntaxhighlight lang="wikitext">{| class="wikitable"
{{#invoke:Autotaxobox|taxoboxList|Felis|authority=Linnaeus, 1758}}
|}</syntaxhighlight> || → ||
{| class="wikitable"
{{#invoke:Autotaxobox|taxoboxList|Felis|authority=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 <em>descending</em> 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 <code>getRankTable()</code> are used to determine the correct sequence of ranks. Ranks without values in this table do not have their order checked.

===Usage===

:{{mlx|Autotaxobox|taxonomyList|''taxon_name''}}

====Parameters====

:The unnamed parameter should be the name of a taxon for which "Template:Taxonomy/''taxon_name''" exists.

{{markupv|t=Examples
|m=<nowiki>{{#invoke:Autotaxobox|taxonomyList|Felis}}</nowiki>
|r={{#invoke:Autotaxobox|taxonomyList|Felis}}
}}

== callTaxonomyKey ==
This function prepares for, and then calls, {{tl|Taxonomy key}} to display a taxonomy
template page (which in turn invokes [[#taxonomyList|<code>taxonomyList</code>]] from this module). It does this by building up the information the template
requires, following one <code>same_as</code> link if present, and then calling it.

It is used by {{tl|Don't edit this line}}.

Usage:

<syntaxhighlight lang="wikitext">{{#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=
}}</syntaxhighlight>

== showRefs ==
Shows the refs field in a taxonomy template, handing incertae sedis taxa and using '–' for absent refs.

===Usage===
:{{mlx|Autotaxobox|showRefs|''taxon_name''|''refs''}}

===Examples===
:<syntaxhighlight lang="wikitext" inline>{{#invoke:Autotaxobox|showRefs|Neoscona|{{Taxon info|Neoscona|refs}}}}</syntaxhighlight> → {{#invoke:Autotaxobox|showRefs|Neoscona|{{Taxon info|Neoscona|refs}}}}
:<syntaxhighlight lang="wikitext" inline>{{#invoke:Autotaxobox|showRefs|Incertae sedis/Characidae|}}</syntaxhighlight> → {{#invoke:Autotaxobox|showRefs|Incertae sedis/Characidae|}}

== 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 {{tl|Taxon link}}. Some parameters can, under
some circumstances, be omitted.

===Usage===

<syntaxhighlight lang="wikitext">{{#invoke:Autotaxobox|taxonLink
|taxon= 
|extinct= 
|bold= 
|italic= 
|link_target= 
|plain_link_text= 
}}</syntaxhighlight>

===Examples===

:<syntaxhighlight lang="wikitext" inline>{{#invoke:Autotaxobox|taxonLink|taxon=Felis|italic=yes}}</syntaxhighlight> → {{#invoke:Autotaxobox|taxonLink|taxon=Felis|italic=yes}}
:<syntaxhighlight lang="wikitext" inline>{{#invoke:Autotaxobox|taxonLink|taxon=Incertae sedis/Animalia}}</syntaxhighlight> → {{#invoke:Autotaxobox|taxonLink|taxon=Incertae sedis/Animalia}}
:<syntaxhighlight lang="wikitext" inline>{{#invoke:Autotaxobox|taxonLink|link_target=Pterosaur|plain_link_text=Pterosauromorpha|extinct=yes}}</syntaxhighlight> → {{#invoke:Autotaxobox|taxonLink|link_target=Pterosaur|plain_link_text=Pterosauromorpha|extinct=yes}}
:<syntaxhighlight lang="wikitext" inline>{{#invoke:Autotaxobox|taxonLink|taxon=Dinosauria/?|link_target=Dinosaur|plain_link_text=Dinosauria|extinct=yes}}</syntaxhighlight> → {{#invoke:Autotaxobox|taxonLink|taxon=Dinosauria/?|link_target=Dinosaur|plain_link_text=Dinosauria|extinct=yes}}

==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:
:{{mlx|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 {{tl|Taxon info/doc}}.

Examples:
:{{mlx|Autotaxobox|taxonInfo|Felis|rank}} → {{#invoke:Autotaxobox|taxonInfo|Felis|rank}}
:{{mlx|Autotaxobox|taxonInfo|Aves/skip|same_as}} → {{#invoke:Autotaxobox|taxonInfo|Aves/skip|same_as}}
:{{mlx|Autotaxobox|taxonInfo|Aves/skip|parent}} → {{#invoke:Autotaxobox|taxonInfo|Aves/skip|parent}}

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

===getMaxSearchLevels===
Returns the maximum number of levels of a taxonomic hierarchy encoded in taxonomy templates that the system will search.

Usage:
:{{mlx|Autotaxobox|getMaxSearchLevels}} → {{#invoke:Autotaxobox|getMaxSearchLevels}}

===find===
Given a taxon name and a rank, this function returns the taxon's ancestor of the given rank.

Usage:
:{{mlx|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:
:{{mlx|Autotaxobox|find|Felis|ordo}} → {{#invoke:Autotaxobox|find|Felis|ordo}}
:{{mlx|Autotaxobox|find|Felis|classis}} → {{#invoke:Autotaxobox|find|Felis|classis}}
:{{mlx|Autotaxobox|find|Pteranodon|phylum}} → {{#invoke:Autotaxobox|find|Pteranodon|phylum}}
:{{mlx|Autotaxobox|find|Pteranodon|classis}} → {{#invoke:Autotaxobox|find|Pteranodon|classis}}

===nth===
Given a taxon name, this function returns the ''n''th taxon above it in the taxonomic hierarchy.

Usage:

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

:{{mlx|Autotaxobox|nth|Felis|n=1}} → {{#invoke:Autotaxobox|nth|Felis|n=1}}
:{{mlx|Autotaxobox|nth|Felis|n=15}} → {{#invoke:Autotaxobox|nth|Felis|n=15}}

===nLevels===
Given a taxon name, this function returns the number of levels at and above it in the taxonomic hierarchy.

Usage:

:{{mlx|Autotaxobox|nLevels|''taxon_name''}}

Parameters:

:The unnamed parameter should be the name of a taxon for which "Template:Taxonomy/''taxon_name''" exists.

Examples:

:{{mlx|Autotaxobox|nLevels|Felis}} → {{#invoke:Autotaxobox|nLevels|Felis}}
:{{mlx|Autotaxobox|nLevels|Pteranodon}} → {{#invoke:Autotaxobox|nLevels|Pteranodon}}

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

:{{mlx|Autotaxobox|listAll|''taxon_name''}}

Parameters:

:The unnamed parameter should be the name of a taxon for which "Template:Taxonomy/''taxon_name''" exists.

Examples:

:{{mlx|Autotaxobox|listAll|Plantae}} → {{#invoke:Autotaxobox|listAll|Plantae}}
:{{mlx|Autotaxobox|listAll|Felis}} → {{#invoke:Autotaxobox|listAll|Felis}}

===removeQualifier===
Given a taxon name, this function returns the name with any qualifier (i.e. any part after a "/") removed.

Usage:

:{{mlx|Autotaxobox|removeQualifier|''taxon_name''}}

Examples:

:{{mlx|Autotaxobox|removeQualifier|Eukaryota/display}} → {{#invoke:Autotaxobox|removeQualifier|Eukaryota/display}}
:{{mlx|Autotaxobox|removeQualifier|Felis}} → {{#invoke:Autotaxobox|removeQualifier|Felis}}

<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox | |

[[Category:Taxobox templates]]

}}</includeonly>
<noinclude>
[[Category:Module documentation pages]]
</noinclude>

Module:Autotaxobox/doc - Revision history

Rox: 1 revision imported

Wikipedia>Cedar101: /* taxonomyList */ {{markupv}}