Module:TaxonItalics/doc

This is the documentation page for Module:TaxonItalics

Module:TaxonItalics (talk⧼dot-separator⧽edit⧼dot-separator⧽Tɛmplet:History⧼dot-separator⧽links⧼dot-separator⧽doc⧼dot-separator⧽subpages⧼dot-separator⧽sandbox⧼dot-separator⧽testcases)

This Lua module is used on approximately 439,000 pages, or roughly 1991% of all pages.
To avoid major disruption and server load, any changes should be tested in the module's /sandbox or /testcases subpages, or in your own module sandbox. The tested changes can be added to this page in a single edit. Consider discussing changes on the talk page before implementing them.

Purpose

The module is primarily intended for use by the automated taxobox system. It supports the correct italicization of scientific names. Botanical (ICNafp) names may contain "connecting terms"; these must not be italicized. The hybrid symbol, ×, should also not be italicized. The module optionally wikilinks and abbreviates italicized names.

For non-virus taxa, italics are used at the rank of genus or below. The module does not decide whether a scientific name should be italicized. Use {{Is italic taxon}} for this purpose.

Usage

{{#invoke:TaxonItalics|main|TAXON_NAME}} – italicizes a taxon name
{{#invoke:TaxonItalics|main|TAXON_NAME|linked=yes}} – italicizes a taxon name, wikilinking the italicized output to the unchanged input
{{#invoke:TaxonItalics|main|TAXON_NAME|abbreviated=yes}} – italicizes a taxon name, abbreviating all but the last part to the first letter
{{#invoke:TaxonItalics|main|TAXON_NAME|dab=yes}} – italicizes a taxon name, treating any parenthesized part as a disambiguation term, and not italicizing it

The parameters can be combined. It can also be used via {{Taxon italics}}.

Examples

Just italicized

Connecting terms

Pinus subg. Pinus → Pinus subg. Pinus
P. subgenus Pinus → P. subg. Pinus
P. subsect. Pinaster → P. subsect. Pinaster
Acer tataricum subsp. ginnala → Acer tataricum subsp. ginnala
Aster ericoides var. ericoides → Aster ericoides var. ericoides
A. ericoides varietas ericoides → A. ericoides var. ericoides
A. e. subvar. ericoides → A. e. subvar. ericoides

Botanical names may contain only one infraspecific epithet; a string like "Fragaria vesca subsp. vesca f. semperflorens" is a classification, not a name, and is not handled by the module.

Hybrid symbols

Elaeagnus × submacrophylla → Elaeagnus × submacrophylla
×Beallara → ×Beallara
× Beallara → × Beallara
{{hybrid}}Beallara → Tɛmplet:HybridBeallara

Linked

Using |linked=yes

Populus sect. Aigeiros → Populus sect. Aigeiros
Elaeagnus × submacrophylla → Elaeagnus × submacrophylla

Abbreviated

Using |abbreviated=yes

Populus sect. Aigeiros → P. sect. Aigeiros
Acer tataricum subsp. ginnala → A. t. subsp. ginnala
[also linked] × Sorbaronia mitschurinii → × S. mitschurinii
[also linked] Elaeagnus × submacrophylla → E. × submacrophylla
Elaeagnus ×submacrophylla → E. ×submacrophylla
Elaeagnus {{hybrid}} submacrophylla → E. [. submacrophylla

Disambiguation terms

By default, a parenthesized part of a taxon name is assumed to be a subgenus name, and is italicized:

Varanus (Hapturosaurus) → Varanus (Hapturosaurus)
Caia (plant) → Caia (plant) – Tɛmplet:Red

To treat a parenthesized part as a disambiguation term, use |dab=yes

Caia (plant) → Caia (plant)
(also linked) Caia (plant) → Caia (plant)

For even more examples, see the testcases.