一、GitBook介绍
GitBook是一个命令行工具(node.js库), 使用Github/Git创建漂亮的图书。 你可以看一些用它编写的图书的例子: 高效使用 Mac OS X. 你也可以很容易的通过GitBook.io网站发布在线图书。完整的文档可以在help.gitbook.com网站找到.
输出格式
GitBook可以产生下列类型的图书:
- 静态站点:默认格式。创建一个完全交互式的静态网站,可以发布到GitHub Pages等网站。
- eBook:图书完成后可以使用它创建电子书,输出格式可以是 PDF, ePub 或 MOBI。
图书结构
一本图书就是一个Git仓库, 至少包含两个文件: README.md
和 SUMMARY.md
。
README.md 是你图书的简介,它可以被自动地加入到最终的 summary 之中
SUMMARY.md 定义了图书的目录。它应该包含章节的列表,以及它们的链接。
例如:
SUMMARY.md
# Summary
This is the summary of my book.
* [section 1](section1/README.md)
* [example 1](section1/example1.md)
* [example 2](section1/example2.md)
* [section 2](section2/README.md)
* [example 1](section2/example1.md)
不被 SUMMARY.md
包含的文件不会被 GitBook
处理.