Module:Taxobox/doc

கட்டற்ற கலைக்களஞ்சியமான விக்கிப்பீடியாவில் இருந்து.
Jump to navigation Jump to search

Lua error in Module:Taxobox at line 193: Tried to write global getItemLabel. Lua error in Module:Taxobox at line 193: Tried to write global getItemLabel.

This module is still unstable. Use with your own caution and report bugs and feature requests at Module talk:Taxobox or Wikidata talk:WikiProject_Taxonomy.

Taxobox.lua is a lua module which can automatically generate taxonomy infobox and is overwritable by classic taxobox parameters like species, unranked_ordo etc.

This module infobox is designed to be a replacement of Wikipedia's Taxobox. It provides configuration options which can control hypernym paths, show or hide certain ranks, specify content language and its configs, and make a callback and pass parameters to "classic" taxobox.

The following code

{{Taxobox
  | qid=Q464424
}}

creates the taxobox on the right hand side. The item to show is given with qid.

If you want to have this taxobox show up on each Wikidata taxon item: [1]

Internal[தொகு]

Method taxobox[தொகு]

The taxobox method provides function runs the above example. The method itself can be invoked with

{{#invoke: Taxobox
| taxobox
| qid=Q464424
| config[count]=10
}}

The number of parent taxons to show is given by config[count].

Method callback[தொகு]

The callback method provides function to retrieve all internal parameters and pass them to an external template. The method can be invoked with like this

{{#invoke: Taxobox
| callback
| qid=Q464424
| template=OtherTaxobox
| config[count]=10
}}

callback accepts all arguments that taxobox accepted. It also accepts an extra argument template to specify name of the template to be expanded.

I18n[தொகு]

Change the i18n messages in Module:I18n/taxobox. I18n also specifys some format strings which can be use to customize the infobox output of certain language.

message description example(s)
rank-format Format of instances of பெயரீட்டுத் தரநிலை (Q427626), or கிளைப்பாட்டியல் (Q713623). Will be passed into 2 named arguments when rendering ranks:
{link}
Wiki link to the rank
{label}
Display title of the rank
  • "[[{link}|{label}]]": display name and give a hyperlink to the rank, or
  • "{label}" only display name of the rank
rank-format-<latinrank> This argument is similar to rank-format but can be use to specify the format of certain rank. The "<latinrank>" is a latin name, can be a instance of பெயரீட்டுத் தரநிலை (Q427626), or கிளைப்பாட்டியல் (Q713623). For example "rank-format-cladus" for கிளைப்பாட்டியல் (Q713623). It accepts same 2 named arguments like rank-format
  • "": don't display anything at this rank. Can be used to hide the rank name when the taxon is a clade
  • "<i>(clade)</i>": use italic style
  • "[[{link}|<span style=\"color:gray\">{label}</span>]]": use link and change color
item-format-current-with-vernacular-name Format of instances of உயிரலகு (Q16521) or monotypic taxon (Q310890). current means either the item is the main taxon (specified by module argument qid), or the item and all taxa between the item and main taxon (if any) are all monotypic taxon (Q310890). with-vernacular-name means the item's Face-tongue.svg or label exists and is different from Face-tongue.svg.

4 named arguments will be passed on redering:

{link}
Wiki link to the taxon item
{vernacular}
The "common name" (the value of Face-tongue.svg or item label) of taxon item in current language
{scientific}
Full scientific name
{scientificshort}
Short scientific name, for example "P. leo" of சிங்கம் (Q140)

Note: Don't use italic style here on scientific names. This style can be set by scientific-name-pattern, scientific-name-repl and other related messages.

  • "<b>{scientificshort}</b>": only display the short scientific name in bold weight
  • "<b>{vernacular} {scientificshort}</b>": display both vernacular and short scientific name in bold weight
  • "[[{link}|{vernacular}]]": display a hyperlink to target taxon with its vernacular name as label
item-format-current-with-vernacular-name Format of instances of உயிரலகு (Q16521) or monotypic taxon (Q310890). without-vernacular-name means either both Face-tongue.svg and label (in specified language) are empty, or the vernacular name is the same as Face-tongue.svg.

4 named arguments will be passed on rendering, and they are same to item-format-current-with-vernacular-name.

  • "[[{link}|{scientificshort}]]": display a hyperlink to target taxon with its short scientific name as label
  • "[[{link}|{vernacular}]] ({scientficshort})": display both vernacular and short scientific name, also link to target taxon on from vernacular name
scientific-name-pattern, scientific-name-repl Pattern replacement to generate full scientific name. Can be override per rank by scientific-name-pattern-<latinrank> and scientific-name-repl-<latinrank>.

Not the format of scientific-name-pattern and other *pattern* messages are Lua's patterns, which are similar to Perl Compatible Regular Expressions (Q125267) but not identical. Read the manual to know how to write ones.

  • (pattern) "^.+$": match all non-empty strings
    • (repl) "%0": do nothing for replacement, or
    • (repl) "<i>%0</i>": put the scientific name in <i> tag so it can be rendered as italic
short-scientific-name-pattern, short-scientific-name-repl Pattern replacement to generate short scientific name. Can be override per rank by short-scientific-name-pattern-<latinrank> and short-scientific-name-repl-<latinrank>.
scientific-name-pattern-<latinrank>, scientific-name-repl-<latinrank> Pattern replcacement to generate full scientific name per rank. The "<latinrank>" is a latin name, can be a instance of பெயரீட்டுத் தரநிலை (Q427626), or கிளைப்பாட்டியல் (Q713623). For example "scientific-name-pattern-species" for இனம் (Q7432).
  • (scientific-name-pattern-genus) nil: fallback to scientific-name-pattern's "^.+$"
