gitbook
简介
gitbook能够支持markdown和git的强大的电子书制作和生成工具。
本文介绍如何在windows下安装gitbook和转换成pdf文档。
windows
只需要准备下述3个软件包即可(点击名字即可下载)。nodejs,phantomjs,calibre。
安装nodejs
主要是为了安装其包管理工具npm
来下载gitbook
。而phantomjs
和calibre
是用于转换pdf文档用。
- 安装nodejs时请选择自动添加
环境变量
.- 请记得安装完成后将
phantomjs
和calibre
添加到系统环境变量
中。
安装gitbook
安装nodejs
后,在命令行
中输入:
npm install gitbook-cli -g
需要等待很长时间。。。
初始化gitbook
如何你需要自己新建一本book,请阅读本章节。如果你已从网上下载了gitbook,请阅读后续章节。
新建一个book的目录,并在命令行中输入下述命令:
gitbook init
并按照README.md和SUMMARY.md的方式,编写你自己的目录和正文内容。
运行gitbook
在书本的根目录路径下,在命令行中输入下述命令:
gitbook serve
然后就自动运行了js的web服务器,并可在下述本地地址
中阅读书籍:
http://127.0.0.1:4000/
静态gitbook
或者你可以使用下述命令,生成静态网页。
gitbook build
生成pdf
在书本的根目录路径下,在命令行中输入下述命令:
gitbook pdf
等待较长的时间后生成pdf。
参考
gitbook官方文档 from GitBook.com