Hacktoberfest 2026: as issues que os mantenedores marcaram para outubro, abertas e boas para iniciantes. Ver issues do Hacktoberfest

Description of the translation and update process

Aberta
  • Algo errado?
#603 2 comentários 0 reações 0 responsáveis Ver no GitHub

Ninguém assumiu esta issue ainda.

Avaliação

Dificuldade
2/5
Tempo estimado
1-3 horas
Facilidade para iniciantes
35/100
Tipo de issue
Documentação
Clareza
Precisa de esclarecimento
Status de atividade
Estagnada
Stack de tecnologia
git, github
Domínio
documentation

Direção de pesquisa

Revise o fluxo de trabalho de tradução descrito no corpo da issue, incluindo assumir o trabalho, fazer fork e clone, criar branches, enviar um pull request, revisar e sincronizar atualizações. Nenhum arquivo de documentação de destino foi especificado; a conclusão significa que esse processo está documentado no local apropriado do repositório e reflete com precisão o fluxo de trabalho descrito.

Escrita pelo modelo de indexação a partir do texto da issue.

Descrição

翻译流程

本文档由 @docschina-bot 自动与 英文文档 同步更新，更新频次每天一次，更新时间为每周一早 6 点。因此，无需担心同步问题。

此流程遵循标准的 Github Flow，如已了解可直接略过。

Github Flow

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

  • 认领阶段
  • 翻译阶段
  • 校对阶段

认领阶段

如未认领文档就直接翻译，容易出现撞车的情况。

因此，在翻译前 务必进行任务认领。

认领任务，请到 Github Issues 选择想翻译的文档。翻译任务认领 在此。

选定要翻译的文档后，即可开始翻译。

翻译阶段

以 React 中文文档为例，如需对某篇文章进行翻译。

翻译过程中，请注意格式和内容的准确性。

fork 并 clone

先将 reactjs/zh-hans.reactjs.dev 的文档仓库 fork 为个人仓库（有增删改的权限）。

将 fork 后的仓库 download 至本地，如：

git clone https://github.com/<YOUR-GITHUB-NAME>/zh-hans.react.dev/

如下载过程过慢，可使用 depth 忽略以往的提交，这里不做过多赘述。

请基于 main 分支创建你的翻译分支（目的是，保证 main 分支与主仓库内容始终一致）。

例如：

git checkout -b <翻译分支> main
翻译

ps:

  1. 在开始翻译前，请务必先了解中文排版说明。
  2. 翻译时，请为每个标题添加锚点信息。例如：## React 文档 {/*react-docs*/}。具体可参照已经翻译完的文档。

在 clone 好的文档中找到你所认领的文章，即可开始翻译。

翻译中请务必注意 排版规范，尽量不要让校对者在文档格式方面浪费时间。

翻译完成后，请 push 至个人仓库。

git add -A
git commit -m 'docs(cn): 翻译的哪篇文章'
git push -u origin <翻译分支>

再创建 Pull Request 至 reactjs/zh-hans.react.dev 仓库。

注意：在创建 Pull Request 时，请尽量勾选允许其他人进行修改，便于快速修改及合并。
Pull Request 的命名参考格式 docs(cn): translate dir/xxx into Chinese，如 docs(cn): translate reference/react-dom/components/option into Chinese。

至此翻译阶段就结束了。

校对阶段

翻译完成请评论 @校对者

  • @Yucohny @loveloki @awxiaoxian2020

校对中，如有疑问或翻译错误，校对者会给出建议。

Github 的 PR 的评论提供了 suggestion 的功能，校对者对某行给出校对建议后，如无异议，可以直接进行合并。

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

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

完成

校对完成后，校对者会对 PR 进行 Approve 操作，并进行 Pull Request 的合并。

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

其他

如需再次翻译，或同时翻译多篇。

  • 一次 pr 尽量只有一篇文章的翻译，便于回溯
  • 保证个人仓库的 main 分支始终为最新
  • 每次翻译新文章时，请基于 main 分支拉取新分支

更新个人仓库的分支

git remote add upstream https://github.com/reactjs/zh-hans.react.dev.git
git fetch upstream
git checkout main
git merge upstream/main
Linguagem predominante
JavaScript
Estrelas
995
Forks
1.1k
Nenhum PR com merge em 30d

Preparar o ambiente

Primeiros passos

  1. Leia a issue inteira e depois o guia de contribuição do projeto.
  2. Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
  3. Faça um fork do repositório e trabalhe em uma branch.
  4. Abra um pull request que referencie o número da issue.

Mais de reactjs/zh-hans.react.dev

Todas as issues de reactjs/zh-hans.react.dev

Issues semelhantes

Mais issues de JavaScript

Receba novas issues na sua caixa de entrada

Um resumo curto de issues do GitHub para quem está começando.