翻译流程

整个翻译流程分为以下几个阶段：

认领阶段
翻译阶段
review 阶段

认领阶段

首先，请在翻译任务认领进行任务认领
查看任务TODO list。
选择没被人认领的任务，避免与他人重复。
可以与认领了任务但还没开始的同学商议转让。
有任何问题可以在微信群内沟通。

翻译阶段

fork 官方仓库 https://github.com/withastro/docs

先将官方仓库fork 到个人仓库将 fork 后的仓库 clone 到本地：

git clone https://github.com/<YOUR-GITHUB-NAME>/docs/

建议基于 main 分支创建翻译分支，main 分支用于同步主仓库

git checkout -b <翻译分支>

如果页面之前没有引用关系，建议一个页面提交一个 PR。 修改新页面提 PR 之前，请切换到 main 分支，同步上游主仓库之后重新切出新分支提 PR。

翻译

pnpm i 安装依赖
pnpm run dev 运行文档项目
修改 src/content/docs/zh-cn/ 文件夹下的文件内容或者新建不存在的页面（.md 或 .mdx）

翻译完成后，请提交到你的远程个人仓库

git add
git commit -m 'i18n(zh-cn): translate xxx.md'
git push -u origin <翻译分支>

提交你的更改到自己的仓库
再创建 Pull Request 至官方仓库 https://github.com/withastro/docs
PR 标题为i18n(zh-cn): translate xxx.md 或者 i18n(zh-cn): update xxx.md

review 阶段

提交PR后请通知 reviewer，可以在pr评论艾特，也可以在群内通知：

liruifengv

review 过程中中，如有疑问或翻译错误，reviewer 会给出建议。 Github 的 PR 的评论提供了 suggestion 的功能，reviewer 对某行给出校对建议后，如无异议，可以直接进行使用 GitHub 的 commit suggestion 功能提交。

而如果改动点较多，需进行本地修改时，则在本地对对应的内容进行修改，并提交到个人仓库的翻译分支即可。

注意: 无需关闭 Pull Request，Pull Reuquest 会自动追踪你的修改。

完成

中文 review 完成后，reviewer 会对 PR 进行 Approve 操作
等待官方团队成员 review
进行 Pull Request 的合并。

当你的 Pull Request 被合并后，则代表流程结束。

PR 规范

PR 标题：例如 i18n(zh-cn): translate xxx.md PR 描述。需要在默认文本上进行修改。选择你本次修改的分类，翻译的基本就是Translated content 描述例如 translate from-vuepress.mdx、update from-vuepress.mdx

### What kind of changes does this PR include?
Translated content
### Description
translate from-vuepress.mdx

注意事项：

你可以使用翻译软件或者 chatGPT 等来翻译，请检查确保翻译的准确性和流畅性。
翻译可能会导致 URL hash 锚点的改变，请注意可能会导致产生断开的链接（broken link）。
各个页面的会有引用，注意引用的链接的时效，确保 CI 通过。
PR 请按照规范提交并增加描述。例如 i18n(zh-cn): translate xxx.md

liruifengv / docs

翻译及 PR 流程 #2