Created page with "This module contains definitions and metadata for {{#switch:{{#titleparts:{{PAGENAME}}|1|2}}|data2='''two-letter language codes'''|data3='''three-letter language codes''' star..."
New page
This module contains definitions and metadata for {{#switch:{{#titleparts:{{PAGENAME}}|1|2}}|data2='''two-letter language codes'''|data3='''three-letter language codes''' starting with "<code>{{#titleparts:{{PAGENAME}}|1|3}}</code>"|datax='''exceptional''' language codes|stable=language codes whose information is '''stable and unlikely to be modified'''|#default=language codes}}. See [[Wiktionary:Languages]] for more information.
This module '''must not''' be used directly in other modules or templates. The data should be accessed through [[Module:languages]].
==Required values==
Every entry in the table must contain the following properties:
; <code>names</code>
: A list of all the names that this language is known by. The first name listed is always the "canonical" name, which is used in Wiktionary entries and category names. The list should include not only synonyms for the language, but also names that refer to language varieties that are subsumed under the same grouping. For example, while "Flemish" is not synonymous with "Dutch", Flemish is considered a part of Dutch, so the name is listed there.
; <code>type</code>
: The type of language (which affects how it is handled on Wiktionary). Possible values are:
:* <code>regular</code> - This language is attested according to [[WT:CFI]] and therefore permitted in the main namespace. There may also be reconstructed terms for the language, which are placed in the Appendix namespace and must be prefixed with * to indicate a reconstruction. Most languages should use this.
:* <code>reconstructed</code> - This language is not attested according to CFI, and therefore is allowed only in the Appendix namespace. All terms in this language are reconstructed, and must be prefixed with *.
:* <code>appendix-constructed</code> - This language is attested but does not meet the additional requirements set out for constructed languages ([[WT:CFI#Constructed languages]]). Its entries must therefore be in the Appendix namespace, but they are not reconstructed and therefore should not have * prefixed in links.
; <code>scripts</code>
: A list of script codes, see [[Wiktionary:Scripts]]. These represent all the scripts (writing systems) that this language employs, which are used on the main category of the language. If you do not know the script, use "None".
: Most templates and modules will use a default script when no script is specified for them, but the script codes are interpreted in two different ways:
:* Templates and modules that use <code>detect_script</code> in [[Module:utilities]] will try to detect the script (based on the characters in the text), using the list of scripts as a list of possible scripts to try to detect. If the script cannot be detected, the first listed script is used by default.
:* All other templates and modules will generally use the first script listed as the default script.
; <code>family</code>
: The code for the family that the language belongs to. See [[Wiktionary:Families]]. If you do not know the family, use "qfa-und".
==Optional values==
The following properties are used for text substitution; they replace or remove certain (sets of) characters or sets of characters. They all work similar, and are all optional. The search and replacement patterns are those used by the standard <code>[[mw:Extension:Scribunto/Lua reference manual#mw.ustring.gsub|mw.ustring.gsub]]</code> function. They resemble [[regular expression]]s; see [[mw:Extension:Scribunto/Lua reference manual#Patterns|search/replace patterns]] for more information.
If present, each of these properties must be a table that contains two tables, one named <code>from</code> and one named <code>to</code>. These two tables are organised pairwise: each element in <code>from</code> is a pattern to identify which characters in the term to replace, while the corresponding element in <code>to</code> defines what to replace them with. If the replacement is not present or if it is <code>false</code> or <code>nil</code>, it defaults to an empty replacement, meaning that the matching characters are removed altogether. This means that the <code>from</code> list can be longer than the <code>to</code> list, and an empty replacement will be assumed for any elements in <code>from</code> that have no counterpart in <code>to</code>.
At the top of the module, there is a list of combining characters with names. These are provided for convenience and readability, as combining characters generally do not display property inside the module code (although they do not affect the actual operation of the module).
; <code>entry_name</code>
: Defines replacements to create the entry name from the displayed form of a term. This can be used to remove certain diacritical marks according to the customs or standard practice of the language. For example, it is used to remove accent marks from Russian words, or macrons from Latin or Old English words, as these are not used in the normal written form of these languages. This is used by <code>remove_diacritics</code> in [[Module:links]].
; <code>sort_key</code>
: Defines replacements to create a category sort key from the page name. The purpose is to remove any characters that are ignored in sorting, and to replace similar characters with identical ones if the sorting rules for that language do not distinguish them. For example, in German, the characters "รค" and "a" are considered equivalent for sorting, and are both treated as "a". The page name is converted to lowercase before applying the replacements, so you should not add uppercase letters to the "from" lists. This is used by <code>format_categories</code> in [[Module:utilities]].
These are other optional values:
; <code>translit_module</code>
: The name of a module that is used to generate transliterations of terms, without the Module: prefix. This module must export a function named <code>tr</code> that is defined as follows:
:: <code>tr(text, lang, sc)</code>
: The three parameters are the text to be transliterated, the language code, and the script code. The function can ignore the language and script codes, but they are provided for cases when a language has more than one script, or when a single function is used to transliterate multiple languages sharing the same script.
; <code>ancestors</code>
: A table listing the language codes of the direct ancestors of this language. For example, for English one would list <code>enm</code> (Middle English) but not <code>ang</code> (Old English). For most languages, only one value should be specified in the list, but multiple ancestors can be listed for pidgins, creoles and mixed languages.
; <code>wikimedia_codes</code>
: A table listing the [[Wiktionary:Wikimedia language codes|Wikimedia language codes]] that this language maps to. This is used to translate Wiktionary codes to Wikimedia codes, which are usually the same but there are a few languages where it is different. The language codes must be valid Wikimedia codes (as determined by the wiki software), and if they are not defined in one of the language data modules, they must be defined in [[Module:wikimedia languages/data]].<!--
--><noinclude>{{documentation}}