FazBrowse GitHub Viewer | Trending |
URL:
| Home
Tools: [Download Repo ZIP]   [Original HTTPS Page]

Document the pybabel translation workflow by xlyy1 · Pull Request #1397 · python-babel/babel · GitHub

Repository navigation

Document the pybabel translation workflow - #1397

Open
xlyy1 wants to merge 1 commit into
python-babel:masterfrom
xlyy1:document-pybabel-translation-workflow
Open

xlyy1 wants to merge 1 commit into
python-babel:masterfrom
xlyy1:document-pybabel-translation-workflow

Conversation

xlyy1 commented Oct 19, 2026

Copy link
Copy Markdown

The command reference describes individual options, but first-time users lack a complete example showing how catalogs are created and maintained. Add a Python gettext walkthrough covering extract, init, translation, compile, and update, plus Jinja extraction and runtime configuration. Link it from the command reference.

Fixes #1050.

Validation on Windows, CPython 3.13, Jinja 3.1.6:

  • Ran the documented CLI workflow in a temporary project: fallback before compilation, German translation loading, updates preserving existing translations, and Python/Jinja extraction and rendering all passed.
  • git diff --check passed.
  • Sphinx 9.1.0 HTML builds with -W --keep-going report the same six existing warnings/errors on the base and this branch (Python inventory network failure, existing docstring indentation and unresolved targets); no new diagnostics.

The CLDR 48.2 download was unavailable locally, so the walkthrough and builds used generated locale data from the released Babel 2.18.0 package. No library code changed; the full runtime test suite was not run.

Prepared with assistance from OpenAI Codex.

This branch has not been deployed

No deployments
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters. Learn more about bidirectional Unicode characters
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[doc] Describe how to work with the pybabel CLI

1 participant


Back | FazBrowse Home | New Git URL