Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Instructions to start the script have been updated.TODO update the documentation at Localization L10n

Early DSpace 7 Documentation is now available at Multilingual Support

Volunteer!

Please list your name, email address alongside any of the languages to which you wish to contribute. Also feel free to join the channel #translation on the DuraSpace DSpace Slack for assistance and discussion around DSpace 7 translations. 

...

Spanish (es.json5)

Maria Fernanda Ruiz

Eva Braña Arvo Consultores for Version 7.3 )

Emilio Lorenzo (Arvo Consultores for Version 7.3 )

Brazilian Portuguese (pt-BR.json5)

...

Latvian (lv.json5)

Denijs Balodis

Translator documentation

...

Polish (pl.json5)

Michał Dykas  (PCG Academia)

Translator documentation

The authoritative English master file (en.json5)

The The catalogs can be found in src/assets/i18n

...

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

Code Block
{
    code: 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. 

...

Code Block
titlejson5 validate
yarn json5 --validate ./src/resourcesassets/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):

Code Block
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:

Code Block
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:

Code Block
# 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!

...