liuestc / react

react docs in Chinese | react中文文档翻译

React 中文文档翻译计划

我们使用 Jekyll 静态站点生成器，使用 (mostly) 处理 Markdown, 文档部署在 GitHub Pages.

团队协作

工具

• Github
• Trello
• Gitlo

加入翻译组

如果你有充足的时间，良好的英文水平，能够流利阅读英文文档，且对前端框架比较了解，欢迎你加入我们的翻译组，请用微信扫码入群：

我们使用 Github issue 管理项目进度。翻译组成员无需直接提出issue，注册完成github和trello之后，可以使用第三方工具gitlo进行协作。

点击邀请链接加入翻译组，根据提示连接你的github及trello账号。

在微信群公告内获取trello项目的邀请链接，以获取编辑看板的权限。

项目trello地址

认领翻译

新建一个与你github名称同名的列表，并将待翻译列表中的待翻译文档拖拽至你的列表中，视为认领翻译（切勿随意编辑他人创建的列表）。

安装

如果你想要参与文档的翻译，首先需要在本地部署文档的jekyll站点。

依赖

首先点击右上角的 fork 按钮拷贝本项目到你的github账号下

克隆你fork的仓库到电脑本地：

$ git clone https://github.com/[YourGithubUserName]/react.git

在使用jkeyll之前，我们需要先安装好ruby

• Ruby (version >= 1.8.7)
• RubyGems (version >= 1.3.7)
• Bundler (使用 gem install bundler)

$ cd react/docs
$ bundle install # Might need sudo.
$ npm install

如果你受到国内糟糕的网络环境影响，请将ruby源切换至国内镜像ruby-china.

构建文档

先跑一下 grunt 确保项目已被构建。

使用 Jekyll 在本地运行站点 (默认端口路由为： http://localhost:4000):

$ cd react/docs
$ bundle exec rake
$ bundle exec jekyll serve -w -L
$ open http://localhost:4000/react/index.html

生成文档

通过如下命令，我们可以在和react存放的统一路径下名为 react-gh-pages 的文件夹中生成文档。

$ bundle exec rake release

发布文档

切换至本项目的 gh-pages 分支下，复制 react-gh-pages 文件夹中的所有内容，提交并同步至项目中。

# 如果是初次在本地创建 gh-pages 分支
$ git checkout --orphan gh-pages
$ git rm --cached -r .
# 复制粘贴 `react-gh-pages` 文件夹中的所有内容
# 切换至文档部署分支
$ git checkout gh-pages
# 复制粘贴 `react-gh-pages` 文件夹中的所有内容
$ git add .
$ git commit -m 'update docs'
$ git push origin gh-pages

申请合并

完成你所选部分的翻译之后，可以在 Pull requests 页面发起新的 Pull requests 请求合并你的翻译至本仓库中。