Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

How to contribute to translations #516

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
64 changes: 64 additions & 0 deletions documentation/get-started/how-to-contribute-translation.en.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,64 @@
---
title: How to contribute to translation
tx_slug: documentation_get-started_how-to-contribute-translation
---

# Contributing to the Translation

Translations for the QField app are managed through the **Transifex** platform.

## 1. Access the Translation Platform

1. Go to the [OPENGIS Dashboard on Transifex](https://www.transifex.com/opengisch/).
2. Log in or create an account on Transifex.

## 2. Choose a Language to Contribute

1. Select a project you want to contribute to.
2. Select the language you want to contribute to.
3. Look for languages requiring translation. For these languages, you'll see a "Translate" button. Click on it.

!![](../assets/images/transifex_translation_01.png,850px)

## 3. Navigate to the Translation Interface

1. Use the filters to streamline your work:

- Click on the "Status" dropdown menu.
- Choose **Translated**.

!![](../assets/images/transifex_translation_02.png,850px)

- Then choose **No**.

!![](../assets/images/transifex_translation_03.png,850px)

## 4. Translate Strings

1. For each untranslated string:

- Enter the equivalent translation in the "Type your translation here" field.
- Ensure the translation is accurate and contextually appropriate.

!![](../assets/images/transifex_translation_04.png,850px)

2. Follow these important guidelines while translating:

- **Preserve Cases**: Retain uppercase and lowercase letters as required.
- **Preserve Reserved Words and Formatting**: Do not alter placeholders like `()`, `%1`, `<strong>`, or `<br>`.

!![](../assets/images/transifex_translation_05.png,850px)

3. Once the translation is complete, click the **Save changes** button.

!![](../assets/images/transifex_translation_06.png,850px)

## 5. Review Your Translation

- Confirm that the translation aligns with the guidelines provided in the [Translation process](https://github.com/opengisch/QField-docs?tab=readme-ov-file#translation-process).

## 6. Synchronization and Testing

- Translations are typically synchronized with the QField app’s master codebase each day.
- To see your translation reflected in the app:
- Join the [QField Beta Program](https://play.google.com/apps/testing/ch.opengis.qfield_dev) for early access to new releases with this translations.
1 change: 1 addition & 0 deletions mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -63,6 +63,7 @@ nav:
- get-started/sponsor.md
- get-started/license.md
- get-started/contribute.md
- get-started/how-to-contribute-translation.md
- get-started/third-part-tutorials.md
- How-to guides:
- how-to/index.md
Expand Down
Loading