# Translations

Thank you for interest in contribute translating Stooa. Here you will find ways to do it.

## How to become a Stooa translator

We are using [Weblate as translation platform](https://hosted.weblate.org/projects/stooa/), so the first thing you need to be a Stooa translator is to have a Weblate account ([you can register here](https://hosted.weblate.org/accounts/register/)).

You also might want to take a look at the guide for [Translating using Weblate](https://docs.weblate.org/en/latest/user/translating.html).

When collaborating with translations, Weblate will automatically create a Pull Request in the project repository with all the translations added.

## Add a new language

To add a language that is still not among the Stooa language options:

* Go to the [components list](https://hosted.weblate.org/projects/stooa/).
* Select the component you want to add the translation.
* Press the "Start new translation" button.
* Choose the language you want to translate to.
* Press the "Start new translation" button at the start new translation page.
* Start translating strings for the new language

![Weblate Components list](https://2597634714-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKYrlhuHibHl4aE0ssTw3%2Fuploads%2Fgit-blob-0da47d10d090d541a4778fa015cd3d1b08711d67%2Fweblate-components-list.png?alt=media)

![Weblate Start new translation button](https://2597634714-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKYrlhuHibHl4aE0ssTw3%2Fuploads%2Fgit-blob-b3e02dc15e0c8155aeb34be4bbda4106dc0f9767%2Fweblate-component-languages.png?alt=media)

![Weblate Add new language](https://2597634714-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKYrlhuHibHl4aE0ssTw3%2Fuploads%2Fgit-blob-16160d916d5ba7477dfcc4c367009b7e859596c4%2Fweblate-start-translation.png?alt=media)

## Add a new translation

To add a new translation (a string with a lacking translation for a certain language) follow the next steps:

* Go to the [components list](https://hosted.weblate.org/projects/stooa/).
* Select the component you want to add the translation.
* Click the edit button (pencil icon) close to the name of the language where you want to add the missing translation or translations.
* Find and select the translation's to complete.
* Complete the translation in the required input field.
* Press the "Save" button.
* Repeat the action with as many translation strings you can / you want

![Weblate Component languages](https://2597634714-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKYrlhuHibHl4aE0ssTw3%2Fuploads%2Fgit-blob-b3e02dc15e0c8155aeb34be4bbda4106dc0f9767%2Fweblate-component-languages.png?alt=media)

![Weblate Edit translation](https://2597634714-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKYrlhuHibHl4aE0ssTw3%2Fuploads%2Fgit-blob-1a6b0ba97458185fb43e06c0819cffb25b0266f7%2Fweblate-edit-translation.png?alt=media)

## Change an approved translation

To edit an already approved translation string follow the next steps:

* Go to the [components list](https://hosted.weblate.org/projects/stooa/).
* Select the component you want to add the translation.
* Click the name of the language where is the translation you want to change.
* Click the Browse button.
* Find and select the translation's to complete.
* Change the translation in the input field.
* Press the "Save" button if you have permissions.

![Weblate Component languages](https://2597634714-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKYrlhuHibHl4aE0ssTw3%2Fuploads%2Fgit-blob-b3e02dc15e0c8155aeb34be4bbda4106dc0f9767%2Fweblate-component-languages.png?alt=media)

![Weblate Browse translations](https://2597634714-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKYrlhuHibHl4aE0ssTw3%2Fuploads%2Fgit-blob-e7132b1d36615990c2e7a42504b95a3e8fce9f32%2Fweblate-browse-translations.png?alt=media)

## New Language Request

In the case of adding a new language, a minimum of 80% of the translations of the entire project components is necessary for the Pull Request to be approved. Furthermore, keep in mind that we will also require the 100% of the translation in the "Frontend - App" and "Frontend - Common" components.

Please consider that the creation of a new language requires the action of developers to integrate it into the app. A Pull Request for this development is also needed so that you can make it yourself, and it will be very welcome! :)

If you are not a developer, you can [start a new discussion](https://github.com/Stooa/Stooa/discussions/new) inside the "Help wanted" category to ask the developer community for help