eastwind/translation-files
1
0
Fork 0
Code Issues 1 Pull Requests 1 Actions Packages Projects Releases Wiki Activity

Document batch translation workflow; move toolkit to Codeberg

Browse Source 
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
Download Patch File Download Diff File Expand all files Collapse all files
readme.dj
+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) |
| **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 <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
Study material source repo: https://git.sr.ht/~iacore/jingxin-lessons