诗与远方

gitbook的使用

gitbook是一个用于发布个人书籍的平台,类似于国外著名的LeanPub. 其中一个很大的特点是它利用git作为版本管理和发布工具, 加上是在线形式,你可以很方便的进行作为的快速更新.

gitbook提供了一个简单的命令行工具gitbook用来编译和预览的书籍.再加上ebook-convert插件,就可以很方便地生成kindle支持的mobi电子书格式。在kindle上阅读,体验非常不错。

安装

你可以直接通过npm安装gitbook到全局

1
2
3
4
npm install -g gitbook
npm install -g gitbook-cli
//安装ebook-convert,用于编译输出mobi等格式的电子书.
sudo -v && wget -nv -O- https://download.calibre-ebook.com/linux-installer.py | sudo python -c "import sys; main=lambda:sys.stderr.write('Download failed\n'); exec(sys.stdin.read()); main()"

命令

gitbook只提供了如下四个命令

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
$ gitbook -h
Usage: gitbook [options] [command]
Commands:
build [options] [source_dir] #编译指定目录,输出Web格式(_book文件夹中)
serve [options] [source_dir] #监听文件变化并编译指定目录,同时会创建一个服务器用于预览Web
pdf [options] [source_dir] #编译指定目录,输出PDF
epub [options] [source_dir] #编译指定目录,输出epub
mobi [options] [source_dir] #编译指定目录,输出mobi
init [source_dir] #通过SUMMARY.md生成作品目录
Options:
-h, --help output usage information
-V, --version output the version number

使用

从git上clone下来的电子书
先运行git build进行编译生成指定的目录,然后可以git serve运行服务器查看.