View source for Help:Monolingual text languages

<languages />
[[File:Language list for Wikidata.png|thumb|600px]]
<translate><!--T:1-->
The list of Wikimedia language codes available for [[Special:MyLanguage/Help:Data type#monolingualtext|monolingual text values]] is fixed. It can only be changed by the development team.

<!--T:43-->
A list of currently language codes available for monolingual text values is available [<tvar name="names">https://phabricator.wikimedia.org/diffusion/ECLD/browse/master/i18n/LanguageNames/en.json</tvar> here]. (Some of language codes listed are deprecated and explicitly disabled in Wikidata.)

== Special language codes == <!--T:2-->

<!--T:3-->
In addition to language codes describing actual languages, there are four special language codes available:</translate>

* <translate><!--T:4--> <tvar name="und"><code>und</code></tvar>: For content whose language is not yet determined (<code>undetermined</code>)</translate>
* <translate><!--T:5--> <tvar name="mis"><code>mis</code></tvar>: For content whose language is known, but has no language code (<code>uncoded languages</code>). We also use it for content whose language has a language code that is not yet available on Wikidata.org.</translate>
* <translate><!--T:6--> <tvar name="mul"><code>mul</code></tvar>: For content in multiple languages (<code>multiple languages</code>), meaning either content that is the same in more than one language, or content that contains more than one language, so a reader would need to know all of them to understand it.</translate>
* <translate><!--T:7--> <tvar name="zxx"><code>zxx</code></tvar>: For content that is not linguistic (<code>no linguistic content</code>, <code>not applicable</code>)</translate>

<translate><!--T:8-->
See the [[#Lists]] below for current uses.

== When a language code is missing == <!--T:9-->

<!--T:10-->
It might happen that you need a language code that is not yet supported. In that case, follow these steps:</translate>

* <translate><!--T:11--> Use <tvar name="mis"><code>mis</code></tvar> as language code in the statement, reference or qualifier where you need the unsupported language code</translate>
* <translate><!--T:12--> If possible, add a qualifier {{P|407}} with the item for the language; create an item for the language, if none already exists</translate>
* <translate><!--T:13--> If possible, add a reference for the correct language to the statement</translate>
* <translate><!--T:14--> Request the language code if it fulfills the requirements for a new language code (see below)</translate>

<translate>
== Getting a language code added == <!--T:15-->

<!--T:16-->
The preferred way to request a language code to be added for monolingual text values is by opening a new ticket in Phabricator. Add the following information:</translate>

* <translate><!--T:17--> The language code (examples: <tvar name="lkt"><code>lkt</code></tvar>, <tvar name="sr-cyrl"><code>sr-cyrl</code></tvar>)</translate>
* <translate><!--T:18--> Language name in the language itself or English (examples: <tvar name="Lakota"><code>Lakota</code></tvar>, <code>Serbian in Cyrillic</code>)</translate>
* <translate><!--T:19--> The used script, if not obvious (example: <code>Cyrillic</code>)</translate>
* <translate><!--T:20--> Where and when the language was or is used (example: <code>In use by the Lakota people in North America</code>)</translate>
* <translate><!--T:21--> The Wikidata item id (example: <code>[[Q33537]]</code>)</translate>
* <translate><!--T:22--> Make sure you link to the item where you want to use the language code (see previous section). If you didn't already add a reference to the statement, add it to the Phabricator ticket.</translate>

<translate><!--T:23-->
If you don't want to or can't use Phabricator, add your request to [[Wikidata:Report a technical problem]].</translate>

{{Clickable button|1=<translate><!--T:24--> Request language code on Phabricator</translate>|url=https://phabricator.wikimedia.org/maniphest/task/edit/form/1/?projects=Wikidata+Language_codes+MediaWiki-extensions-CLDR&title=Add%20monolingual%20language%20code%20INSERT_CODE_HERE&description=Please%20add%20the%20language%20code%20INSERT_CODE_HERE%20to%20the%20list%20of%20language%20codes%20supported%20for%20monolingual%20text%20values.%0A%0AUsage%20example:%20INSERT_USAGE_EXAMPLE_HERE|class=mw-ui-constructive}}

<translate>
== Requirements for a new language code == <!--T:27-->
</translate>
: <translate><!--T:28--> ''Note: This is work in progress and not finished policy''</translate>

<translate><!--T:29-->
A new language code probably has to fulfill the following requirements:</translate>

* <translate><!--T:30--> It has to be valid [[Q1059900|IETF language tag]]. If no tag is available, an attempt to [<tvar name="1">https://www.rfc-editor.org/rfc/rfc4646#section-3.5</tvar> register] the tag can be made.</translate>
* <translate><!--T:31--> It has to be required for an actual use-case on Wikidata (other than {{P|1705}} on item for the language itself)</translate>

<translate><!--T:32-->
A language code does not have to fulfill the requirements of the [[<tvar name="link">meta:Special:MyLanguage/Language proposal policy</tvar>|language proposal policy for new Wikis]]. Specifically:</translate>

* <translate><!--T:33--> The language doesn't need an active community or amount of usage</translate>
* <translate><!--T:34--> The language code doesn't need to denote a unique language (For example, we have <tvar name="nn"><code>nn</code></tvar> and <tvar name="nb"><code>nb</code></tvar>, but also <tvar name="no"><code>no</code></tvar>, which is a macrolanguage covering both)</translate>

<translate><!--T:35-->
In general, if you need a language code to correctly model real-world data, it should be accepted as long as it's a valid language code.</translate>

{{Anchor|Lists}}
<translate>
==Using inside SPARQL queries== <!--T:38-->
</translate>
<syntaxhighlight lang="sparql">BIND (LANG(?label) AS ?language)</syntaxhighlight>

{{sparql|query=SELECT * WHERE {
  ?s ?label "The Rolling Stones"@en .
  ?s ?p ?o
} }}

<syntaxhighlight lang="sparql">?spouse rdfs:label ?spouse_label .
FILTER (LANG(?spouse_label) = "en").</syntaxhighlight>

<translate>
== Adding with QuickStatements == <!--T:39-->
</translate>
* <translate><!--T:40--> {{Font & border color|black|#FFDBFB|#FE98F1|[[<tvar name="monolingualtext">Special:MyLanguage/Help:Data_type#monolingualtext</tvar>|Monolingual text]]}} prefix text in "double quotes" with the language and a colon, e.g. <tt>en:"Some text"</tt></translate>
*: <translate><!--T:41--> Example: <tvar name="Q1214098">{{Font & border color|black|#D6F8DE|#93EEAA|Q1214098}}</tvar> <tvar name="TAB">{{Font & border color|gray|#FFFFCC|#FFFF99|TAB}}</tvar> <tvar name="P1476">{{Font & border color|black|#DBEBFF|#99C7FF|P1476}}</tvar> <tvar name="TAB">{{Font & border color|gray|#FFFFCC|#FFFF99|TAB}}</tvar> <tvar name="sitelink">{{Font & border color|black|#FFDBFB|#FE98F1|pl:"Krzyżacy"}}</tvar></translate>
*: <translate><!--T:42--> Meaning: add to {{Statement|Q1214098|P1476|"Krzyżacy" (Polish)}}</translate>
<translate>

== Lists == <!--T:36-->

<!--T:44-->
Note: This is not the authoritative list for monolingual text languages! See the top of page for that.
</translate>
* [[Help:Wikimedia language codes/lists/all]]
* [[Wikidata:Database reports/monolingual text/undetermined language]] (und)
* [[Wikidata:Database reports/monolingual text/multiple languages]] (mul)
* [[Wikidata:Database reports/monolingual text/missing language codes]] (mis)
* [[Wikidata:Database reports/monolingual text/no linguistic content]] (zxx)

<translate>
== See also == <!--T:37-->
</translate>
*https://phabricator.wikimedia.org/tag/language_codes/
* [[mediawikiwiki:Manual:Language#Language code]]

{{Translation categories}}