How to add new translations to an existing language

Find the file that includes .po extension, you can find it in the ./locales folder or in the node_modules/@c8y/locales. Select the language you want to update i.e. pt_BR.po

If desired language is already present under the ./locales folder procceed to the next step. If the .po file with the slected language is placed in the node_modules copy it to the ./locales folder. You can also use this boilerplate to create .po file from scratch:


          "Project-Id-Version: c8yui.core\n"
          "Report-Msgid-Bugs-To: \n"
          "POT-Creation-Date: \n"
          "PO-Revision-Date: \n"
          "Last-Translator: \n"
          "Language: pt_BR\n"
          "Language-Team: \n"
          "Content-Type: text/plain; charset=UTF-8\n"
          "Content-Transfer-Encoding: 8bit\n"
          "Plural-Forms: nplurals=2; plural=(n != 1);\n"

          msgid ""
          msgstr ""

or create it with program like: Poedit.

Fill in the msgid field as follows: msgid "Awesome Tab"
Fill in the msgstr field with your translation: msgstr "Separador Incrível"
In the index.ts file, add the following line: import "./locales/pt_BR.po";
Save your changes and restart your dev server. New translated string should be available.

How to edit existing translations

The main difference between adding and editing an existing translation is to find the existing translation and only modify the msgstr field in your new or copied .po file. You can find all translated strings in the node_modules/@c8y/locales or use c8ycli locale-extract command described below.

How to add new translations to an existing language with the c8ycli locale-extract

c8ycli locale-extract is the command that automatically copies all translations from the node_modules/@c8y/locales. This makes it easier to edit and add new translations.
After using this command, the folder ./locales will contain all available translations. The rest of the process is the same as above.