searxngRebrandZaclys/docs/dev/translation.rst

Translation

• Weblate
• SearXNG translations branch
• SearXNG Weblate repository
• Weblate Client: wlc
• Babel Command-Line: pybabel
• weblate workflow

Translation takes place on weblate.bubu1.eu.

Translations which has been added by translators on the weblate.bubu1.eu UI are committed to Weblate's counterpart of the SearXNG origin repository which is located at https://weblate.bubu1.eu/git/searxng/searxng.

There is no need to clone this repository, SearXNG Weblate workflow take care of the synchronization with the origin. To avoid merging commits from the counterpart directly on the master branch of SearXNG origin, a pull request (PR) is created by this workflow.

Weblate monitors the translations branch, not the master branch. This branch is an orphan branch, decoupled from the master branch (we already know orphan branches from the gh-pages). The translations branch contains only the

• translation/messages.pot and the
• translation/*/messages.po files, nothing else.

SearXNG's PR workflow to be in sync with Weblate

Sync from origin to weblate: make babel.master.to.translations

For each commit on the master branch of SearXNG origin the GitHub job babel / Update translations branch <.github/workflows/integration.yml> checks for updated translations.

Sync from weblate to origin: make babel.translations.to.master

Every Friday, the GitHub workflow babel / translations: update master branch <.github/workflows/translations-update.yml> creates a PR with the updated translation files:

• translation/messages.pot,
• translation/*/messages.po and
• translation/*/messages.mo

wlc

All weblate integration is done by GitHub workflows, but if you want to use wlc, copy this content into wlc configuration in your HOME ~/.config/weblate

[keys]
https://weblate.bubu1.eu/api/ = APIKEY

Replace APIKEY by your API key.