You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
1. If it's a new language, add it to `config.toml`,
with a localized name and language code/optional region (e.g. `pt` or `pt-br`). See the [list of ISO 639-2 language codes here](https://www.loc.gov/standards/iso639-2/php/code_list.php)
However, I believe those are technically insufficient. Instead I recommend using a IETF BCP 47 language tag. Thankfully, it is based on ISO 629-2 (no changes necessary). It also provides additional information, when needed. For example, If there is translation into Serbian (ISO 629-2 language code sr, you need to specify whether the Latin or Cyrillic is used--sr-latn or sr-cyrl)
The configuration file (config.toml (permalink)) currently only contains lowercase language codes with the exception of: fa-IR فارسی (ایران) [Persian (Iran)]. To prevent confusion and unnecessary redirects, I recommend explicitly stating that lowercase language tags should be used.
3) Region vs Script
(I have the least confidence in this last recommendation.) It is my understanding that script codes better serve the global community than region codes (ex. zh-cn ➡️ zh-hans and zh-tw ➡️ zh-hant).
The text was updated successfully, but these errors were encountered:
1) Use IETF BCP 47 language tags instead of ISO 629-2 language codes
The documentation recommends ISO 629-2 language codes:
contributor_covenant/README.md
Lines 60 to 61 in b6b8445
However, I believe those are technically insufficient. Instead I recommend using a IETF BCP 47 language tag. Thankfully, it is based on ISO 629-2 (no changes necessary). It also provides additional information, when needed. For example, If there is translation into Serbian (ISO 629-2 language code
sr
, you need to specify whether the Latin or Cyrillic is used--sr-latn
orsr-cyrl
)IETF language tag - Wikipedia:
RFC 5646 - Tags for Identifying Languages provides a public specification.
2) Documentation leave case ambiguous
The configuration file (
config.toml
(permalink)) currently only contains lowercase language codes with the exception of:fa-IR
فارسی (ایران) [Persian (Iran)]. To prevent confusion and unnecessary redirects, I recommend explicitly stating that lowercase language tags should be used.3) Region vs Script
(I have the least confidence in this last recommendation.) It is my understanding that script codes better serve the global community than region codes (ex.
➡️zh-cn
zh-hans
and➡️zh-tw
zh-hant
).The text was updated successfully, but these errors were encountered: