build: consume zh_CN catalogs from the guidebook submodule (single home)

.github/workflows/docs.yml

@@ -45,15 +45,15 @@ jobs:
 
       - name: Check zh_CN catalogs are current
         run: |
-          uv run --locked sphinx-intl update -p _build/gettext -l zh_CN --locale-dir locales
-          uv run --locked python tools/i18n/normalize_po_files.py
-          git diff --exit-code -- locales
+          uv run --locked sphinx-intl update -p _build/gettext -l zh_CN --locale-dir guidebook/locales
+          uv run --locked python tools/i18n/normalize_po_files.py --locale-dir guidebook/locales
+          git -C guidebook diff --exit-code -- locales
 
       - name: Build zh_CN HTML
         run: uv run --locked sphinx-build -b html -c . -D language=zh_CN _staging _build/html/zh_CN
 
       - name: Report zh_CN catalog status
-        run: uv run --locked python tools/i18n/catalog_status.py
+        run: uv run --locked python tools/i18n/catalog_status.py --locale-dir guidebook/locales/zh_CN/LC_MESSAGES
 
       - name: Prepare GitHub Pages artifact
         if: github.event_name != 'pull_request'

conf.py

@@ -24,7 +24,10 @@
     "SUMMARY.md",
 ]
 
-locale_dirs = [os.path.abspath("locales")]
+# Translation catalogs live in the editorial repo (the guidebook submodule),
+# so they sit next to the English source they translate. The production build
+# consumes them from there; there is no separate copy in this repository.
+locale_dirs = [os.path.abspath("guidebook/locales")]
 gettext_compact = False
 
 myst_enable_extensions = ["colon_fence", "tasklist"]