多说无益,先来看看效果吧。下面是我去年写的一本小册子:跟我学企业敏捷开发 在PDF阅读器中的效果。注意还有完整的目录和页眉。
书的内容就全是用Markdown格式写的,上图相对应的文件内容(6.2节)片断如下。
## Cucumber 简介 ##Cucumber(英文:黄瓜)(官方网站是)是一个实例化需求的极佳实现伴侣。它是基于Ruby的开源测试工具,得益于Ruby便于创建和使用DSL的特性,它可以通过自然语言(文本文字)来描述需求(业务层),并通过关键字驱动和正则表达式匹配告诉去做哪些事情(驱动层),在运行自动化测试结束以后,还会给出详细的报告。Insert 18333fig0601.png图 6-1. Cucumber的架构下面就是一个加法例子的需求描述,Cucumber文件以.feature
结尾。 # 加法 adding.feature Feature: Adding In order to avoid silly mistakes As a math idiot I want to be told the sum of two numbers
下面就是书的全部Markdown文件,每一章一个文件。我把它们分成了序、前言、致谢、正文和附录,蛮像回事吧。有兴趣的朋友可以看看作译者手册,来了解标准的书是怎么组成的。
$ find zhzhzh/0prefacezh/0preface/00-chapter1-preface.Markdownzh/0preface/00-chapter2-changes.Markdownzh/0preface/00-chapter3-acknowledgement.Markdownzh/1chapterszh/1chapters/01-chapter1-agile-scrum.Markdownzh/1chapters/01-chapter2-git-gerrit.Markdownzh/1chapters/01-chapter3-ci.Markdownzh/1chapters/01-chapter4-java.Markdownzh/1chapters/01-chapter5-sbe.Markdownzh/1chapters/01-chapter6-cucumber.Markdownzh/1chapters/01-chapter7-workshop.Markdownzh/2appendixzh/2appendix/02-chapter1-sample.Markdownzh/2appendix/02-chapter2-cc2git.Markdown
全书的内容够可以在github上找到https://github.com/larrycai/sdcamp/tree/master/zh
样式的产生全部有模板完成,一般不需要改动,这个稍后讲。