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:

Locale Progress Translated
de 0% 0 of 528
es 0% 0 of 528
pt 0% 0 of 528
ru 83% 440 of 528

🏁 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.