📘 Эта документация также доступна на русском.
📋 Contents
- Overview
- Translate Online
- Adding a New Translation
- Updating Existing Translations
- Compiling Translations
- Spell Check
📖 Overview
Localization in PortProtonQT is powered by Babel using .po/.mo files stored under LC_MESSAGES/portprotonqt.po for each language.
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
- Run:
uv python install 3.10
uv sync --all-extras --dev
source .venv/bin/activate
python dev-scripts/l10n.py --create-new <locale_code>
- Edit the file
portprotonqt/locales/<locale>/LC_MESSAGES/portprotonqt.poin Poedit or GTranslator.
🔄 Updating Existing Translations
If you’ve added new strings to the code:
uv python install 3.10
uv sync --all-extras --dev
source .venv/bin/activate
python dev-scripts/l10n.py --update-all
🧵 Compiling Translations
uv python install 3.10
uv sync --all-extras --dev
source .venv/bin/activate
python dev-scripts/l10n.py
🔍 Spell Check
To check spelling, run the following commands:
uv python install 3.10
uv sync --all-extras --dev
source .venv/bin/activate
python dev-scripts/l10n.py --spellcheck
The script performs parallel spellchecking of strings in .po and .pot files. For each file, it prints the list of strings being checked and highlights any spelling errors with suggestions. Words listed in dev-scripts/.spellignore are ignored and not treated as typos.