如果移动端访问不佳,请尝试 ==> Github 版
剪不断的情缘
之前写了一篇 在自己的服务器上安装GitBook ,发布于 2015-04-20,当时的安装环境是 CentOS 6.X_64Bit
,今天想再研究一下这个 GitBook
,发现在基于 Linux
内核的机器上安装基础功能很简单,但是牵涉到生成 pdf/epub/mobi
格式的书籍时,安装calibre的代价非常大(因为要安装 N 多前置库),对于不是非常非常熟练使用 Linux
的用户,几乎是一种灾难。
然而,对于 OSX
和 Windows
用户,则相对容易很多(Windows环境未测试),安装相应的 calibre
的客户端即可解决格式转换的问题。
只讲重点 (゜-゜)
前提条件这里一笔带过(在 Mac 上进行):
- 安装
nvm
; - 使用
nvm
安装Node.js
,我安装了v5.0.0
版本的; - 使用
npm
安装gitbook
,不会的看 这里; - 安装
calibre
的客户端==>重点在此步; - 执行生成命令:生成指定格式的文件。
画重点啦 (´−`) ンー 咳咳,看黑板
1.下载对应的 Calibre
文件,下载地址在此 ,Mac 用户自然是下载 OSX
版本的了;
2.下载安装 Calibre
,然后务必打开运行一次 Calibre
,否则就嘿嘿嘿了;
3.在终端里执行
sudo ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin
//官方的文档里是如下命令:会引起权限和命令无效等问题
sudo ln -s ~/Applications/calibre.app/Contents/MacOS/ebook-convert /usr/bin
4.转换格式,参考官方文档
# Generate a PDF file
$ gitbook pdf ./ ./mybook.pdf
# Generate an ePub file
$ gitbook epub ./ ./mybook.epub
# Generate a Mobi file
$ gitbook mobi ./ ./mybook.mobi
总结
不管怎么说,终于还是实现了 GitBook
在 Mac 上的完美运行。在有生成 pdf/epub/mobi
格式的文件的需求时,就不心虚了。
最近在阅读的比较火的一个项目 LearningNotes ,是一个 Android 知识点笔记和面试题的一个总结,我用 GitBook
生成了一份 HTML 版,点击这里访问,我还打算和作者联系一下,帮他生成 pdf/epub/mobi
格式,方便本地阅读。
PS: