Gitbook 入门教程
gitbook 介绍
GitBook 是一个基于 Node.js 的命令行工具,可使用 Github/Git 和 Markdown 来制作精美的电子书。使用gitbook生成的电子书还可以直接上传到gitbook.com
gitbook.com使用
gitbook.com的使用很简单,这篇文章介绍的很详细,直接看吧,我就不复制了。
需要说明的有两个:
一个是gitbook默认没有开启生成pdf,epub等的选线,需要在设置中手动开启。
另外一个就是最主要的两个文件是readme.md
和 summary.md
readme.md
可以理解为是封面,主要是图书介绍之类的内容
summary.md
就是目录了,基于nodejs的gitbook命令会根据summary来生成文件。
nodejs 的gitbook使用
GitBook支持输出以下几种文档格式:
- 静态站点:GitBook默认输出该种格式
- PDF:需要安装gitbook-pdf依赖
- eBook:需要安装ebook-convert
全局安装
|
|
初始化项目
|
|
这里会直接生成 readme.md
和 summary.md
如果要根据文件自动生成summary 需要安装 gitbook-summary
|
|
这样就会根据目录里面的内容自动生成summary.md
发布
|
|
问题
如果在生成 pdf,epub或者mobi文件时产生错误 类似ebook-convert的,说明电脑里面没有安装Calibre 去官网下载后直接安装就可以了
我的图书
第一本书 中英双语NIV版圣经 欢迎star