Thiorosan: Create the documentation subpage

2026-08-27T12:19:51Z

Create the documentation subpage

New page

This is the documentation for [[Module:Languages]], the language-code registry for the Yezur wiki. It maps a registry code — the <code>code</code> field of [[Template:Infobox language]] — onto a language's display name, its Dictionary section, its family and whether it is reconstructed, and it is the single place those are recorded. Wikitext reaches it through <code><nowiki>{{#invoke:Languages|…}}</nowiki></code>, in [[Template:D]], [[Template:L]], [[Template:M]], [[Template:Desc]], [[Template:Head]] and [[Template:Etym-missing]]; [[Module:Head]], [[Module:Labels]] and [[Module:Translations]] <code>require</code> the module and reach entries through its exported <code>_get</code>, the registry table itself being local to the module.

Codes take the form <code>Y</code>, a family letter, an era letter, a hyphen and a two-letter tag for the language, as in <code>YAQ-HE</code> for Ancient Hertic. The second letter is the family — <code>A</code> [[Herta-Olaic]], <code>B</code> [[Njeshan]], <code>C</code> [[Andusian]], <code>D</code> [[Tacchoan]], <code>E</code> [[Shung-Worrehan]] (no code registered under it yet), <code>X</code> isolate — and the third the era, <code>P</code> proto, <code>Q</code> ancient, <code>R</code> medieval, <code>S</code> modern, so that alphabetical order of codes is chronological order of languages. [[Module:Translations]] reads those two letters off the code itself to order its rows: families fall in letter order, isolates last, and within a family the older stages first.

== Registry fields ==

Each entry in the table is keyed by its code and carries:

{| class="wikitable"
! Field !! Purpose
|-
| <code>name</code> || The display name. Shown by [[Template:Desc]] and as the row label of a translations box, stored in the <code>langname</code> field of the <code>Lexemes</code> row by [[Template:Head]], and used by [[Module:Head]], [[Module:Labels]] and [[Template:Etym-missing]] to build category names such as <code>Category:Pjany lemmas</code> and <code>Category:Gaillean entries needing etymology</code>.
|-
| <code>section</code> || The level-2 heading the language's entries file under in the Dictionary, and so the anchor every generated link points at. It differs from <code>name</code> where two forms of one language share a section: <code>YXS-NE</code> New English files under <code>English</code>.
|-
| <code>recon</code> || Set to <code>true</code> for a reconstructed language. Its forms are rendered with a leading <code>*</code> in headwords, links and mentions; the page title itself carries no asterisk.
|-
| <code>family</code> || The macro-family, used by [[Module:Translations]] to group a translations box. Isolates carry no <code>family</code> and are gathered under ''Isolates'' at the end of the box.
|}

== Entry points ==

{| class="wikitable"
! Call !! Backs !! Result
|-
| <code><nowiki>{{#invoke:Languages|name|CODE}}</nowiki></code> || [[Template:Head]], [[Template:Etym-missing]] || The display name.
|-
| <code><nowiki>{{#invoke:Languages|section|CODE}}</nowiki></code> || — || The Dictionary section heading.
|-
| <code><nowiki>{{#invoke:Languages|dlink|word|code|label}}</nowiki></code> || [[Template:D]] || A link to <code>Dictionary:''word''</code> anchored at the language's section. Word first.
|-
| <code><nowiki>{{#invoke:Languages|link|code|word|label}}</nowiki></code> || [[Template:L]] || The same link, code first, for lists of synonyms and derived terms.
|-
| <code><nowiki>{{#invoke:Languages|mention|code|word|label}}</nowiki></code> || [[Template:M]] || The same link italicised, for mentions in running prose.
|-
| <code><nowiki>{{#invoke:Languages|desc|code|word|label}}</nowiki></code> || [[Template:Desc]] || The display name, a colon, then the link — a Descendants-section line.
|}

The last parameter of the four link-building calls is optional display text, defaulting to the word; a parameter left blank counts as absent. Codes and words are trimmed, and codes are matched without regard to case. Given no word, <code>dlink</code>, <code>link</code> and <code>mention</code> return an empty string and <code>desc</code> returns the display name alone.

An unrecognised or omitted code is not an error. <code>name</code> and <code>section</code> return an empty string, <code>desc</code> falls back to printing the code itself as the name, and the link calls still emit a link — to the top of the Dictionary page, with no section anchor and no reconstruction asterisk. [[Template:Translations]] is the exception: it renders unknown codes visibly as errors rather than passing them through.

Two functions are exported for other modules rather than for wikitext. <code>_get(code)</code> returns the registry entry for a code, or <code>nil</code>; <code>_build_link(word, entry, display)</code> builds the anchored, starred Dictionary link from an entry.

Because the display names live here, renaming a language is a one-line edit to the registry rather than a sweep of every page that mentions it. The table has to be kept in step with the <code>code</code> fields of [[Template:Infobox language]] and with the tables at [[List of languages]], which catalogue the codes in use; a language absent from the registry is invisible to the dictionary templates, which fall back to unanchored links. See [[Yezur Wiki:Dictionary structure]].

Module:Languages/doc - Revision history

Thiorosan: Create the documentation subpage