Hacktoberfest 2026 : les issues que les mainteneurs ont marquées pour octobre, ouvertes et accessibles aux débutants. Parcourir les issues Hacktoberfest

Description of the translation and update process

Ouverte
  • Quelque chose ne va pas ?
#603 2 commentaires 0 réactions 0 personnes assignées Voir sur GitHub

Les mainteneurs répondent en général sous 13 jours

Personne n'a encore pris cette issue.

Évaluation

Difficulté
2/5
Temps estimé
1-3 heures
Accessibilité débutants
35/100
Type d'issue
Documentation
Clarté
À clarifier
Activité
À l'abandon
Stack technique
git, github
Domaine
documentation

Piste de recherche

Examinez le workflow de traduction décrit dans le corps de l’issue, notamment la prise en charge du travail, la création d’un fork et le clonage, la création de branches, la soumission d’une pull request, la relecture et la synchronisation des mises à jour. Aucun fichier de documentation cible n’est indiqué ; la tâche est considérée comme terminée lorsque ce processus est documenté à l’emplacement approprié du repository et reflète fidèlement le workflow décrit.

Rédigé par le modèle d'indexation à partir du texte de l'issue.

Description

翻译流程

本文档由 @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
Langage dominant
JavaScript
Étoiles
995
Forks
1.1k
Merge moyen
12 j 7 h
PR mergées (30 j)
1

Préparer son environnement

Par où commencer

  1. Lisez l'issue en entier, puis le guide de contribution du projet.
  2. Signalez en commentaire que vous la prenez — cela évite que deux personnes fassent le même travail.
  3. Forkez le dépôt et travaillez sur une branche.
  4. Ouvrez une pull request qui référence le numéro de l'issue.

Autres issues de reactjs/zh-hans.react.dev

Toutes les issues de reactjs/zh-hans.react.dev

Issues similaires

Plus d'issues JavaScript

Recevez les nouvelles issues par e-mail

Un résumé court des issues GitHub adaptées aux débutants.