• 欢迎访问极客公园网站,WordPress信息,WordPress教程,推荐使用最新版火狐浏览器和Chrome浏览器访问本网站,欢迎加入极客公园 QQ群
  • Git主题现已支持滚动公告栏功能,兼容其他浏览器,看到的就是咯,在后台最新消息那里用li标签添加即可。
  • 最新版Git主题已支持说说碎语功能,可像添加文章一样直接添加说说,新建说说页面即可,最后重新保存固定连接,演示地址
  • 百度口碑求点赞啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊啊http://koubei.baidu.com/s/gitcafe.net
  • 如果您觉得本站非常有看点,那么赶紧使用Ctrl+D 收藏极客公园吧

在Mac OS上安装Gitbook

未分类 Sun Yifeng 5年前 (2020-02-26) 362次浏览 1个评论

第一步:安装HomeBrew

第二步:安装Node.js
执行

brew install node

出现警告:

Warning: The post-install step did not complete successfully You can try again using 'brew postinstall node'

更改目录权限:

sudo chown -R $(whoami):admin /usr/local/lib/node_modules/

再执行:

brew postinstall node

查看版本,执行:

node -v

如果出现找不到文件目录的情况,执行:

brew link --overwrite node

到此,node安装完成:

//检查npm是否安装成功
npm -v
//检查node是否存在
node -v

第三步:安装Gitbook

sudo npm install -g gitbook-cli
//出现各种错误,无法继续

用cnpm试试:

npm install -g cnpm --registry=https://registry.npm.taobao.org
//安装淘宝的cnpm

之后安装gitbook-cli

sudo cnpm install -g gitbook-cli
//安装gitbook命令行工具
gitbook fetch
//安装最新gitbook
gitbook -V
gitbook --version
//查看版本

第四步:初始化一本书

mkdir mynewbook && cd mynewbook
//建立一个工作目录
gitbook init
//初始化,类似git init
ls
//你会发现README.md和SUMMARY.md已经被创建和初始化
gitbook serve
//启动预览,在浏览器输入localhost:4000 已经可以打开预览了
//预览完成后按CTRL+C退出预览

第五步:生成和转换电子书格式
1.在这里需要借助到一款叫做Calibre的软件,点击下载,我们这里选择Mac版下载。
2.下载后打开镜像并将软件拖进Applications文件夹,然后运行,跟着向导走一遍。此软件支持中文。
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
//这里的‘./’,是你电子书项目所在目录

现在,我们可以开始创作,并输出pdf & epub & mobi格式的电子书了。

 
第一次接触Node.js,安装的时候踩了不少坑,以上方法也是我从网上找来并且实测安装成功,故此分享,并对涉及作者予以感谢。
 

参考了以下链接:

https://blog.csdn.net/u014071426/article/details/91352878
https://blog.csdn.net/ys743276112/article/details/52125024


极客公园 , 版权所有丨如未注明 , 均为原创丨本网站采用BY-NC-SA协议进行授权
转载请注明原文链接:在Mac OS上安装Gitbook
喜欢 (0)
发表我的评论
取消评论

表情 贴图 加粗 删除线 居中 斜体 签到

Hi,您需要填写昵称和邮箱!

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址
(1)个小伙伴在吐槽
  1. 补充一下,使用 gitbook build 输出HTML格式于_book目录中
    Sun Yifeng2020-02-27 15:18 回复