在自己的电脑上安装 GitBook For Mac

剪不断的情缘

之前写了一篇 在自己的服务器上安装GitBook ,发布于 2015-04-20,当时的安装环境是 CentOS 6.X_64Bit,今天想再研究一下这个 GitBook ,发现在基于 Linux 内核的机器上安装基础功能很简单,但是牵涉到生成 pdf/epub/mobi 格式的书籍时,安装calibre的代价非常大(因为要安装 N 多前置库),对于不是非常非常熟练使用 Linux 的用户,几乎是一种灾难。

然而,对于 OS XWindows 用户,则相对容易很多(Windows环境未测试),安装相应的 calibre 的客户端即可解决格式转换的问题。

只讲重点 (゜-゜)

前提条件这里一笔带过(在 Mac 上进行):

  1. 安装 nvm
  2. 使用 nvm 安装 Node.js ,我安装了 v5.0.0 版本的;
  3. 使用 npm 安装 gitbook ,不会的看 这里
  4. 安装 calibre 的客户端==>重点在此步;
  5. 执行生成命令:生成指定格式的文件。

画重点啦 (´−`) ンー 咳咳,看黑板

1.下载对应的 Calibre 文件,下载地址在此 ,Mac 用户自然是下载 OS X 版本的了;
2.下载安装 Calibre ,然后务必打开运行一次 Calibre ,否则就嘿嘿嘿了;
3.在终端里执行

1
2
3
4
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.转换格式,参考官方文档

1
2
3
4
5
6
7
8
# 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:

你可以通过 GithubCSDN微博 与我联系