Skip to content

Commit

Permalink
New page: locale naming.
Browse files Browse the repository at this point in the history
  • Loading branch information
Javier committed May 21, 2022
1 parent 1ffcb31 commit 50a1332
Show file tree
Hide file tree
Showing 3 changed files with 32 additions and 2 deletions.
5 changes: 3 additions & 2 deletions docs/_includes/menu.html
Expand Up @@ -28,10 +28,11 @@
<li><a href="#">Guides</a>
<ul>
<li><a href="https://latex3.github.io/babel/guides/which-method-for-which-language.html">Which method for which language</a></li>
<li><a href="https://latex3.github.io/babel/guides/non-standard-hyphenation-with-luatex.html">Non-standard hyphenation with luatex</a></li>
<li><a href="https://latex3.github.io/babel/guides/non-standard-hyphenation-with-luatex.html">Non-standard hyphenation with luatex</a></li>
<li><a href="https://latex3.github.io/babel/guides/using-babelprovide-to-modify-or-extend-locales.html">Using \babelprovide to modify or extend locales</a></li>
<li><a href="https://latex3.github.io/babel/guides/useful-links-to-tex.stackexchange.html">Useful links to tex.strackexchange</a></li>
<li><a href="https://latex3.github.io/babel/guides/useful-links-to-tex.stackexchange.html">Useful links to tex.strackexchange</a></li>
<li><a href="https://latex3.github.io/babel/guides/keys-in-ini-files.html">Keys in ini files</a></li>
<li><a href="https://latex3.github.io/babel/guides/locale-naming.html">Locale naming</a></li>
<li><a href="https://latex3.github.io/babel/guides/old-and-deprecated-functions.html">Old and deprecated functions</a></li>
<li><a href="https://latex3.github.io/babel/guides/list-of-locale-templates.html">List of locale templates</a></li>
<li><a href="https://latex3.github.io/babel/guides/using-babel-with-plain.html">Using babel with plain</a></li>
Expand Down
25 changes: 25 additions & 0 deletions docs/guides/locale-naming.md
@@ -0,0 +1,25 @@
# Locale naming

*Draft*

For the naming of the locales at the user level, the following
conventions will be used.

Languages, and therefore the corresponding files, are named with the
English name, lowercased and without spaces: `northernkurdish`. Hyphens
separate other fields, like script and region: `serbian-latin`,
`spanish-mexico`. They are taken from the CLDR.

Wherever the CLDR doesn’t provide a name (eg, “Medieval Latin”), the
pattern followed in practice for other names is applied, namely, use
the ‘natural’ form in English: `medievallatin`. They should be
preferably based on the description field in the
[IANA](https://www.iana.org/assignments/language-subtag-registry/language-subtag-registry)
registry (eg, `polytonicgreek`), although some simplifications can be
necessary, because some names are “too” descriptive.

A few locales with a region or a script have in the CLDR a more precise
name. For example, `ro-MD` is “Moldavian”. They will be normalized in
`babel` in the next few releases.


4 changes: 4 additions & 0 deletions docs/news/whats-new-in-babel-3.75.md
Expand Up @@ -12,6 +12,10 @@ files, which were load loaded only in some cases, except with
minimal overhead. This should work for most languages, but see the
following section.

Because of the way this feature works, problems are very unlikely, but
there is switch as a package option to turn the new behavior off
(`ensureinfo=off`).

## Language naming with `babel` and the Unicode CLDR

In the coming few weeks (or months), `babel` will attempt to align the
Expand Down

0 comments on commit 50a1332

Please sign in to comment.