Guide to taxt tags
Last edited over 1 year ago — Added about 2 years ago"Taxts" and "taxt tags"
"Taxt" refers to any plaintext content that is mixed with database ID tags ("taxt tags"). While mainly used for history items, there are about ten different database columns that support "taxt" content.
Standard catalog tags
What | Code | Example | Usage |
---|---|---|---|
Taxon link | {tax 429349} |
Formica | For linking and referring to non-homonyms |
Taxon link (with author citation) | {taxac 429349} |
Formica | For linking and referring to homonyms; the author citation is included for disambiguation only; should not be followed by a colon/pages |
Protonym link | {pro 154891} |
Lasius | Not 100% decided, currently mainly for genus-group name protonyms |
Protonym link (with author citation) | {proac 154891} |
Lasius | As above, but with author citation |
Terminal taxon link of a protonym | {prott 154891} |
Lasius | Does not handle Protonyms with more than one terminal taxon protonyms |
Terminal taxon link of a protonym (with author citation) | {prottac 154891} |
Lasius | As above, but with author citation |
Reference link | {ref 126902} |
Linnaeus, 1758 | Used to backup scientific "claims", should be followed by a colon and page numbers |
Cleanup-related tags
What | Code | Example | Usage |
---|---|---|---|
"Missing taxon name" | {missing <i>string</i>} |
Dangerosa | For hardcoded taxon names that are missing from the catalog |
"Unmissing taxon name" | {unmissing <i>string</i>} |
Dangerosa | For hardcoded taxon names that are not missing from the catalog |
Misspelled name (taxa, protonyms, epithets) | {misspelling <i>string</i>} |
Dangerrrrosa | For hardcoded taxon names that are misspelled, exact usage is TBD |
Hidden editor notes | {hiddennote string} |
Hidden editor note: check reference | For (short-lived) notes, only visible to logged-in users; they make parsing more complicated, so we only want to use them to temporarily tag history items with issues so they can be found and fixed |
missing
andunmissing
tags were added to make taxts parsable by script, and to make it possible to find missing database entries.- Hardcoded names wrapped in "missing" and "unmissing" tags render for visitors just as if the name were hardcoded. For logged-in users, they appear in bold red/gray.
- Any time you see a hardcoded [
Taxon
] name in a history item, and we want to create aTaxon
record for that name, you can wrap it in amissing
tag like this{missing <i>Prionopelta nominata</i>}
. - Creating the missing
Taxon
record is of course even better, but if you don't have time to do that, just tagging the content is still an improvement. - Additional italics tags between words like
{missing <i>Prionopelta</i> <i>nominata</i>}
can be left as is if there are any. - History items with
missing
tags are collected in this script: History items withmissing
tags (queue 1) taxt-hist slow-render has-quick-fix -
unmissing
is used for hardcoded names that we don't want to createTaxon
records for - this was added mostly to make it easier to see which hardcoded names have already been processed.
"missing" vs. "unmissing"
A 100% complete ant catalog would not need a missing
tag type, while unmissing
would still be relevant for hardcoded names, since even a complete ant catalog would not necessarily keep Taxon
records for homonyms outside of Formicidae.
unmissing
can also be used for Formicidae-ish names that we do not currently have plans to create Taxon
records for. For example Dorylidae, which is now Dorylinae. Example:
{tax 469626} in {unmissing Dorylidae}, {tax 429481}
Which renders as:
"unmissing" and Bolton
Bolton indicates families of taxa outside of Formicidae using parenthesis at the end of items, like here:
- [Junior homonym of †Myrmicium Westwood, 1854: 396 (Pseudosiricidae).]
On AntCat, the same entry would be formatted like this:
- [Junior homonym of †Myrmicium (Pseudosiricidae) Westwood, 1854: 396.]
With the whole name wrapped in an unmissing
tag, to keep it in one place, and so that it can be parsed as a single name by scripts.
<-- see https://github.com/calacademy-research/antcat-issues/issues/11 -->
Tag conversions suffixes
tax
tags can be converted to protonym-based tags by suffixing the ID. Replacements can be previewed and are performed when items are saved.
Target protonym-tag | Original | Original with suffix | Output |
---|---|---|---|
pro |
{tax 510903} Acanthomyops niger |
{tax 510903pro} |
{pro 164565} Formica nigra |
proac |
{tax 510903} Acanthomyops niger |
{tax 510903proac} |
{proac 164565} Formica nigra |
prott |
{tax 510903} Acanthomyops niger |
{tax 510903prott} |
{prott 164565} Lasius niger |
See also
- History item search results for:
- Search history item content with regex
- Help page: Markdown formatting help page