Lingohub support for language codes in localization

Which language codes (ISO) do we support on LingoHub? This article outlines our support for language codes and explains some important aspects regarding ISO codes, exceptions and legacy encoding.

How do we approach language codes? When importing the resource file into the lingohub project, we try to detect the language for the file

• from the information within the file itself (for the formats where it is applicable)
• from the file name or
• from the file path (if the file is being imported via repository)

If the detection fails, the language can still be chosen from the list.

Language codes

The language information should be specified by the language code. We support all language codes found in the current up to date list defined in ISO 639-1 standard. Also, for all countries/territories that list official languages we support language-region combinations.

For example, for Switzerland (CH), where the official languages are German (de), French (fr), Italian (it) and Romansch (rm), these are combinations that we support: de-CH, fr-CH, it-CH, rm-CH.

Additionally, we support all Facebook codes. For migrating deprecated codes (those that were removed from the standard list at some point) to their valid alternatives, this page can be consulted.

• ISO 639-1 - covers the registration of two letter language codes. The complete list of all registered ISO 639-1 language codes can be found here.
• language / region separators that we accept are dash and underscore ( - _ )
• ISO 3166-1 alpha-2 codes - defines two letter country codes that represent countries, dependent territories, and special areas of geographical interest.

Some resource file formats make it possible to define the language code of the associated language within the file. If that is the case with the uploaded resource file, and the valid code is specified, that is what we use.

Examples of valid language codes:

• en
• de-AT
• nl_BE

Specifying the language code in a file name

if there is no language code specified within the file, we try to detect it from the file name, here is how LingoHub will approach it:

• base names are optional - the file name can consist of language code and extension only, for example: en.yml
• language code separators come between the base name (if it is present) and the language code
• valid language code separators are dot, underscore and dash ( . _ - )
• two letter lower case language code
• language / region separators that we accept are dash and underscore ( - _ )
• two letter upper case region code
• extension as specified for particular resource file format

Examples of properly formatted resource file names:

• en.yml
• en-US.yml
• en_US.yml
• activerecord.en.yml
• activerecord_en.yml
• activerecord-en.yml

Specifying the language code in file path

If the resource file is imported via repository, and no language code was found within the file or file name, we will search for it anywhere in the path preceding the file name.

The language code can be found anywhere in the path and it needs to conform to the same rules as expected when it is in the file name.

Example of paths with valid language codes specified:

• en/activerecord.yml
• en/activerecord/errors.yml
• locales/en/activerecord.yml
• locales/activerecord.en/errors.yml

A list of all language codes supported by LingoHub

This table lits all language codes currently supported by LingoHub