View source for Testwiki:Automated taxobox system/technical

{{Autotaxobox system navbox}}

=== Technical details ===

An accompanying page for each taxon, at Template:Taxonomy/''taxon'', uses a template to list the parent of each taxon. Each of the automated taxobox templates ({{tl|Speciesbox}}, {{tl|Automatic taxobox}}, etc. ) then consults these templates to produce a full taxonomy.  By default it only displays "major" taxonomic ranks (i.e. not sub, super, nano etc), with the exception of the immediate parents to the taxon. Instructions for the manual creation of this page, if it does not yet exist, appear in the taxobox. Thus the hierarchy can be automatically generated, minimizing the work for editors of new pages whilst creating a consistent taxonomy, thus increasing the utility of Wikipedia (see {{Cite journal| last1 = Page | first1 = R. D. M.| title = Wikipedia as an encyclopaedia of life| journal = Organisms Diversity & Evolution| volume = 10| issue = 4| pages = 343–349| year = 2010| doi = 10.1007/s13127-010-0028-9}}).

A list of all templates involved in generating an automated taxobox, and their relationships, can be found at [[WP:Automated taxobox system/map]].

=== Maintenance ===
Sandboxing much of the automated taxobox system is difficult, since it relies on existing taxonomy templates. However, there are sandbox and testcase pages for some templates, e.g. [[Template:Automatic taxobox/sandbox]] and [[Template:Automatic taxobox/testcases]].

<!--=== Extracting taxonomy information via API ===
This system makes it straightforward to recover full taxonomic information for any taxon using an API.  The raw Wikitext of each Template:Taxonomy/''Taxon_name'' is in a consistent format with a line specifying {{para|rank|''taxonomic rank (latinized)}}, {{para|parent|''parent taxon''}}, and {{para|link|''wikilink''}}.

Each parent taxon can be successively queried until the desired taxonomic level is obtained.

An example of an application using the API to browse taxonomies is available at http://taxobrowser.erikhaugen.com.
-->
==Algorithm==
The automated taxobox is placed directly above the first paragraph. Since the user is not required to enter any information about the scientific classification within the article, the automated taxobox first looks for the taxonomy template that matches the supplied {{para|taxon}} parameter (or, if none is supplied, the article's title, ignoring any parenthetical expressions).

If the taxon cannot be found in the database of taxonomy templates, the editor is prompted to enter the taxon's data onto a specified page where that data will be accessed for that taxon's taxobox and for all descendant taxa's taxoboxes. Contained on this page are the taxonomic rank, a link to the article about that taxon, the format which should be used when displaying that taxon in a taxobox, the name of the parent taxon, an indicator of extinction, and a list of references for all of this information.

Once the taxon is identified in the database, the system pulls all the information except the reference parameter. The same is done for this taxon's parent, and the grandparent, great-grandparent, etc., until a top-level taxon is reached (e.g. [[Life]], [[Veterovata]], [[Ichnos]]).

The path from the target taxon to the top-level taxon is, {{as of|2017|January|lc=yes}}, traversed twice during the processing of the code – once to find the taxobox colour and once to display all the parent taxa. The traversals were converted to [[Lua (programming language)|Lua]] in December 2016, which removed previous problems with expansion depth errors, and reduced the [[Big O notation|time]] from <math>O(n^2)\,</math> – where <math>n</math> corresponds to the number of levels deep the taxon in question is (including the top-level taxon) – to <math>O(n)\,</math>.

Once traversals are complete, the information is sorted out for each taxon. Ranks are converted to English displayable words, links are formed to each taxon, extinction daggers are added, appropriate ranks are italicized, and taxa deemed unimportant to that taxonomy are discarded. The final result should look exactly like a manual taxobox, except for the edit link in the bar that says "Scientific classification".

[[Category:Wikipedia automated taxobox documentation]]