[工具使用] Mac 使用 GitBook 制作电子书
一、简介
很多时候我们看到好的 GitBook 资料,无法转换成文档本地浏览,十分的不方便。这时候就思考有没有工具能帮助我们完成这个操作。
二、安装
其实可以直接使用homebrew来安装,这里不做具体说明,命令如下:
brew cask install gitbook gitbook-editor
我采取的的方式是安装 gitbook-cli,具体方式如下:
npm i gitbook-cli -g
gitbook -V
因为gitbook基于node.js,所以需要先安装node, 我现在用的 gitbook 3.+,装node v12版本就好了:
# 可以先 brew search node 查看版本,然后安装你想要的版本
# 我现在用的 gitbook 3.+,装node v12版本就好了。
brew install node
查看版本,即安装是否成功:
node -v
npm -v
三、使用
新建文件夹test,作为一本书,并完成初始化:
mkdir test
cd test
# 初始化
gitbook init
生成两个文件
- README.md:书籍的介绍写在这个文件里
- SUMMARY.md:书籍的目录结构在这里配置
编辑这两个文件输入任意内容,目录格式举例:
编辑内容之后,回到终端,再次执行 gitbook init ,生成目录,如图:
然后我们就可以去制作了
四、常用命令
1. 初始化 或 编辑目录
gitbook init
2. 编辑内容之后编译书籍
可以指定目录,默认当前
gitbook build [书籍路径] [输出路径]
3. 生成电子书
# 生成 PDF 格式的电子书
gitbook pdf ./ ./book_name.pdf
# 生成 epub 格式的电子书
gitbook epub ./ ./book_name.epub
# 生成 mobi 格式的电子书
gitbook mobi ./ ./book_name.mobi
初次生成电子书的时候,可能会出现如下错误:
解决方式:根据提示通过安装calibre-ebook来安装ebook-convert:
下载地址:https://calibre-ebook.com/dist/osx
安装之后,建立软链
ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin/ebook-convert