Template:BCP47/doc

From Wikimedia Commons, the free media repository
Jump to navigation Jump to search

This subpage contains documentation, categories, or other content that is not part of the template.
To view the template page itself, see Template:BCP47.

العربية ∙ asturianu ∙ Boarisch ∙ беларуская (тарашкевіца) ∙ български ∙ বাংলা ∙ català ∙ čeština ∙ dansk ∙ Deutsch ∙ Zazaki ∙ Ελληνικά ∙ English ∙ Esperanto ∙ español ∙ eesti ∙ euskara ∙ فارسی ∙ suomi ∙ français ∙ galego ∙ עברית ∙ हिन्दी ∙ hrvatski ∙ magyar ∙ Bahasa Indonesia ∙ italiano ∙ 日本語 ∙ ქართული ∙ 한국어 ∙ Lëtzebuergesch ∙ македонски ∙ മലയാളം ∙ ဘာသာ မန် ∙ Bahasa Melayu ∙ Mirandés ∙ မြန်မာဘာသာ ∙ norsk bokmål ∙ Plattdüütsch ∙ Nederlands ∙ norsk ∙ polski ∙ português ∙ português do Brasil ∙ русский ∙ sicilianu ∙ Scots ∙ slovenščina ∙ српски / srpski ∙ svenska ∙ ไทย ∙ Türkçe ∙ українська ∙ اردو ∙ oʻzbekcha ∙ Tiếng Việt ∙ 简体中文 ∙ 繁體中文 ∙ +/−

This template fixes the current violations of the BCP47 standard (for inclusion in the lang HTML attribute) by Wikimedia sites for their language codes.

It also normalizes these codes to lowercase only (though it is not mandatory).

Use this template in the HTML lang="" attribute , or CSS language selectors (where BCP47 conformance is mandatory per their relevant standards), or in Wikidata for identifying the language of translated item labels and aliases (with language codes that all should all conform to BCP47). Don't use it not for interwiki codes (that are not necessarily BCP47 language codes, but used as domain names labels (also in internal Wikimedia database names) for Wikimedia projects designed to group one or several languages or variants in the same edition of the project and that may locally violate BCP 47 rules for verious legacy codes (even if some of them have been deprecated). Various non-Wikimedia projects may use other codes for their projects, but they are not directly supported unless they conform to BCP 47 (you may need other template to map language codes for these external projects). Do not assume that any interwiki code which is valid inside Wikimedia for wikilinks inserted in wiki pages is a valid BCP47 code.

As of August 2024, a new #bcp47 parser function was added which fully replaces this template. Please use {{#bcp47:...}} instead of {{BCP47|...}} template.

Usage

{{BCP47 |1= }}

Template parameters

 Parameter text is empty
<templatedata>JSON</templatedata> ./. {{TemplateBox}}
TemplateData

TemplateData is a way to store information about template parameters (the description of those and of the whole template) for both humans and machines. It is used by VisualEditor and possibly other tools like Upload Wizard.

Existing template documentation
At Wikimedia Commons, it is recommended to use {{TemplateBox}} with either ‎useTemplateData=1 or ‎useTemplateData=only on the ‎/doc subpage and transcluding it with {{Documentation}} into the template. ‎<nowiki>-tags can be wrapped around the arguments, if required, to avoid templates being expanded.

Newly created template documentation and imports
Another option, especially for imported templates, or for users with JSON experience, is placing raw ‎<templatedata>-tags into the Wikitext of the template, as described in various Wikipediae.

Discussion
There is an ongoing discussion about that matter. Feel invited to comment if you are experienced in either way, your time permits and if you like to share your opinion or to make a suggestion.

Wikipedia's help about TemplateData • Commons-specific information

This template fixes the current violations of the BCP47 standard (for inclusion in the lang HTML attribute) by Wikimedia sites for their language codes. It also normalizes these codes to lowercase only (though it is not mandatory). Use this template only in the HTML lang="" attribute.

Template parameters

This template prefers inline formatting of parameters.

ParameterDescriptionTypeStatus
code1

The Wikimedia language code to convert to BCP47

Linerequired

Additional information

The template is intended to be used in the following namespaces: the Template namespace

The template is intended to be used by the following user groups: all users

Localization

This template is not intended to be localized.

Examples

  • Unaffected codes, for example:
    • "{{#bcp47:en}}" returns: "en"
  • Changes required by BCP47, using standard codes:
    • "{{#bcp47:als}}" returns: "gsw"
    • "{{#bcp47:fiu-vro}}" returns: "vro"
    • "{{#bcp47:simple}}" returns: "en-simple"
    • "{{#bcp47:zh-classical}}" returns: "lzh"
    • "{{#bcp47:roa-rup}}" returns: "rup"
  • Changes required by BCP47, currently using private-use extensions:
    • "{{#bcp47:nrm}}" returns: "nrf"
    • "{{#bcp47:roa-tara}}" returns: "nap-x-tara"
  • Changes preferable with BCP47 for improved interoperability (not really violations):
    • "{{#bcp47:be-x-old}}" returns: "be-tarask"
Retrieved from "https://commons.wikimedia.org/w/index.php?title=Template:BCP47/doc&oldid=921661432"