在Mac OS上安装Gitbook

折腾 SunYF 2年前 (2020-05-28) 1074次浏览 已收录 0个评论 扫描二维码

第一步:安装HomeBrew

第二步:安装Node.js
执行

brew install node

出现警告:

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

在Mac OS上安装Gitbook

更改目录权限:

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

在Mac OS上安装Gitbook

之后安装gitbook-cli

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

第四步:初始化一本书

在Mac OS上安装Gitbook

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
//这里的‘./’,是你电子书项目所在目录

在Mac OS上安装Gitbook

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

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

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

补充一下,使用 gitbook build 输出HTML格式于_book目录中


孙艺峰的日志 , 版权所有丨如未注明 , 均为原创丨本网站采用BY-NC-SA协议进行授权
转载请注明原文链接:在Mac OS上安装Gitbook
喜欢 (2)
[13917237775@qq.com]
分享 (0)
关于作者:
Nothing to say
发表我的评论
取消评论

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

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

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址