使用 curl:
ruby -e "$(curl -sSL https://rawgithub.com/ruby-china/guides/master/install.rb)"或使用 wget:
ruby <(wget --no-check-certificate https://rawgithub.com/ruby-china/guides/master/install.rb -O -)会抓取 ruby-china/rails 与 ruby-china/guides 这两个代码库。
ruby-china/rails:更新原文用。
ruby-china/guides:存放译文用。
这俩个代码库默认会存放在:
~/docs/rails-guides-translation-cn
若是手动抓取,需修改这两个代码库存放的位置,并存成 BASE_PATH 文件。
-
- 先更新原文。
比如 getting_started.md:
$ rake guides:update_guide getting_started.md这样 source/getting_started.md 便是最新的,拷贝原文内容到 source/zh-CN/getting_started.md 下便可开始翻译。
-
- 进行翻译。
$ GUIDES_LANGUAGE=zh-CN rake guides:generate命令过长可在 ~/.bashrc 或 ~/.zshrc 设别名:
alias gen="GUIDES_LANGUAGE=zh-CN rake guides:generate"`。-
- 翻译完成发送 Pull Request。
注意,翻译完成的译文必须与原文是相同版本。
把目前的工作成果发送 Pull Request,让其他人接手。
使用:
$ rake guides:update_guides来看所有上游有更新的原文。
以 getting_started.md 为例。
运行:
$ rake guides:update_guide getting_started.md
$ git status开新分支:
$ git checkout -b new-branch-name将原文更动的部份,翻译、修正到 source/zh-CN/getting_started.md,提交、发送 Pull Request。
以 getting_started.md 为例。
$ rake guides:update_guides
$ git status开新分支:
$ git checkout -b new-branch-name把原文 source/getting_started.md 的内容拷贝到 source/zh-CN/getting_started.md ,提交,发送 Pull Request。
翻译的错误,可以修正后发 Pull Request;或是回报等别人修正也可以。
若不是翻译的错误,是原文的错误,请检查 http://edgeguides.rubyonrails.org 是否已经修正了,没有的话可以去 rails/rails 帮忙修正。记得有关文档的改动,在提交信息要加上 [ci skip]。
在给 rails/rails 提报或修正前,最好先阅读:Contributing to Ruby on Rails。
$ rake guides:deploy会把 ruby-china/guides/output/zh-CN/* 的静态文件,拷贝到 ruby-china/ruby-china.github.io。
PDF, MOBI, EPUB 格式
请支持安道所翻译的 Rails 指南。
简体译文由 @Andor_Chen 所翻译。
译文授权协议为 Creative Commons Attribution-ShareAlike 4.0 International License。
代码来自 rails/rails,采用相同的 MIT license 协议。