Module:Lang/doc: Difference between revisions

Revision as of 06:11, 20 November 2017

Latest revision as of 05:22, 30 March 2025

(61 intermediate revisions by 17 users not shown)

Line 1:

{{High-use|no-percent=yes}}

This module exists primarily to provide correct html markup for non-English language text where that text is used in the English Wikipedia. It has a secondary purpose of providing correct visual rendering for this non-English text. The module consolidates processing for {{tlx|lang}} and the many {{tld|lang-??}} templates into a single source and uses a clearly defined data set extracted from international standards.

{{Language templates}}

{{Lua|Module:Arguments|Module:Lang/configuration|Module:Lang/data|Module:Lang/ISO 639 synonyms|Module:Lang/tag from name|Module:Unicode data|Module:Yesno}}

This module exists primarily to provide correct htmlHTML markup for non-Englishnon–English language text where that text is used in the English Wikipedia. It has a secondary purpose of providing correct visual rendering for this non-English text. The module consolidateswas developed to consolidate processing for {{tlx|lang}}, {{tlx|langx}}, and the many {{tldtlx|lang-??transliteration}} templates into a single source and usesto use a clearly defined data set extracted from international standards. It provides error checking and reporting to ensure that the HTML rendered is correct for browsers and screen readers.

The data set is specified in [[Module:Language/name/data]] and its included data modules:

:;language code-and-name data

:*[[Module:Language/data/iana languages]] – from IANA [https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry language-subtag-registry file]

:*[[Module:Language/data/ISO 639-3]] – from [http://www-01.sil.org/iso639-3/download.asp sil.org UTF-8 Complete Code Tables Set]

:*[[Module:Language/data/wp languages]] – sourcing for the data in this module is unknown

:;language script data

:*[[Module:Language/data/iana scripts]] – from IANA language-subtag-registry file

:;language region data

:*[[Module:Language/data/iana regions]] – from IANA language-subtag-registry file

:;language variant data

:*[[Module:Language/data/iana variants]] – from IANA language-subtag-registry file

Other templates that get language name support from this module are:

The data set includes a supplementary data module, [[Module:Lang/data]], specifically intended to hold override data and other non-standard data. For example, when IANA disagrees with ISO 639-3 or when the standard language name is cumbersome or contains information not suitable for use in article space, the <code>override</code> table can hold that language information.

* {{tlx|native name}}

==Data set==

The module does not require the myriad {{tld|ISO 639 name ??}} templates, {{tlx|Language with name}}, {{tlx|Language with name and transliteration}}, and {{tlx|transl}}. It provides error checking and reporting to ensure that the html rendered is correct for browsers and screen readers.

The data set is specified in [[Module:Language/nameLang/data]] and its included data modules:

:;* language codetag-and-name data

:** [[Module:LanguageLang/data/iana languages]] – from IANA [https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry language-subtag-registry file]

:;* language script data

:** [[Module:LanguageLang/data/iana scripts]] – from IANA language-subtag-registry file

:;* language region data

:** [[Module:LanguageLang/data/iana regions]] – from IANA language-subtag-registry file

:;* language variant data

:** [[Module:LanguageLang/data/iana variants]] – from IANA language-subtag-registry file

* suppressed-script data

** [[Module:Lang/data/iana suppressed scripts]] – from IANA language-subtag-registry file

The data set also includes supplementary data modules:

Articles that have errors are placed in:

* override and other non-standard data

:{{cl|lang and lang-xx template errors}} (mainspace only)

** [[Module:Lang/ISO 639 synonyms]] – maps three character ISO 639-2, -2T, -3 codes to two character ISO 639-1 codes – from [https://www.loc.gov/standards/iso639-2/php/English_list.php Codes for the Representation of Names of Languages]

** [[Module:Lang/tag from name]] – reversed language tag-and-name data so that the language name is the key and the language tag is the value

== Testcases ==

* [[Module:Lang/testcases]] ([[Module talk:Lang/testcases|run]])

* category_from_tag()

** [[Module:Lang/testcases/ISO 639-1 category from tag]] ([[Module talk:Lang/testcases/ISO 639-1 category from tag|run]])

** [[Module:Lang/testcases/ISO 639-3-1 category from tag]] (A–H) ([[Module talk:Lang/testcases/ISO 639-3-1 category from tag|run]])

** [[Module:Lang/testcases/ISO 639-3-2 category from tag]] (I–N) ([[Module talk:Lang/testcases/ISO 639-3-2 category from tag|run]])

** [[Module:Lang/testcases/ISO 639-3-3 category from tag]] (O–Z) ([[Module talk:Lang/testcases/ISO 639-3-3 category from tag|run]])

** [[Module:Lang/testcases/ISO 639 deprecated and override category from tag]] ([[Module talk:Lang/testcases/ISO 639 deprecated and override category from tag|run]])

* name_from_tag()

** [[Module:Lang/testcases/ISO 639-1 name from tag]] ([[Module talk:Lang/testcases/ISO 639-1 name from tag|run]])

** [[Module:Lang/testcases/ISO 639-3-1 name from tag]] (A–H) ([[Module talk:Lang/testcases/ISO 639-3-1 name from tag|run]])

** [[Module:Lang/testcases/ISO 639-3-2 name from tag]] (I–N) ([[Module talk:Lang/testcases/ISO 639-3-2 name from tag|run]])

** [[Module:Lang/testcases/ISO 639-3-3 name from tag]] (O–Z) ([[Module talk:Lang/testcases/ISO 639-3-3 name from tag|run]])

** [[Module:Lang/testcases/ISO 639 deprecated and override name from tag]] ([[Module talk:Lang/testcases/ISO 639 deprecated and override name from tag|run]])

* tag_from_name()

** [[Module:Lang/testcases/ISO 639-1 tag from name]] ([[Module talk:Lang/testcases/ISO 639-1 tag from name|run]])

** [[Module:Lang/testcases/ISO 639-3-1 tag from name]] (A–H) ([[Module talk:Lang/testcases/ISO 639-3-1 tag from name|run]])

** [[Module:Lang/testcases/ISO 639-3-2 tag from name]] (I–N) ([[Module talk:Lang/testcases/ISO 639-3-2 tag from name|run]])

** [[Module:Lang/testcases/ISO 639-3-3 tag from name]] (O–Z) ([[Module talk:Lang/testcases/ISO 639-3-3 tag from name|run]])

** [[Module:Lang/testcases/ISO 639 deprecated and override tag from name]] ([[Module talk:Lang/testcases/ISO 639 deprecated and override tag from name|run]])

==Tracking categories==

:* {{clCategory link with count|langLang and lang-xx template errors}} (mainspace only)

* {{Category link with count|Transliteration template errors}}

* {{Category link with count|Lang and lang-xx code promoted to ISO 639-1}}

* {{Category link with count|Lang and lang-xx using deprecated ISO 639 codes}}

==See also==

MOSMoS on foreign words:

:[[* {{Section link|Wikipedia:Manual of Style/Text formatting#Foreign terms]]}}

MOS on foreign words:

:[[Wikipedia:Manual of Style/Text formatting#Foreign terms]]

<includeonly>{{#ifeq:{{SUBPAGENAME}}|sandbox | |

<!-- Categories below this line, please; interwikis at Wikidata -->

[[Category:Language-related modules]]

[[Category:Modules that check for strip markers]]

}}</includeonly>

}}</includeonly><noinclude>

[[Category:Module documentation pages]]

</noinclude>