Files
PortProtonQt/documentation/localization_guide

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


📋 Contents


📖 Overview

Localization in PortProtonQT is powered by Babel using .po/.mo files stored under LC_MESSAGES/portprotonqt.po for each language.

Current translation status:

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.10
uv sync --all-extras --dev
source .venv/bin/activate
python dev-scripts/l10n.py --create-new <locale_code>
  1. Edit the file portprotonqt/locales/<locale>/LC_MESSAGES/portprotonqt.po in 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.