第一步:安装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
补充一下,使用 gitbook build 输出HTML格式于_book目录中