Documentation Translations
This directory stores Sphinx/gettext translation catalogs. English .rst files
under docs/source/ remain the source of truth.
Directory Layout
zh_CN/: Simplified Chinese translations.LC_MESSAGES/: Standard gettext catalog directory..po: Reviewable translation files generated/updated bysphinx-intl.
Translation Flow
sphinx-build -b gettextextracts English strings into.pottemplates (throwaway).sphinx-intl updatewrites new strings as empty entries and changed strings asfuzzyin the committed.pofiles.tools/translate_docs_zh.pycalls the model to fill in the empty and fuzzy entries.- A PR is opened on
automation/update-chinese-docsfor human review. - After merge,
build_doc.ymlrebuilds the site at/zh_CN/.
Steps 1–4 run weekly in translate_doc_zh.yml (Monday 09:00 UTC, or manual
dispatch). Step 5 runs automatically on push to dev.
To change the translation prompt, edit the system message in
tools/translate_docs_zh.py.
This README is for maintainers only. It is not linked from the Sphinx toctree, so it should not appear on the public documentation website.