PortProtonQt/documentation/localization_guide

Эта документация также доступна на русском.

---

Contents

• Overview
• Translate Online
• Adding a New Translation
• Updating Existing Translations

---

Overview

Localization in PortProtonQT is powered by Babel using .po files stored under LC_MESSAGES/portprotonqt.po for each language. To see updated translations in the app, you must generate .mo files after editing .po.

Current translation status:

---

Translate Online

You can help translate PortProtonQt using our web-based translation platform:

translate.codeberg.org/engage/portprotonqt

Benefits of using the web platform:

• No need to set up a development environment
• Work directly in your browser
• See context and suggestions from other translators
• Collaborate with the community

Translations submitted online are periodically reviewed and merged into the main repository.

---

Adding a New Translation

1. Run:

uv python install 3.11
uv sync --all-extras --dev
source .venv/bin/activate
python dev-scripts/l10n.py --create-new <locale_code>

2. Edit the file portprotonqt/locales/<locale>/LC_MESSAGES/portprotonqt.po in Poedit or GTranslator.
3. Generate .mo files:

python dev-scripts/l10n.py

---

Updating Existing Translations

If you’ve added new strings to the code:

uv python install 3.11
uv sync --all-extras --dev
source .venv/bin/activate
python dev-scripts/l10n.py --update-all

After editing .po files, generate .mo; otherwise new translations will not be visible in the UI:

python dev-scripts/l10n.py

---