How to add a new translation

Expand the existing translations of a SIDRE application using OERSI as an example

Add new translation

For adding a new language to the SIDRE frontend and metadata, you need to extend the frontend-labels, the vocabularies and the multilingual search.

Frontend-Labels

Please create a new Issue in sidre-frontend for this with title Add translation into <YOUR-LANGUAGE>

  1. Create a new folder for the ISO-639-1 code of the new language under https://gitlab.com/oersi/sidre/sidre-frontend/-/tree/master/public/locales
  2. Create a translation.json inside of the new folder and translate all the labels in this file (except HEADER and META labels). Template for this may be public/locales/en/translation.json
  3. Create a language.json inside of the new folder. Can be created via get-language-labels.py (uses Wikidata).
  4. In public/locales/common/translation.json: add HEADER.CHANGE_LANGUAGE-entry for the new language. Please use the new language as label.

Vocabularies

The ttl-files of all vocabularies used by OERSI needs to be extended: there needs to be an additional entry in the skos:prefLabel for the new language for every skos:Concept-entry.

Example:

skos:prefLabel "Softwareanwendung"@de, "Software Application"@en, "TRANSLATE ME"@<YOUR-NEW-ISO639-1-CODE> .

Vocabularies:

external contributers: Please attach these files to your Merge-Request/issue.

SIDRE-team: Please create a PullRequest directly in the corresponding github-repositories.

SIDRE-instance-team: we need to add the new language to the Synonyms-process (example-file and/or automatic-process) in order to use the language in the multilingual search. For this: add the new language code to the ansible-variable internationalization_tool_search_index_output_languages.