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.
This commit is contained in:
iacore
2026-08-08 12:54:05 +08:00
parent 1d722b0ddc
commit 63150a9f26
3 changed files with 13 additions and 2 deletions
+1 -1
View File
@@ -1,3 +1,3 @@
[submodule "toolkit"] [submodule "toolkit"]
path = toolkit path = toolkit
url = git@git.sr.ht:~iacore/mpi-translation-toolkit url = ssh://git@codeberg.org/eastwind/translation-toolkit.git
+11
View File
@@ -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) | | **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` | | **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` | | **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` | | **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` | | **Typeset** | The approved bilingual content is laid out into a publishable document. | `.pdf` or `.docx` |
| **Done** | The project is complete. | — | | **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 or to **Polish** if only minor fixes are needed. Once human reviewers are
satisfied, the project moves to **Typeset** and then **Done**. 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 <book dir>`), 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 ## Links
Study material source repo: https://git.sr.ht/~iacore/jingxin-lessons Study material source repo: https://git.sr.ht/~iacore/jingxin-lessons
+1 -1
Submodule toolkit updated: da0ee57834...6144d63b68