...

Polish (pl.json5)

Michał DykasMichał Pasternak  (PCG Academia)

Translator documentation

The authoritative English master file (en.json5)

...

4. Activate the new language in environment.common.ts ./src/config/default-app-config.ts (look for the "LangConfig[]" array)

languages: LangConfig[] = [
  ...
  { 

{
    code: 'nl',
    label: 'Nederlands',
    active: true},
}
  ...
];

Where code is the two letter code for your language, also used as the filename for your translated catalog. 

...

yarn json5 --validate ./resourcessrc/assets/i18n/es.json5

Examples of possible errors you might get:

...

This particular mistake occurred where there was an extra space between \ and " in the \" combination used to escape the "

Checking your files syntax via "lint"

Lint is a tool we use to ensure files are correctly formatted, and have no extra characters (e.g. extra spaces at the end of each line can make the file large in size, which take longer for users to download).  This simple command will check your file's syntax (run this from the root folder):

yarn lint --lint-file-patterns src/assets/i18n/*.json5

(NOTE: Warnings shown by lint can be ignored.  Errors are the only thing that require cleanup)

If that throws errors, most can be automatically cleaned up by adding "--fix" to the same command:

yarn lint --lint-file-patterns src/assets/i18n/*.json5 --fix

NOTE: currently, "--fix" is unable to add missing commas on the end of each line.  Every new line (which is not a comment) MUST end in a comma.  However, if you have a missing comma, you'll see an error like this:

# This error is a sign that you have a missing comma on the line just BEFORE [some translation key]
Parsing error: Unexpected token [some translation key]

Your first translation pull request!

...