在经过了长时间的折腾之后,终于在Mac环境成功的安装了Gitbook。
安装Gitbook的主要流程如下:
安装node.js>安装Gitbook>安装Gitbook编辑器>安装calibre>导出PDF。
安装node.js,在node.js官网下载,直接安装。
下载地址:https://nodejs.org/en/。
这里需要注意的是,node.js有两个版本,一个是大多数人使用的,也就是稳定版;另一个是最新版,拥有最新的特性。在这里,我们下载稳定版即可。
安装成功之后输入node -v
,显示node.js版本代表安装成功。
huixingdeMacBook-Air:~ huixing$ node -v
v6.10.2
这个点是最坑的。尤其是在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
接下来就是安装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等电子书格式。如果不想将书籍公开,那么可以往下面继续看了!
玩过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,烟头γ两位大神的指导。
原网址: 访问
创建于: 2021-09-13 12:38:31
目录: default
标签: 无
未标明原创文章均为采集,版权归作者所有,转载无需和我联系,请注明原出处,南摩阿彌陀佛,知识,不只知道,要得到
java windows火焰图_mob64ca12ec8020的技术博客_51CTO博客 - 在windows下不可行,不知道作者是怎样搞的 监听SpringBoot 服务启动成功事件并打印信息_监听springboot启动完毕-CSDN博客 SpringBoot中就绪探针和存活探针_management.endpoint.health.probes.enabled-CSDN博客 u2u转换板 - 嘉立创EDA开源硬件平台 Spring Boot 项目的轻量级 HTTP 客户端 retrofit 框架,快来试试它!_Java精选-CSDN博客 手把手教你打造一套最牛的知识笔记管理系统! - 知乎 - 想法有重合-理论可参考 安宇雨 闲鱼 机械键盘 客制化 开贴记录 文本 linux 使用find命令查找包含某字符串的文件_beijihukk的博客-CSDN博客_find 查找字符串 ---- mac 也适用 安宇雨 打字音 记录集合 B站 bilibili 自行搭建 开坑 真正的客制化 安宇雨 黑苹果开坑 查找工具包maven pom 引用地 工具网站 Dantelis 介绍的玩轴入坑攻略 --- 关于轴的一些说法 --- 非官方 ---- 心得而已 --- 长期开坑更新 [本人问题][新开坑位]关于自动化测试的工具与平台应用 机械键盘 开团 网站记录 -- 能做一个收集的程序就好了 不过现在没时间 -- 信息大多是在群里发的 - 你要让垃圾佬 都去一个地方看难度也是很大的 精神支柱 [超级前台]sprinbboot maven superdesk-app 记录 [信息有用] [环境准备] [基本完成] [sebp/elk] 给已创建的Docker容器增加新的端口映射 - qq_30599553的博客 - CSDN博客 [正在研究] Elasticsearch, Logstash, Kibana (ELK) Docker image documentation elasticsearch centos 安装记录 及 启动手记 正式服务器 39 elasticsearch 问题合集 不断更新 6.1.1 | 6.5.1 两个版本 博客程序 - 测试 - bug记录 等等问题 laravel的启动过程解析 - lpfuture - 博客园 OAuth2 Server PHP 用 Laravel 搭建带 OAuth2 验证的 RESTful 服务 | Laravel China 社区 - 高品质的 Laravel 和 PHP 开发者社区 利用Laravel 搭建oauth2 API接口 附 Unauthenticated 解决办法 - 煮茶的博客 - SegmentFault 思否 使用 OAuth2-Server-php 搭建 OAuth2 Server - 午时的海 - 博客园 基于PHP构建OAuth 2.0 服务端 认证平台 - Endv - 博客园 Laravel 的 Artisan 命令行工具 Laravel 的文件系统和云存储功能集成 浅谈Chromium中的设计模式--终--Observer模式 浅谈Chromium中的设计模式--二--pre/post和Delegate模式 浅谈Chromium中的设计模式--一--Chromium中模块分层和进程模型 DeepMind 4 Hacking Yourself README.md update 20211011
Laravel China 简书 知乎 博客园 CSDN博客 开源中国 Go Further Ryan是菜鸟 | LNMP技术栈笔记 云栖社区-阿里云 Netflix技术博客 Techie Delight Linkedin技术博客 Dropbox技术博客 Facebook技术博客 淘宝中间件团队 美团技术博客 360技术博客 古巷博客 - 一个专注于分享的不正常博客 软件测试知识传播 - 测试窝 有赞技术团队 阮一峰 语雀 静觅丨崔庆才的个人博客 软件测试从业者综合能力提升 - isTester IBM Java 开发 使用开放 Java 生态系统开发现代应用程序 pengdai 一个强大的博主 HTML5资源教程 | 分享HTML5开发资源和开发教程 蘑菇博客 - 专注于技术分享的博客平台 个人博客-leapMie 流星007 CSDN博客 - 舍其小伙伴 稀土掘金 Go 技术论坛 | Golang / Go 语言中国知识社区
最新评论