short-scientific-name-pattern-<latinrank>, short-scientific-name-repl-<latinrank> Pattern replcacement to generate short scientific name per rank. The "<latinrank>" is a latin name, can be a instance of பெயரீட்டுத் தரநிலை (Q427626), or கிளைப்பாட்டியல் (Q713623). For example "short-scientific-name-pattern-species" for இனம் (Q7432).
  • (short-scientific-name-pattern-species) "^(%w)%w+ (%w+)$": pattern to fetch the first letter of genus name (as %1) and the whole epithet (as %2) from the binomial of a species.
scientific-name-replaces or short-scientific-name-replaces Pattern replacements to apply for all full (or short) scientific names, after the name has been processed by pattern-repl pair described above.

The value for each of two messages is not a string but a table. The table contains multiple pattern-repl pairs which will be applied to scientific names.

Note: Lua's table object doesn't sort, so the replacement sequence CAN NOT be guaranteed. DON'T DEPEND ON THE SEQUENCE YOU SAW!

Input Parameters[தொகு]

The "<latinrank>" below is a latin name, can be an instance of பெயரீட்டுத் தரநிலை (Q427626), or கிளைப்பாட்டியல் (Q713623). For example "display[cladus]".

Config Options[தொகு]

  • config[lang]: content language (default: en).
  • config[count]: maximum count of taxon to be recursively iterated (default: 10).
  • config[references]: a space-separated list of item ids. The references to favor in case of alternative claims. Optional.
  • config[usetaxa]: a space-separated list of item ids. The taxa to favor in case of alternative claims. Optional.
  • config[link]: if the value is "sitelink" it will use local wiki site links instead of wikidata item links.
  • config[dryun]: used for callback method. Displaying a <pre> block contains wikitext instead of expanding and rendering the template. Dryrun can be used to find parameters to be overrided.
Examples[தொகு]

Lua error in Module:Taxobox at line 193: Tried to write global getItemLabel.

{{#invoke: taxobox
| taxobox
| qid = Q140
| config[usetaxa] = Q27379
|config[count] = 7
}}

Display Options[தொகு]

display[<latinrank>]: if the value is "n", "no", "false" or "hide", the specified rank (in latin name or QID) will be hide. Otherwise the rank will display.

For example, to hide all clades: Lua error in Module:Taxobox at line 193: Tried to write global getItemLabel.

{{#invoke:taxobox
|taxobox
|qid=Q140
|display[cladus]=hide
}}


Classic Parameters[தொகு]

If there are more than one clades between two taxon ranks, you can override them by appending [<number>] index to the unranked_<latinrank> parameter.

For example, there are 3 clades between rank genus and rank species. You can override them like this:

{{#invoke:taxobox
|taxobox
|...
|unranked_species[3] = Cladus closest to genus rank
|unranked_species[2] = The middle clade
|unranked_species[1] = Cladus closest to species rank
|...
}}

Output Parameters[தொகு]

The best way to see all output parameters is to use the config[dryrun] parameter:

{{#invoke:taxobox
|callback
|qid=Q140
|config[dryrun]=yes
}}

The result:

Lua error in Module:Taxobox at line 193: Tried to write global getItemLabel.

All output parameters can be overrided by specifying same name input parameters. For example this will replace பேரினம் (Q34740) to "Foo" and subfamily (Q2455704) "Bar":

Lua error in Module:Taxobox at line 193: Tried to write global getItemLabel.


{{#invoke:taxobox
|taxobox
|qid=Q140
|subfamilia=<strong style="color: green">Bar</strong>
|rank[9][taxon]=<strong style="color: red">Foo</strong>
}}

Supported properties[தொகு]

The taxobox currently supports:

  • Face-tongue.svg for taxon images and red list status
  • Face-tongue.svg: for monotypic taxon (Q310890) and recombination (Q14594740)
  • Face-tongue.svg
  • Face-tongue.svg also mark the taxon extinct if the value is extinct species (Q237350)
  • Face-tongue.svg
  • Face-tongue.svg
  • Face-tongue.svg
  • Face-tongue.svg for references
  • Face-tongue.svg
  • Face-tongue.svg
  • Face-tongue.svg
  • Face-tongue.svg also mark the taxon extinct if present
  • Face-tongue.svg
  • Face-tongue.svg
  • Face-tongue.svg mark the taxon extinct if present
  • Face-tongue.svg
  • Face-tongue.svg if ICNafp applies, otherwise:
  • Face-tongue.svg, otherwise the last name of English language (en) is shown.
  • Face-tongue.svg for authority string format and color.
  • Face-tongue.svg, common name of a language to override the item label of the language

Wikipedia use[தொகு]

This module is designed to be a replacement for Wikipedia taxoboxes. However, it is still unstable and need plenty extra template works to allow a classic வார்ப்புரு:Taxobox (Q52496) to accept the new callback parameters. Suggestion and bug reports are welcome at Module talk:Taxobox or Wikidata talk:WikiProject_Taxonomy.

References[தொகு]

"https://ta.wikipedia.org/w/index.php?title=Module:Taxobox/doc&oldid=2199917" இருந்து மீள்விக்கப்பட்டது