DSW Document Template Tool¶

This site documents the tooling used to transform upstream DSW document templates into clean scaffold artifacts for a public translated-template repository.

The current production workflow supports the Traditional Chinese Science Europe DMP Template translation. This repository owns parser behavior, translation-tree generation, scaffold packaging, render regression, and release asset automation. It does not own the translated content itself.

Current Repository Model¶

The maintained workflow has two repositories:

Repository	Role
`ThreeMonth03/dsw-document-template-tool`	Tooling, clean scaffold releases, render regression, docs, and helper scripts.
`depositar/science-europe-template-zh_Hant`	Public translated-template repository: operations config, `sync/v*` branches, and translated release assets.

Start Here¶

Choose the path closest to what you are doing:

New to the repository: read the Operator Quickstart first. It explains the mental model, safe commands, and normal maintenance flow.
Handling a new upstream Science Europe tag: use the Version Upgrade Runbook, then verify release assets with the QA Checklist.
Debugging CI, DSW, render previews, or release upload: start with the CI and Release Runbook, then use Troubleshooting for failure modes.
Changing parser, marker, translation tree, migration, or sync behavior: read Architecture, then follow Parser and Translation Tree.
Connecting the public translated-template repository: use Public Template Repository Integration. If you need copy-ready README/runbook files for that repository, start from Public Repository Templates.
Finding commands: use the Command Reference for Make targets, required variables, and lower-level helper scripts.

Package Reference¶

Use these pages when checking maintainer-facing Python interfaces, shared data contracts, render helpers, or translation-tree APIs:

For implementation helpers below these facades, use Architecture to find the owning module and tests.