v6
This is just a demo of new translation workflow for GitHub repos in Vue ecosystem like Vue Router, Pinia, Vue 3 Migration Guide, etc.
You can also refer to these example PRs.
- Friendly translation workflow.
- Able to show latest checkpoint for each language on the website.
- Comparing to the current workflow on Vue Router, neither checkpoint branches nor commit log format are required.
- People just need one more step to keep the
langMap.json
updated when each time they update their translations.
For contributors/translators:
- run
node bar.js <lang>
to see checkpoint and changes to be translated - create a new git branch
- do the translation
- run
ndoe foo.js <lang>
to update thelangMap.json
before the translation commit - create a PR on GitHub
For maintainer:
- review and approve
- normal merge or squash merge (they both work)
node foo.js <lang> [<branch>|<tag>|<commit>]
: update the checkpoint info of a certain language intolangMap.json
.node bar.js <lang> [<branch>|<tag>|<commit>]
: see what translation you need to do to sync up with the original docs.
- Build command:
node foo.js && npm run build
- Publish directory:
.vitepress/dist