安装
GitBook 是一个基于 Node.js 的命令行工具,安装Node.js
sudo apt install nodejs
查看版本
node -v
安装npm,(说实话还是没搞懂这是啥。不过感觉像是一个安装工具)
sudo apt install npm
出现错误,错误是缺少依赖包,
Reading package lists... Done
Building dependency tree
Reading state information... Done
Some packages could not be installed. This may mean that you have
requested an impossible situation or if you are using the unstable
distribution that some required packages have not yet been created
or been moved out of Incoming.
The following information may help to resolve the situation:
The following packages have unmet dependencies:
npm : Depends: node-gyp (>= 0.10.9) but it is not going to be installed
E: Unable to correct problems, you have held broken packages.
按照提示安装依赖包即可,当时就装了这几个依赖
sudo apt-get install nodejs-dev node-gyp libssl1.0-dev
安装Gitbook
sudo npm install gitbook-cli -g
记得加sudo
,没加会出错
好啦,安装到此结束。接下来该使用啦!
首先建立一个文件夹,然后初始化
mkdir book
cd ~/book
gitbook init
可以看到文件夹下创建了 README.md 和 SUMMARY.md 这两个文件,README.md 是说明文档,而 SUMMARY.md是书的章节目录。
将之前写好的××.md文档放置book目录下,再在SUMMARY.md文件中添加相应的目录,二级目录用TAB缩进。或者没有文件时直接在SUMMARY.md中添加相应的目录,在book目录下会创建相应的××.md文件。
执行
gitbook serve
通过 http://localhost:4000 预览电子书内容,预览完毕后按 Ctrl + C 结束。
gitbook build
这一句是构建书籍的意思,包含在gitbook serve
中了。
生成PDF格式文件
gitbook pdf ./ ./mybook.pdf
生成 epub 格式文件
gitbook epub ./ ./mybook.epub
生成mobi 格式文件
gitbook mobi ./ ./mybook.mobi
报错说缺少 ebook-convert,根据提示安装即可。
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的基本目录结构
.
├── book.json
├── README.md
├── SUMMARY.md
├── chapter-1/
| ├── README.md
| └── something.md
└── chapter-2/
├── README.md
└── something.md
book.json:该文件主要用来存放配置信息