Skip to content

Latest commit

 

History

History
executable file
·
102 lines (65 loc) · 3.26 KB

README.md

File metadata and controls

executable file
·
102 lines (65 loc) · 3.26 KB

React 中文文档翻译计划

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

团队协作

工具

加入翻译组

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

1494351758.png

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

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

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

项目trello地址

认领翻译

trello-tasks.png

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

安装

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

依赖

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

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

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

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

$ 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 请求合并你的翻译至本仓库中。