Mac环境安装Gitbook,并导出PDF教程

在经过了长时间的折腾之后,终于在Mac环境成功的安装了Gitbook。

安装Gitbook的主要流程如下:

安装node.js>安装Gitbook>安装Gitbook编辑器>安装calibre>导出PDF。

1. 安装node.js

安装node.js,在node.js官网下载,直接安装。

下载地址:https://nodejs.org/en/

这里需要注意的是,node.js有两个版本,一个是大多数人使用的,也就是稳定版;另一个是最新版,拥有最新的特性。在这里,我们下载稳定版即可。

安装成功之后输入node -v,显示node.js版本代表安装成功。

huixingdeMacBook-Air:~ huixing$ node -v
v6.10.2

2. 安装Gitbook

这个点是最坑的。尤其是在Mac环境下,我先后尝试了以下代码:

npm install gitbook -g
npm install -g gitbook-cli

还有好几个,先说明下,以上代码都是错误的,不是卡主了就是不能动。原来,Mac环境下需要用到sudo这个指令。

sudo npm install gitbook-cli -g

一定要用到-g,这个代表全局安装,我去掉-g安装了一次,也成功了,但是在终端使用gitbook -V查看的时候发现根本没安装,这是我遇到的坑最多的地方。

在终端输入gitbook -V之后即可查看当前Gitbook版本,代表安装成功。需要注意的是“V”一定要大写。

huixingdeMacBook-Air:~ huixing$ gitbook -V
CLI version: 2.3.0
GitBook version: 3.2.2

3. 安装Gitbook编辑器

接下来就是安装Gitbook桌面编辑器了。有的人可能会问,你都已经安装了终端环境下的Gitbook了,为什么还要安装桌面端呢?

下载地址:https://www.gitbook.com/editor/(已不可用)
新下载地址(2018-11-30更新):https://legacy.gitbook.com/editor/osx

其实,使用Gitbook桌面编辑器能够很方便的进行文章书写,终端环境下的Gitbook只是为了生成HTML文档与PDF文档而使用的。

安装了Gitbook桌面端之后,你可以在客户端中新建一本书籍。然后用终端生成HTML。

使用gitbook build命令。

huixingdeMacBook-Air:import huixing$ cd jianli
huixingdeMacBook-Air:jianli huixing$ gitbook build
info: 7 plugins are installed 
info: 6 explicitly listed 
info: loading plugin "highlight"... OK 
info: loading plugin "search"... OK 
info: loading plugin "lunr"... OK 
info: loading plugin "sharing"... OK 
info: loading plugin "fontsettings"... OK 
info: loading plugin "theme-default"... OK 
info: found 1 pages 
info: found 7 asset files 
info: >> generation finished with success in 1.0s ! 
huixingdeMacBook-Air:jianli huixing$ 

看到success的提示没,这个时候系统文件根目录下就生成了一个_book的文件夹。打开就是该书籍的HTML格式了。

你也可以直接将该书籍在本地预览。

使用gitbook serve命令

huixingdeMacBook-Air:jianli huixing$ gitbook serve
Live reload server started on port: 35729
Press CTRL+C to quit ...

info: 7 plugins are installed 
info: loading plugin "livereload"... OK 
info: loading plugin "highlight"... OK 
info: loading plugin "search"... OK 
info: loading plugin "lunr"... OK 
info: loading plugin "sharing"... OK 
info: loading plugin "fontsettings"... OK 
info: loading plugin "theme-default"... OK 
info: found 1 pages 
info: found 7 asset files 
info: >> generation finished with success in 1.2s ! 

Starting server ...
Serving book on http://localhost:4000

Gitbook编辑器需要同终端里安装的Gitbook配合,完美实现在线HTML的生成,PDF的生成。当然,如果愿意将文档公开到gitbook或者gitbub仓库的看到这里就可以了,因为Gitbook网站上可以直接导出PDF,MOBI,EBUP等电子书格式。如果不想将书籍公开,那么可以往下面继续看了!

4. 安装calibre插件

玩过kindle的都知道,calibre是一款非常方便的开源电子书转换软件。在这里,我们也是用到ebook-convert这个插件。

首先在calibre官网下载插件,下载链接:https://calibre-ebook.com/download。下载适合自己系统的版本。

下载到电脑之后我做了很多尝试,刚下载之后我兴冲冲的去使用gitbook pdf . mypdf.pdf指令,结果发现提示ebook-convert未安装。

这里我通过咨询了一些大神,在这个过程中他们给了我很大的帮助。也查看了很多教程,所有教程中都说了两个问题。

  • 将安装的calibre放在系统应用中,然后将app添加到path中。

    这个说实话我也没怎么看懂,但是下面我会详细的说这一步如何操作。

  • 执行一个命令sudo ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin

以上两部我都做了,最终也成功的将Gitbook导出了PDF,但具体是哪一步起了作用,我估计是第二步,不过在教程中我优先推荐使用第二步。第二步遇到的坑是,在网上我们找到的教程只是输入ln -s /Applications/calibre.app/Contents/MacOS/ebook-convert /usr/local/bin,但是执行多次都没有结果,WIN系统执行这步可能已经正确了。因为Mac环境权限的原因,这里加入sudo重新执行即可。

执行完成之后,重新进入书籍目录。

huixingdeMacBook-Air:import huixing$ cd jianli
huixingdeMacBook-Air:jianli huixing$ gitbook pdf . jianli.pdf
info: 7 plugins are installed 
info: 6 explicitly listed 
info: loading plugin "highlight"... OK 
info: loading plugin "search"... OK 
info: loading plugin "lunr"... OK 
info: loading plugin "sharing"... OK 
info: loading plugin "fontsettings"... OK 
info: loading plugin "theme-default"... OK 
info: found 1 pages 
info: found 7 asset files 
info: >> generation finished with success in 7.5s ! 
info: >> 1 file(s) generated 

执行完以上代码,进入书籍目录,即可看到已经转换完成的PDF了。大功告成!

特别感谢:Dandy,烟头γ两位大神的指导。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 194,088评论 5 459
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 81,715评论 2 371
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 141,361评论 0 319
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 52,099评论 1 263
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 60,987评论 4 355
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 46,063评论 1 272
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 36,486评论 3 381
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 35,175评论 0 253
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 39,440评论 1 290
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 34,518评论 2 309
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 36,305评论 1 326
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 32,190评论 3 312
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 37,550评论 3 298
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 28,880评论 0 17
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,152评论 1 250
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 41,451评论 2 341
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 40,637评论 2 335

推荐阅读更多精彩内容

  • 本文详细讲解了 Gitbook 生成电子书的完整过程,内容包括:安装、命令、配置、文档结构、生成电子书、部署。限于...
    静默虚空阅读 11,207评论 9 138
  • 简介 GitBook 是一个基于 Node.js 的命令行工具,可使用 Github/Git 和 Markdown...
    艾醒智阅读 1,246评论 0 5
  • WebSocket-Swift Starscream的使用 WebSocket 是 HTML5 一种新的协议。它实...
    香橙柚子阅读 23,552评论 8 183
  • 雪中看海,多年来的一个夙愿。 那是偶然的一天,几人一拍即合跑去海边,便临时决定住了下来。 早晨,推窗看海。窗外茫茫...
    菱然阅读 811评论 0 0