From 63150a9f26296a88036d4311d964a61ae7645b06 Mon Sep 17 00:00:00 2001 From: iacore Date: Sat, 8 Aug 2026 12:54:05 +0800 Subject: [PATCH] Document batch translation workflow; move toolkit to Codeberg readme.dj: add Verify stage (check-translation.py, 11 checks) to the translation pipeline and a 'Translating a batch of books' section pointing to toolkit AGENTS.md Workflow C (proven on 9 books, 2026-08-07). .gitmodules: point toolkit submodule at codeberg.org/eastwind (migrated from git.sr.ht); bump submodule to include the check gate and Workflow C docs. --- .gitmodules | 2 +- readme.dj | 11 +++++++++++ toolkit | 2 +- 3 files changed, 13 insertions(+), 2 deletions(-) diff --git a/.gitmodules b/.gitmodules index 913c95f..de0858f 100644 --- a/.gitmodules +++ b/.gitmodules @@ -1,3 +1,3 @@ [submodule "toolkit"] path = toolkit - url = git@git.sr.ht:~iacore/mpi-translation-toolkit + url = ssh://git@codeberg.org/eastwind/translation-toolkit.git diff --git a/readme.dj b/readme.dj index 010e64a..2a0aa5b 100644 --- a/readme.dj +++ b/readme.dj @@ -24,6 +24,7 @@ has a clear output and a clear handoff to the next stage. | **Self-review** | The translator reviews the draft for terminology, accuracy, grammar, and flow. | `translation-findings.dj` (optional) | | **Other-review** | A peer reviewer examines the draft and records findings for the translator. | `review-comments.dj` | | **Polish** | Review findings are applied to the translation, and the bilingual file is regenerated. | updated `target.dj`, `bilingual.dj` | +| **Verify** | The deterministic check suite runs: line/paragraph/heading parity, emphasis preservation, CJK and Chinese-punctuation leakage, digit fidelity, bilingual freshness. Run before delivering; keep green as a regression suite. | `toolkit/scripts/check-translation.py` output, all PASS | | **Human review** | Human translators or editors review the polished text and approve or send it back. | approved `target.dj` | | **Typeset** | The approved bilingual content is laid out into a publishable document. | `.pdf` or `.docx` | | **Done** | The project is complete. | — | @@ -33,6 +34,16 @@ other-review may return to **Translate** if the draft needs to be redrafted, or to **Polish** if only minor fixes are needed. Once human reviewers are satisfied, the project moves to **Typeset** and then **Done**. +## Translating a batch of books + +To translate several books at once, run one omp session per book in its own +herdr pane with the slow model (`omp --model slow --cwd `), review +all of them in parallel, then send each pane an apply pass and gate the batch +with `check-translation.py` before packaging a zip. The full recipe, the three +canonical prompts (translate / review / apply), and the hard-won gotchas live +in `toolkit/AGENTS.md` → **Workflow C**. Proven on 9 books in a single run +(2026-08-07): every book passed all 11 checks. + ## Links Study material source repo: https://git.sr.ht/~iacore/jingxin-lessons diff --git a/toolkit b/toolkit index da0ee57..6144d63 160000 --- a/toolkit +++ b/toolkit @@ -1 +1 @@ -Subproject commit da0ee578340da7b348347fe7043073cd41e71a20 +Subproject commit 6144d63b682c60db76c8af1ddc30b7f62cb2a1b1