Template:BCP47/doc

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

---

Usage

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 HTML lang="" attributes, in XML xml:lang="" pseudo-attributes, or in CSS lang() selectors.

Examples

• Unaffected codes, for example:
  • "{{BCP47|en}}" returns: "en"
  • "{{BCP47|zh-hant}}" returns: "zh-hant"
  • "{{BCP47|zh-cn}}" returns: "zh-cn"
• The following codes are not recommended (they are unnecessary aliases) but they are still conforming to the standard and are not affected (this template still does not resolve them to their canonical codes):
  • "{{BCP47|zh-yue}}" returns: "yue" (alias of "yue")
  • "{{BCP47|zh-cmn}}" returns: "cmn" (alias of "zh")
  • "{{BCP47|zh-hans}}" returns: "zh-hans" (alias of "zh")
  • "{{BCP47|zh-cmn-hans-cn}}" returns: "zh-cmn-hans-cn" (alias of "zh-cn")
• Changes required by BCP47 (due to standard violation), using standard codes when they exist:
  • "{{BCP47|als}}" returns: "gsw"
  • "{{BCP47|fiu-vro}}" returns: "vro"
  • "{{BCP47|roa-rup}}" returns: "rup"
  • "{{BCP47|simple}}" returns: "en"
  • "{{BCP47|zh-classical}}" returns: "lzh"
• Changes required by BCP47 (due to standard violation), currently using private-use extensions:
  • "{{BCP47|nl-informal}}" returns: "nl"
  • "{{BCP47|nrm}}" returns: "nrf"
  • "{{BCP47|roa-tara}}" returns: "it-x-tara"
• Changes preferable with BCP47 for improved interoperability (not really violations):
  • "{{BCP47|be-x-old}}" returns: "be-tarask"