Internationalization

To show localized dashboard, you need to build dashboard binary before. To build dashboard binary, run npm run build. Or to build and run localized dashboard immediately, run npm run start:prod.

Note: Building localized dashboard takes time, so development environment, e.g. npm start, does not compile localized versions.

All translation data is stored in i18n/ directory in project’s root. It includes locale_conf.json configuration file, translation source file messages.xlf and translation files for each language, e.g. i18n/fr/messages.fr.xlf or i18n/ja/messages.ja.xlf.

Localization is handled by Angular. Add i18n attribute into tag surrounding new text in Angular template html files.

To translate new localizable text

xliffmerge would copy new localizable texts from element to <target> element with state="new" attribute in your translation file, i.e. i18n/[locale]/messages.[locale].xlf. Find new localizable texts in i18n/[locale]/messages.[locale].xlf file and translate text in the <target> element.

Since dashboard team can not review translation files in your language, so dashboard team transfers authority to review and approve for updating your translation file. At first, you need to organize translation team for your language that manages dashboard translation file.

Create your locale directory under i18n directory, e.g. i18n/fr or i18n/ja.
Run . Then translation file for your language, e.g. i18n/fr/messages.fr.xlf, would be generated in your locale directory.
Open your translation file and translate texts in <target> element into your language, and remove state="new" to mark it as translated.
To build dashboard for your language, add your locale into locales in angular.json like follow: If you want to add only locale using an existing translation file, specify existing translation file to "translation".

After preparation of new translation file, configure i18n/locale_conf.json file to support translated dashboard as follows:

To add Japanese translation file, add "ja" into "translations" array in alphabetical order.

Before submit Pull Request, add i18n/[locale]/OWNERS file for your translation team like below:

By changes for html files, workflow for i18n on Kubernetes Dashboard updates your translation file. To ease watching updates for your translation file in the future, set labels in your OWNERS file like above. It would allow you watching updates for your translation file with watching PRs having this label in kubernetes/dashboard repository like this.

At last, please create Pull Request and submit it to kubernetes/dashboard.