开源书和开源技术-Markdown篇
#开源书和开源技术-Markdown篇# #背景#
看到霍泰稳关于infoq的架构师电子书问题的微博和图灵社区的文章为什么写作自由书籍？，我就想通过一个用Markdown格式写的Pro Git开源书 的例子来介绍其中用到的技术。希望能借此机会推动国内电子书，特别是开源电子书的发展。
【声明】我并没有写书的经历，这里只是对电子书出版技术的入门介绍而已。
#从Pro Git说起#
如果你了解Git，或者想了解Git。那么你就应该知道Pro Git，它是Git的书中写得最好的一本（至少是之一），可是你是否知道它有网络中文版，而且能在iPad上极其漂亮得阅读。并且是免费的，不是盗版的免费！如果你想要最新的，你甚至可以自己生成它。哈哈，我就是这么干的。
这一切就归功于开源社区和它后面用到的技术。
#开源书# 这里我不用多讲，开源书就像其他的开源产品（如维基百科）一样，只要是开放的，社区就有人会贡献。Pro Git的作者Scott很慷慨得把书的内容全部共享在github/progit库中，使用得是CC BY-NC-SA 3.0。
Scott只负责英文版，其他许许多多语言的翻译都是社区贡献的，中国翻译相当有质量，你可以在线读Pro Git中文版。
#开源技术生成电子书# 这本书不仅仅开源了内容，使用的技术也是开源的。让我们看看他是怎么做的。
markdown原始文件
首先书的内容是用markdown格式写的。markdown格式的普及要归功于Github和StackOverflow。因为它们越来越流行，它们支持markdown格式也越来越流行。这里要赞一个的是，国内的图灵社区也支持markdown，用起来超级方便。
简单来说，markdown格式的文件看着像一般的文本文件，里面只是加了很少的格式标记，因此看文本文件也不影响理解，这种格式也有很多工具帮你去转化，而且很容自动化解决。并且这些技术大多数是开源或免费的。
你可以直接看一下【Pro Git】的“第一章 介绍” 的markdown原始文件，顺便看看github自动生成的简单“第一章 介绍” 的html。
产生电子书
epub/mobi格式
Ruby的rdiscount帮你从markdown转成html格式，然后有Calibre附带的命令ebook-convert生成最终的.mobi (Kindle) 和 .epub (iPad)。
###PDF格式### 为了能达到出版的质量，Latex是一个常用的格式，PDF也能很容易的产生出来，有关Latex，自己看看参考链接学习吧。
pandoc能帮着从markdown转换出latex格式，然后TexLive软件中的xelatex再转成PDF格式。
##试验环境## 你只需要一台Linux机器（虚拟机就可以了）和简单的Linux命令就可以试验了。有git和ruby的知识那就更方便了。
我用的试验环境是Ubuntu 11.04 (Natty)
###下载Pro Git开源书###
很简单，git clone一下就可以了，下载它的源文件包我觉得还是烦了点。
$ git clone https://github.com/progit/progit.git
###epub/mobi格式### 做电子书相对简单一点，因为要求没有PDF的高，calibre就可以满足了。
如果装的Ubuntu是服务器版的（没有X-Windows），建议安装xvfb无头(headless)X服务器，因为不知道什么原因有几个命令需要。XMing还不行，因为需要X-Input
$ sudo apt-get install ruby rubygems # ruby 1.8.7 is used
$ sudo apt-get install calibre # calibre 0.7.44 for ubuntu 11.04
$ gem install rdiscount ruby-debug
$ xvfb-run ./makeebooks zh # 缺省.mobi格式
$ export FORMAT=epub
$ xvfb-run ./makeebooks zh # .epub格式
###PDF格式### 生成PDF是一个比较复杂的东西，pandoc用Ubuntu库里的，TexLive建议下载最新的TexLive包安装，并配置到搜索路径中。
$ sudo apt-get install pandoc
$ # 安装texlive 2011
因为是中文PDF，需要把字体嵌入在文件中，因此需要安装字体文件（如果不是Ubuntu中文版）
$ sudo apt-get install language-support-fonts-zh-hans
现在你就可以生成pdf文件了。
$ ./makepdfs zh
其他常用的格式
计算机类图书对格式要求不是很多，图文、章节、源代码基本就够了，就算有些复杂公式，也可用图来显示。这也从理论上说明，它不需要复杂的格式。现在对这类技术书出版我的理解主要有几种：
- Microsoft的Word格式，虽然国内出版界如日中天，缺省就认它（对技术没追求，鄙视）。简单好学，但是不擅长自动化，是开源的死敌。
- Latex格式（就是Donald E. Knuth（高德纳）发明的，这是很棒的东西，特别适合学术类的各种复杂的公式等，不过学习曲线很高，国内也只有几家学术期刊使用。
- docbook格式是最有名的（从SGML演化过来？），Orielly和Pragmatic出版社缺省就用它，它能 很方便的转化出出版要的各种样式。如Jenkins - the definition guide开源书就是采用docbook。但由于是XML格式，很多人不习惯，而且多人网上协作不是很方便。
- 通过蒋鑫的Got Github开源书，我也了解reStructureText也是和markdown差不多纯文本（plain text)的，也是蛮流行的。
如果有机会，我再介绍一下docbook和reStructureText的相关技术。
#其他#
本文也是我用git记录在github上的，你可以看到每次的变化。
如果对此文有兴趣，帮忙顶一下，别忘了 @larrycaiyu。
Latex的参考
- http://share.chinatex.org/
- http://manual.calibre-ebook.com/conversion.html
- http://calibre-ebook.com/download_linux
- http://johnmacfarlane.net/pandoc/
- http://latex.yo2.cn/articles/latex-introduction0.html
- http://product.china-pub.com/54569