Documentation

CloudBeaver localization

Not all localization comes from the Cloudbeaver source code. Some of it comes from the backend side. So, if you want to, for example, to change or create localization for database objects, you need to do it in another repository, at https://github.com/dbeaver/dbeaver. Here is a guide to how you can contribute to DBeaver's localization https://github.com/dbeaver/dbeaver/wiki/Localization. To create or improve localization for the Cloudbeaver interface, follow these steps:

Note: The images below are taken from Fork. You can use another application to create pull-requests.

  1. Open https://github.com/dbeaver/cloudbeaver and fork repository

Screenshot 2021-08-12 at 15 14 33

  1. Clone the forked repository https://github.com/.../cloudbeaver to your local system.

3

  1. Create a new branch from devel branch (name it, for example, italian-localization).

4

  1. Go to the local repository and find the localization files you want to translate.

In Cloudbeaver, all translatable resources are located in the locales folder. The path to the folder is [package-name]\src\locales[locale-code].ts.
Create a copy of en.ts file in the package you want to change the localization in and name it [locale-code].ts (e.g. it.ts for Italian)

Example: ../repository_name/webapp/packages/core-localization/src/locales

  1. Open the created file and translate the tokens to your language. Change EN on [locale-code] in the top of the file export const defaultENLocale => export const defaultITLocale.

Here is the structure of the language tokens: ['token-name', 'token-value']. You only need to change the second part: 'token-value'. For example, if you wanted to translate the Loading... token, which is ['ui_processing_loading', 'Loading...'], it would look like this: ['ui_processing_loading', 'Caricamento in corso...'].

  1. Open the branch changes and stage them

Screenshot 2021-08-12 at 15 16 59

  1. Commit the changes

Screenshot 2021-08-12 at 15 19 08

  1. Push to origin

Screenshot 2021-08-12 at 15 21 39

  1. Go to Github and press Compare & pull request in your repository

  2. Write a description and create pull request

Here is Github instruction. You can use different IDEs to create pull requests.