### 翻译方法 1. 为了协同翻译或协同纠错，应将图书原稿纳入版本控制系统，我选择使用 [github](http://www.github.com) 。 有关 Github 的使用，请参考 [蒋鑫](http://www.worldhello.net/) 所著的开源书 [GotGitHub](http://www.worldhello.net/gotgithub/) 。 2. 显然将 PDF/Word 文档纳入 VCS 的意义不大，为了便于协同工作，应选用一种标记语言书写图书或译作的源码，之后生成 HTML/PDF 文档。 我选择使用 [AsciiDoc](http://www.methods.co.nz/asciidoc/) ，它是一款优秀的基于标记语言的技术文档写作和翻译工具。 为此，我首先将原书的 PDF 文档手工转化成了 AsciiDoc 格式。 3. AsciiDoc 支持 [GNU source-highlight](http://www.gnu.org/software/src-highlite/) 和 [Pygments](http://pygments.org/) 两种代码加亮系统。 由于当前只有 Pygments 支持 *.pp 代码加亮， 所以我选择使用基于 Pygments 的 [puppet-pygments-lexer](http://github.com/rodjek/puppet-pygments-lexer) 对翻译版进行代码加亮处理。 4. 作为一个翻译图书案例，本书所有的翻译工作都是我一个人做的。若要多人协同工作可以采用如下方式： * 若要协同翻译，可以开启 Github 中图书翻译项目仓库的 Wiki，进行翻译章节的认领和进度规划等工作。 * 参考： [使用 Github Wiki](http://www.worldhello.net/gotgithub/04-work-with-others/060-wiki.html) * 参考： [Dive into Python 翻译项目](http://wiki.woodpecker.org.cn/moin/DiveIntoPythonZh) 的 Wiki 组织形式 * 翻译成员可以在 Github 上克隆核心成员的仓库，在自己的仓库中翻译，之后提交到核心成员的仓库。 * 参考： [Fork + Pull模式](http://www.worldhello.net/gotgithub/04-work-with-others/010-fork-and-pull.html) * 审校者也可用上述方式提交修改，还可以用 [缺陷跟踪](http://www.worldhello.net/gotgithub/04-work-with-others/050-issue.html) 方式提交修改意见 5. 使用 asciidoc 或 a2x 生成 HTML/PDF/epub 等版本。 >  Git and Github Useful Links > * Git > * [git - 简易指南](http://rogerdudler.github.com/git-guide/index.zh.html) > * [Why Git is Better than X](http://zh-cn.whygitisbetterthanx.com/) > * [Git Magic](http://www-cs-students.stanford.edu/~blynn/gitmagic/intl/zh_cn/) > * [git ready](http://gitready.com/) > * [Git: Everyday Stuff](http://www.javahotchocolate.com/tutorials/git-everyday.html) > * [Everyday GIT With 20 Commands Or So](http://schacon.github.com/git/everyday.html) > * [Pro Git](http://progit.org/) > * [参与 Git 的中文本地化](http://www.worldhello.net/2012/02/28/git-l10n.html) > * Github > * [GotGitHub](http://www.worldhello.net/gotgithub/) > * [如何高效利用 GitHub](http://www.yangzhiping.com/tech/github.html) > * [The GitHub Help](http://help.github.com/)