📘 Эта документация также доступна на русском.
📋 Contents
📖 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
- 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. - Generate
.mofiles:
python dev-scripts/l10n.py
🔄 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
After editing .po files, generate .mo; otherwise new translations will not be visible in the UI:
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.