tomevault-io PaperSpine Translate
Use this branch when output_language is en and translation_package is
zh. Its job is to produce every required Chinese translation file under
paper_rewriting_output/translation_zh/ — not a summary, not a partial set.
Operating Principle
A translation package that covers only a few files is a failed output.
The orchestrator requires a complete translation_zh/ before declaring the
workflow complete. This branch owns the translation responsibility end-to-end.
Three-Phase Flow
Phase 1 — Inventory
Read paper_spine_config.json to determine workflow. List every file that
must be translated. Write the inventory to translation_zh/manifest.md with
status pending for each entry.
Common files (both workflows):
| English Source | Chinese Target |
|---|---|
paper_spine_config.json |
paper_spine_config.zh.md |
source_map.md |
source_map.zh.md |
reference_materials/source_index.md |
reference_materials/source_index.zh.md |
research_dossier.md |
research_dossier.zh.md |
exemplar_learning_dossier.md |
exemplar_learning_dossier.zh.md |
style_profile.md |
style_profile.zh.md |
sota_gap_map.md |
sota_gap_map.zh.md |
motivation_options_after_research.md |
motivation_options_after_research.zh.md |
confirmed_motivation.md |
confirmed_motivation.zh.md |
section_blueprints.md |
section_blueprints.zh.md |
writing_rationale_matrix.md |
writing_rationale_matrix.zh.md |
citation_support_bank.md |
citation_support_bank.zh.md |
latex_report.md |
latex_report.zh.md |
final_artifact_manifest.md |
final_artifact_manifest.zh.md |
artifact_check.md |
artifact_check.zh.md |
the final paper (.tex or .md) |
full_paper_translation.zh.md |
| — | translation_coverage.md |
Rewrite-only additions:
| original_logic_map.md | original_logic_map.zh.md |
| rewrite_matrix.md | rewrite_matrix.zh.md |
| logic_transfer_audit.md | logic_transfer_audit.zh.md |
Build-only additions:
| source_inventory.md | source_inventory.zh.md |
| evidence_bank.md | evidence_bank.zh.md |
| figure_asset_map.md | figure_asset_map.zh.md |
| claim_register.md | claim_register.zh.md |
Phase 2 — Translate
Translate every file listed in the inventory. Follow these rules:
- Plain prose files: Translate the full text. Preserve LaTeX citation keys
(
\cite{...}), labels (\label{...}), equations, file paths, raw numeric values, URLs, and code identifiers as-is. Translate the surrounding prose. - Large tabular files (
writing_rationale_matrix.md,citation_support_bank.md,section_blueprints.md,research_dossier.md,exemplar_learning_dossier.md,sota_gap_map.md, and any workflow-specific tabular files): Translate every row and every cell. The translated table must have at least as many rows as the original. A shortened summary table is a failed output. full_paper_translation.zh.mdmust include: title, abstract, every section and subsection body paragraph, figure captions, table captions and table notes, limitations, conclusion, acknowledgements, and appendix narrative text.- Update
manifest.mdstatus frompending→translatedafter each file.
Do not skip files because they are "large." Do not summarize instead of translating. The audit will reject partial translations.
Phase 3 — Verify
Run the guard script and require PASS:
python scripts/translate_guard.py paper_rewriting_output --markdown --write
This produces translation_zh/translate_guard_report.md. If any check fails,
return to Phase 2 and fix the specific files flagged by the report.
Write translation_coverage.md listing every source file, its Chinese
counterpart, and its final status (translated). Every entry must be
translated before the audit passes.
Integration
This branch is called by the orchestrator after paper-spine-latex and before
paper-spine-audit. The orchestrator's Non-Negotiable Route step 14 requires
the translate guard to PASS before audit begins.
Source: WUBING2023/PaperSpine — distributed by TomeVault.