mkbok 0.0.10 → 0.0.11

data/templates/zh/chapters/01-chapter4.markdown

@@ -0,0 +1,300 @@
+# 了解Latex的知识 #
+还没写完！！！
+
+Tex是由
+
+LaTeX（LATEX，音译“拉泰赫”）是一种基于TeX的排版系统，由美国计算机学家莱斯利·兰伯特（Leslie Lamport）在20世纪80年代初期开发，利用这种格式，即使使用者没有排版和程序设计的知识也可以充分发挥由TeX所提供的强大功能，能在几天，甚至几小时内生成很多具有书籍质量的印刷品。
+
+LaTeX使用TeX作为它的格式化引擎，当前的版本是LaTeX2e。
+
+如果需要高质量的书稿，Latex还是非常适合的，至少比Word上档次。这一章用简单的笔墨[^41]给一个简要介绍。
+
+XeTeX是一种使用Unicode的TeX排版引擎，并支持一些现代字体技术，例如OpenType。而且XeLaTeX语法与LaTeX相同，还提供了些增强功能，多数LaTeX文档不经修改就能直接用xelatex编译。XeTeX现在已经包含在TexLive发行包中。
+
+XeTex使用的是UTF-8，所以我们的文档不能存为GBK格式。
+
+XeTeX程序：TeX语言的新的实现，即把Tex语言转换为排版的一个新程序。支持Unicode 编码和直接访问操作系统字体。
+
+xetex命令：XeTeX程序中的命令，用来编译用Plain TeX格式写的tex文件。
+
+xelatex命令：XeTeX程序中的命令，用来编译用LaTeX格式写的tex文件。
+
+XeTeX 也是一种 “TeX”，因此它的文稿（源文件）也是一种结构化标记的纯文本文档，唯一区别是要求 XeTeX 文稿必须是 Unicode 编码的，最为常用的编码格式是 UTF-8 的。因此，要编辑 XeTeX，必须使用支持 UTF-8 编码的文本编辑器，这里推荐使用 Vim 或 Emacs，使用它们，即便是不安装与 TeX 编辑相关的扩展，也是很容易写 XeTeX 文档的。我的观点是，对于初学者，学习 TeX 之类的结构化标记文档时，一定要坚持手工键入那些标记，只有如此，方能记住常用的标记，待熟稔后，再寻找一些专门的编辑器来用。
+
+目前已经基于 XeTeX 实现了相应的 LaTeX，即 XeLaTeX。
+
+CTeX、CJK、xeCJK之类的不懂，你可以看看[LaTeX中文排版](http://linux-wiki.cn/wiki/LaTeX%E4%B8%AD%E6%96%87%E6%8E%92%E7%89%88%EF%BC%88%E4%BD%BF%E7%94%A8XeTeX%EF%BC%89)自行了解。
+
+<http://bbs.ctex.org/viewthread.php?tid=40232&extra=page%3D1&page=1>
+
+Latex编辑部：<http://zzg34b.w3.c361.com/index.htm> 
+
+你晕吗？我晕。如果你想对LaTeX了解的更多，建议看看参考资料。
+
+不过，你读完这一章已经够用了。
+
+## LATEX文稿基本格式 ##
+文稿(即用于排版的源文件)包含两部分内容:一部分是正文,也就是需要排版输出的内容;另一部分是排版控制命令,用于控制版面式样,字体,字形等格式.TEX文稿通常以 tex 为文件扩展名.
+
+排版控制命令是以反斜线"\"开头的字串。有一些排版控制命令带有一些参数,由参 数来修改其默认行为。
+排版控制命令的参数有些属于可省略的,有些属于不可省略的。在排版控制命令中,可省略的参数(若不提供这些参数, LaTeX 采用默认参数)置于方括号中,不 可省略的参数(必须要提供的参数)置于花括号中。具体格式可表示如下:
+
+~~~~~ {.latex}
+\命令名[可省略的参数]{不可省略的参数}
+~~~~~~
+
+XeTeX/Latex 的纯西文的文稿基本格式如下:
+
+~~~~~~~ {.latex}
+\documentclass[11pt,a4paper]{article}
+\begin{document} Hello World!
+\end{document}
+~~~~~~~~~~~~~
+
+上面的文稿中,排版控制命令 `\documentclass` 的可忽略参数告诉 LATEX 系统,用户使用的是 A4 纸( a4paper ),正文字体为 11pt ,接近中文五号字;不可忽略参数告诉 LaTeX ,用户要撰写一篇论文,这样 LeTEX 系统便会为用户准备好论文排版的默认环境。
+
+除了论文类别, LeTEX 还提供了书籍( book ),书信( letter ),报告( report )等。排版控制命令`\begin{document}` 与 `\end{document}` 表示文稿内容的起始与终止. 在 `\documentclass` 与 `\begin{document}` 之间的区域称为导言区（,可在此区域内放置一些可影响文档整体排版样式的控制命令。
+
+XETEX/LaTEX 的中文文稿与西文文稿没什么区别,仅仅是文稿内容中使用的是中文, 如下:
+
+~~~~~~~~~
+\begin{document}
+世界,你好!
+\end{document}
+~~~~~~~~~~
+
+## XETEX 中文文档处理 ##
+对 XETEX / LaTEX 可使用 xelatex 命令处理生成 pdf 文档:
+
+$ xelatex filename.tex
+
+现在,假定上一节中组为示例所列举的中文XETEX/LaTEX文稿的文件名为`example.tex`,使用 xelatex 命令处理该文稿可以生成 example.pdf 文档,但是使用 pdf 阅读 器打开 example.pdf ,就会发现这是一个空白文档,而没有如我们所预期的那样会在文档     中显示出"世界,你好!"这是因为 XETEX / LaTEX 并没有为中文文稿指定默认字体,这需要我们自行设定。
+这也意味着一个很重要的问题: XETEX项目解决了TEX国际化的问题, 而我们要解决 XETEX 本地化问题。但是目前,国内对 XETEX 很了解的人太少了,还未有人提出通用的XETEX中文解决方案,因此要使用 XETEX 排出符合中文习惯的文章,就需要熟悉一些 XETEX / LaTEX 宏包与排版控制命令。
+
+宏包fontspec可与XETEX/LaTEX 配合使用可实现在XETEX/LaTEX文稿中使用系统自带字体的功能.在 XETEX / LaTEX 文稿中的导言区,使用`\usepackage`指令可加载指定宏 包.加载 fontspec 宏包后,使用其提供的`\setmainfont` 命令可设定文稿正文中的中文字体。对上一节中的中文 XETEX/LaTEX 文稿 `example.tex` 修改如下:
+
+~~~~~~~~~~~~ 
+\documentclass[11pt,a4paper]{article}
+\usepackage{fontspec}
+\setmainfont{Adobe Song Std}
+\begin{document}
+世界,你好!
+\end{document}
+~~~~~~~~~~~~
+
+字体设置命令`\setmainfont`将 Adobe Song Std 指定为文档正文默认字体. Adobe Song Std 是 Adobe 发布 Adobe Reader 8.0 时附带的一款中文宋体,另外还有一款中文 黑体 Adobe HeiTi Std ,它们都是免费字体,可以自由使用.如果你没有装这两款字体, 可以使用 fc-list 命令查看系统已安装的字体名录,如下:
+
+~~~~~~~ {.bash}
+$ fc-list :lang=zh-cn
+文鼎PL简报宋,AR PL SungtiL GB:style=Regular
+文鼎PL中楷Uni,AR PL ZenKai Uni:style=Medium ... ...    
+~~~~~~~~~~
+ 
+将 fc-list 输出结果中的字体名填到`\setmainfont`命令中,即可使得 XETEX / LaTEX 在 系统字体目录下找到相应字体并将其嵌入到所生成的pdf文档中。虽然可以将Windows中文字体挪到 Linux 下使用,但是现在许多自由抑或免费的中文字体已经可以满足中文排版需要了,因此,我们应当尽量不要再去那些私权字体.
+
+现在,使用 xelatex 对修改后的 example.tex 进行处理,可以生成以中文五号宋体显示"世界,你好!"的单页 pdf 文档.
+    
+下面,继续进行中文字体的设置,对 example.tex 修改如下:
+
+~~~~~~~~~~~ {.latext}
+\documentclass[11pt,a4paper]{article}
+\usepackage{fontspec}
+\setmainfont[BoldFont=Adobe Heiti Std]{Adobe Song Std}
+\setsansfont[BoldFont=Adobe Heiti Std]{AR PL KaitiM GB}
+\setmonofont{Bitstream Vera Sans Mono}
+\begin{document}
+世界,你好!
+\end{document}
+~~~~~~~~~~~~~~~~
+
+在解释修改后的example.tex所发生的变化之前,我们应当了解一下有关字体的一些常识.
+西方国家的字母体系可分为两大字族( Font Family ): Serif 与 Sans Serif .除此 之外,还有一种打印机字体虽然也是 Sans Serif ,但由于它是等距字,所以又独立出一个Typewriter字族。Serif ,中文常译为"衬线", Sans Serif 则译为"无衬线"。
+衬线字体是源于古代 在一些岩石或金属上刻字时，雕刻刀在笔画的起落处要有入刀与退刀的讲究，不然会损伤刻刀。
+无衬线字体，是相对于衬线字体而言的。对于西文的衬线字体与无衬线字体的直观意象可见:
+
+N  N
+
+中文的字族可分为:隶、楷、行、宋、仿宋、黑、幼圆等,要与西文字族相对应(计算 机是西方文明的产物,汗),那么宋、仿宋都可以看作是衬线字体,而楷体、黑体、幼圆可以看作是非衬线字体.
+
+一旦理解了这些字体常识,对于 example.tex 中新增加的那几条设置中文字体的控制命令应该明白个三五分。
+譬如，`\setsansfont`指令是设定无衬线中文字体的，我们在`example.tex`中使用该指令将无衬线字体设置为楷体 AR PL KaitiM GB。
+`\setmainfont`是设置衬线字体的,因为 XETEX 将衬线字体视为文档默认字体族,而 XETEX 之所以如此, 是因为在实践有一个结论:衬线字体作为文章的正文字体可使读者长时间阅读文章视觉 不疲倦。
+非衬线字体在文章中适合作为标题出现,因为它较衬线字体更为醒目,但如果用 无衬线字体作为文章的正文字体,长时间阅读,很容易出现视觉疲劳. 
+fontspec 宏包还提供了一个与`\setmainfont` 等价的命令 `\setromanfont` ,这完全是出于历史的缘故, 因为 Roman 字体在西方一向被认识是文章正文字体的正统,最有名的是 Times New Roman .
+
+下面讲一下 `\setmainfont`与`\setsansfont`指令中的可省略参数BoldFont的用法, 这个参数是用来指定衬线与非衬线字体在粗体( bold )状态下所使用的字体,这是因为字体 可以在常态下经"加粗"后所得到的实际上是另一种字体。
+对于任意一款计算机字体而言, 它不是一个你想怎么变就可以怎么变的东西,如果一款字体在设计的时候就不是粗体,那 么是不可能把它变成粗体的,只有用一种设计好的粗体去替换。虽然有一些办法可以让一 些字体经过微量平移并叠合后可以得到类似"粗体"的效果,但那是"穷人的粗体",显示 效果很差的。所以,我们不应该把你正在用的这个"宋体"变成"粗"宋体,而必须去找专 门的粗宋体来用。如果找不到粗宋体,那就用黑体来代替,本文的排版就是这么做的,采用 Adobe Heiti Std 来作为衬线与非衬线的粗体. 字体设置完成后,就要考虑中文断行的问题。
+还是那句话, XETEX 只致力于解决国际 化问题,并不考虑本地化,如果说考虑了,那也只是默认考虑了西文本地化.西文的断行问 题是根据单词之间的空格来决定一行文本中在哪个单词的尾部断开产生新行的,对中文而 言,这种方法就不适用了,因为中文不是以空格来划分单词的.但不要以为 XETEX 不能很 好的处理中文断行,在 XETEX 内部已有人为中文断行写了一些规则,我们可以直接使用它们,可在 XETEX / LaTEX 的导言区中添加以下指令:
+
+~~~~~~~~~
+\XeTeXlinebreaklocale "zh"
+\XeTeXlinebreakskip = 0pt plus 1pt minus 0.1pt
+~~~~~~~~~
+
+上述指令中,`\XeTeXlinebreaklocale` 指定使用中文断行规则,XeTeXlinebreakskip 可以 让 XETEX 处理中文断行时多一点点自适应调整的空间.
+     
+Okay! 事实上,讲到这里,XETEX/LaTEX 的用法基本已讲述完毕, 剩下内容就是 TEX / LaTEX 的使用了,它们的许多教程都基本适用 XETEX / LaTEX。
+
+## 论文版式 ##
+一篇论文应该包括两个层次的含义:内容与表现,前者是指文章作者用来表达自己思想 的文字,图片,表格,公式及整个文章的章节段落结构等,后者则是指论文页面大小,边 距,各种字体,字号等.一篇排版良好的论文应当是内容与表现分离的.本节主要介绍如何使用 XETEX / LaTEX 定义论文的表现.
+
+### 准备纸张 ###
+首先准备纸张,在 `\documentclass` 的可省略参数中, A4 纸用 a4paper 表示, A5 纸 用 a5paper ,其他型号用纸的表示类推便是.如果在 `\documentclass` 指令中未指定纸张型号,则 XETEX / LaTEX 默认用纸是美国信纸(14 × 8.5in).
+
+纸张准备好了,然后就是设置基本字体尺寸.一般而言,中文小四号字用像素点为单 位表示为 12pt ,中文五号字表示为 11pt .基本字体尺寸的设定非常重要,譬如行距,段落缩进,页芯等参数, XETEX / LaTEX 会基于基本字体尺寸给出相应的默认值.基本字体 尺寸也是在`\documentclass` 指令中作为其可省略参数进行设定的,如果未设定该参数, 则 XETEX / LaTEX 会以 10pt 为默认值.
+
+现在,若要在一张 A4 纸上以 11pt 为基本字体尺寸写一篇论文, `\documentclass` 指令可写为:
+
+~~~~~~~~
+\documentclass[a4paper,11pt]{article}
+~~~~~~~~~
+
+XETEX / LaTEX 默认是纵向模式排版,要改为横向排版,可添加 `\documentclass` 命令 的可省略参数 landscape :
+
+~~~~~~~~~
+\documentclass[a4paper,11pt,landscape]{article}
+~~~~~~~~~~
+
+`\documentclass` 还有一些常用的可省略参数,比如 titlepage 可以让文章的标题 单独占据一页, notitlepage 可使标题与文章正文排在同一页面.又比如 draft 可以控制 XETEX / LaTEX 在超出页面宽度限制的文本行右端显示一个粗黑条,提醒用户注意,而 final 的作用恰好相反,无论文本行超出边界多少,也不显示粗黑条,但 XETEX / LaTEX 在 编译 TEX 文档时,会给出警告.
+
+### 设置页面边距 ###
+    下面谈谈页边距的设置. MS Word 默认的页面边距为:
+
+>上边距=下边距= 1in (2.54cm)
+>左边距=右边距= 1.25in (3.17cm)
+
+使用宏包 geometry 可以进行 XETEX / LaTEX 文稿的页面边距设置:
+
+~~~~~~~
+\usepackage[top=1in,bottom=1in,left=1.25in,right=1.25in]{geometry}
+~~~~~~~
+
+实际上这样设置的页面边距极不美观,尤其是左右对称的页边距没有考虑装订的需要, 另外上边距如果加上页眉或就显得过窄.因此,要是真的很注重页面美观的话还是自己去调 整一下,比如我喜欢将页边距设置下面这样:
+
+~~~~~~~~~~~~~~
+\usepackage[top=1.2in,bottom=1.2in,left=1.2in,right=1in]{geometry}
+~~~~~~~~~~~~~~
+
+将左边距设置的比右边距大一些,主要是考虑装订的需要,但是在实际打印时有单面打 印与双面打印模式,在双面打印时,应该是奇数页面的左边距比右边距大一些,在偶数页则相反. XETEX / LaTEX 考虑到了这一点,在偶数页面中会自动将左,右边距切换.指定文稿 单双页面的参数有 oneside 与 twoside ,它们都是 `\documentclass`的可省略参数,如果 文稿类别是论文,默认是单面打印模式.
+如果相对 geometry 宏包的使用进行更详细的了解,请参考文献
+
+### 章节标题 ###
+
+可使用 titlesec 宏包设置章节标题.在引入 titlesec 宏包时,可以指定一些格式选项, 比如:
+
+~~~~~~~~~
+\usepackage[center,pagestyles]{titlesec}
+~~~~~~~~~
+
+其中 center 可使标题居中,还可设为 raggedleft (居左,默认), raggedright (居 右). pagestyles 是申明后面要使用 titlesec 宏包自定义页面样式(在下一节会讲).
+
+标题由标签+标题内容构成,其格式通常在 XETEX / LaTEX 文稿的导言区中设置.要设 置论文中的节标题格式,可用 titleformat 指令,用法如下:
+
+~~~~~~~~~~~
+\titleformat{command}[shape]{format}{label}{sep}{before}[after]
+~~~~~~~~~~~~
+
+其中各参数含义如下:
+
+ * command 是要重新定义的各种标题命令,比如`\section`, `\subsection`,还有更 多的,在后文中讲书籍排版时再谈;
+ * shape 是用来设定段落形状的,可选的参数有hang , block , display 等,详 见 titlesec 文档,位于:
+$TEXLIVE/$VERSION/texmf-dist/doc/latex/titlesec 
+ * format 用于定义标题外观,比如使标题居中,字体加粗等;
+ * label 用于定义定义标题的标签,就是标题内容前面的标号;
+ * sep 定义标题的标签与标题内容之间的间隔距离;
+ * before 用于在标题内容前再加些内容;
+ * after 用于在标题内容后再加些内容;
+
+本文排版所用节标题分为两级,其格式采用以下命令设置:
+
+~~~~~~~~~~~~
+\titleformat{\section}{\centering\Large\bfseries}{\S\,\thesection}{1em}{}
+\titleformat{\subsection}{\large\bfseries}{\S\,\thesubsection}{1em}{}
+~~~~~~~~~~~~~
+
+其 中, shape , before , after 参 数 都 被 省 略 掉 了. format 参 数 将 section 格 式设置为居中( `\centering` ),字号为 `\Large` ,字体被加粗显示 `\bfseries` ;在设 置 subsection 格式,未采用居中,而是采用默认的居左,另外将标题的字号也降了一 级( `\large` ). label 参数将标题的标签设置为以"§"为前缀 + 标题序号. sep 参数设 置标签与标题内容之间以一个字(1em)的宽度为间隔.
+
+### 页眉与页脚 ###
+这一节讲怎样使用 titlesec 宏包设置页眉,页脚.下面的命令在 XETEX / LaTEX 导言区 定义了一个新的页面样式,并使用该样式:
+
+~~~~~~~~~~~
+\newpagestyle{main}{
+\sethead{\small\S\,\thesection\quad\sectiontitle}{}{$\cdot$~\thepage~$\cdot$}
+\setfoot{}{}{}\headrule}
+\pagestyle{main}
+~~~~~~~~~~~
+
+其中 `\sethead` 命令设置页眉,用法为:
+
+~~~~~~~~~
+\sethead[偶数页左页眉][偶数页中页眉][偶数页右页眉] {奇数页左页眉}{奇数页中页眉}{奇数页右页眉}
+~~~~~~~~~
+
+单面打印模式只要给出奇数页的设置即可,双面模式则需要将左,右页眉做个调换.上 面给出的例子是单面模式的. `\setfoot` 指令用法与 `\sethead` 用法相似.
+上面的页眉页脚设置示例中,`\headrule` 指令可画页眉线,默认宽度是 0.4pt,如果对该 宽度不满意,可使用下面命令重新设置其宽度:
+
+~~~~~~~~~~
+\setheadrule{宽度值}
+~~~~~~~~~~
+
+上面的页眉设置示例的排版效果即本文档页眉效果.
+
+## 如何安装字体 ##
+我用的试验环境是Ubuntu Oneiric (11.10），大部分可以直接从Ubuntu源中下载了。
+
+你可以用命令`fc-list :lang=zh-cn`查看安装好的中文字体，结果中前半部分就是字体名称（如`AR PL UMing CN`）。
+
+	user@puppet1:~$ fc-list :lang=zh-cn | grep CN
+	AR PL UMing CN:style=Light
+	AR PL UKai CN:style=Book
+
+文鼎开放的四套字体的Ubuntu包、字体名字和名称如下：
+
+	ttf-arphic-gbsn00lp      "AR PL SungtiL GB" 文鼎PL简报宋
+	ttf-arphic-gkai00mp      "AR PL KaitiM GB" 文鼎PL简中楷
+	ttf-arphic-ukai          "AR PL UKai" 文鼎PL中楷
+	ttf-arphic-uming         "AR PL UMing" 文鼎PL细上海宋
+
+文泉驿字体的Ubuntu包、字体名字和名称如下
+
+	ttf-wqy-microhei   "WenQuanYi Micro Hei" 文泉驿的微米黑
+	ttf-wqy-zenhei     "WenQuanYi Zen Hei" 文泉驿的正黑
+	xfonts-wqy         "WenQuanYi Bitmap Song" 文泉驿的点阵宋体
+	
+Adobe的中文字体有[官方下载](http://www.adobe.com/support/downloads/detail.jsp?ftpID=4421)
+
+	$ tar -jzxf FontPack910_chs_i486-linux.tar.bz2
+	$ tar -xvf CHSKIT/LANGCHS.TAR
+	$ mkdir ~/.fonts 
+	$ cp Adobe/Reader9/Resource/CIDFont/*.otf ~/.fonts
+	$ fc-cache -f -v
+	$ fc-list :lang=zh | grep Adobe
+
+## 蛋疼的问题 ##
+
+只可惜现在正文在产生PDF时没有一种字体是有完美表现的。
+
+  1. 文鼎贡献的字体中台湾字形的细上海宋的句号在中间，出来的效果不伦不类的。
+  2. 文鼎贡献的字体中大陆字形的简中楷和简报宋，标点符号的位置是对的，但是当碰到条目（Item）的时候条目的点没能显示出来。
+  3. Adobe的宋体，条目的时候显示一个田子框，很难看。
+  4. 文泉驿的点阵宋体老是转化Latex时出错，搞不定。
+  
+2、3 条目的问题，我hack成其他字符（*）显示就没问题了（如下），不知道缺省的圆点为啥显示不对。<http://wiki.ctex.org/index.php/LaTeX/%E5%88%97%E8%A1%A8>，现在就用文鼎的细上海宋了。
+	
+~~~~~~~~~~~~~~ {.latex}    
+	\begin{itemize}\setlength{\itemsep}{1pt}\setlength{\parskip}{0pt}\setlength{\parsep}{0pt}
+	\item[*]
+	% 原来是
+	% \item
+~~~~~~~~~~~~~~~~~~~~    
+ 
+## 参考 ##
+ 1. <http://share.chinatex.org/>
+ 2. <http://latex.yo2.cn/articles/latex-introduction0.html>
+ 3. LATEX2e完全学习手册：<http://product.china-pub.com/54569>
+ 4. XeTeX: <http://scripts.sil.org/xetex>
+ 
+ [^41]: 感谢lyanry写的“XETEX / LaTEX 中文排版之胡言乱语“，浅显易懂。
+ 
+
+ 

data/templates/zh/preface/01-chapter1.markdown

@@ -0,0 +1,36 @@
+# 前言 #
+
+互联网是自由、开放、分享、平等的世界。开源软件已经深入人心，并也形成了极好的商业模式。
+
+我们为什么不能把开源技术书做成像开源软件一样呢？
+
+这本小册子就用60页左右的内容把开源技术书的几个方面介绍一下，使得你也能写出你的开源技术书。
+
+### 背景 ###
+值得码字处。
+
+### 适合的对象 ###
+主要针对爱分享的技术爱好者，也适合编辑老师们了解Geek是怎么玩书的。
+
+## 本书结构 ##
+
+  * 第一章：前言
+  * 第二章：基础知识和10分钟写出第一本开源书
+  * 第三章：Markdown格式
+  * 第四章：Latex简介
+  * 第五章：其他。。
+
+### 封面 ###
+因为自己爱好设计排版，就自己DIY了一下，封面是随手找到的矢量卡通图，并用Windows PowerPoint制作完成。
+
+## 如何写作本书的 ##
+本书也是用敏捷的方式来写作的，我在Windows（希望早日能用MBA）用Notepad++编辑器用Markdown的文本文件写内容，然后在共享目录的虚拟机中，一个命令生成所有的其他格式（如PDF、mobi、epub）；Git是我使用的版本控制系统。
+
+本地测试通过后，我会提交到github中去，同时架设了持续集成服务器，会对我最新内容再次检测，自动产生电子书。
+
+这些你都可以在后面学到，啰嗦了。
+
+## 致谢 ##
+特别感谢...。
+
+感谢..对本书做了早期的审阅。

metadata

@@ -1,49 +1,99 @@
---- !ruby/object:Gem::Specification
+--- !ruby/object:Gem::Specification 
 name: mkbok
-version: !ruby/object:Gem::Version
-  version: 0.0.10
-  prerelease: 
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 11
+  version: 0.0.11
 platform: ruby
-authors:
+authors: 
 - Larry Cai
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-03-01 00:00:00.000000000 Z
-dependencies: []
+
+date: 2012-03-13 00:00:00 +08:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: aruba
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 4
+        - 6
+        version: 0.4.6
+  type: :development
+  version_requirements: *id001
 description: the ebook generate tools from markdown plain text
-email:
+email: 
 - larry.caiyu@gmail.com
-executables:
+executables: 
 - mkbok
 extensions: []
+
 extra_rdoc_files: []
-files:
+
+files: 
 - lib/mkbok_version.rb
 - bin/mkbok
-- README.md
+- templates/BUILD.md
+- templates/epub/book.css
+- templates/epub/metadata.xml
+- templates/figures/18333fig0201-tn.png
+- templates/figures-source/cover.bmml
+- templates/latex/config.yml
+- templates/latex/makepdf
+- templates/latex/README
+- templates/latex/template.tex
+- templates/Rakefile
+- templates/README.md
+- templates/summary.rb
+- templates/zh/appendix/02-chapter1.markdown
+- templates/zh/chapters/01-chapter2.markdown
+- templates/zh/chapters/01-chapter3.markdown
+- templates/zh/chapters/01-chapter4.markdown
+- templates/zh/preface/01-chapter1.markdown
+has_rdoc: true
 homepage: http://github.com/larrycai/mkbok
 licenses: []
+
 post_install_message: 
 rdoc_options: []
-require_paths:
+
+require_paths: 
 - lib
-required_ruby_version: !ruby/object:Gem::Requirement
+required_ruby_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
-      version: '0'
-required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
-  requirements:
-  - - ! '>='
-    - !ruby/object:Gem::Version
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 1
+      - 3
+      - 6
       version: 1.3.6
 requirements: []
+
 rubyforge_project: mkbok
-rubygems_version: 1.8.12
+rubygems_version: 1.3.7
 signing_key: 
 specification_version: 3
 summary: tools to generate ebooks from markdown
 test_files: []
+

data/README.md

@@ -1,24 +0,0 @@
-### Introduction 
-
-This is the tool `mkbok` to generate ebooks (.pdf,.epub,.mobi) from markdown plaintext files.
-
-It use pandoc and Latex technology
-
-### Getting started (TODO) 
-
-~~~~~~~~~~~ {.bash}
-$ gem install mkbok
-$ mkbok create sample --title "learn mkbok"
-$ mkbok build --local # needs pandoc,XeTex packages
-~~~~~~~~~~~~~
-
-If you already follow the mkbok configuration, then
-
-~~~~~~~~~~~ {.bash}
-$ mkbok init # add needed configuration for your existing markdown files
-$ mkbok build --web http://mkbok.com/diy # it will zip file and upload to web
-$ mkbok build --web http://mkbok.com/ --source http://github.com/larrycai/mkbok # generate pdf from github
-~~~~~~~~~~~~~~~~~
-
-### License
-