mac安装部署gitbook教程

mac安装部署gitbook教程

前言

一些自己实际操作的记录。

一、安装准备

  1. Node.js
    gitbook基于Node.js,所以需要提前安装。
    下载地址:https://nodejs.org/en/,可以下载比较新的版本。(但我的建议是不要安装太高的版本,容易走很多弯路,笔者使用的是10.16.3,后文中提供网盘下载)

    建议下载LTS版本(Long Term Support)。
    同时也可以网盘下载(这里的版本为10.16.3 LTS):
    链接: https://pan.baidu.com/s/1JZLRn5EhICmsn-pLm-6Z_g 提取码: 4grf
    双击打开后,一直点「继续」即可。
    安装完成后:使用node -v可以查看版本号。

二、GitBook安装

运行命令:

bash 复制代码
sudo npm install -g gitbook-cli

建议科学上网,速度比较快,不懂怎么科学上网的朋友们可以私聊我,我可以教学。

运行命令查看是否安装成功:
sudo gitbook -V

但出现报错:(主要是因为Node.js版本较高,可以尝试降低版本,推荐10.x.x)
但无需担心,只需要修改对应的内容就好:

首先进入到报错的文件中:

复制代码
sudo vi /usr/local/lib/node_modules/gitbook-cli/node_modules/npm/node_modules/graceful-fs/polyfills.js

找到下面这三行,注释掉。具体可以参考:https://flaviocopes.com/cb-apply-not-a-function/

重新运行sudo gitbook -V,低版本应该会比较顺利,控制台输出以下内容:

bash 复制代码
CLI version: 2.3.2
Installing GitBook 3.2.3
[email protected] ../../../../../../../../../var/folders/kj/qbpckysx1_924y0nhd59nd5r0000gn/T/tmp-16645XKlrWUKvHqkG/node_modules/gitbook
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected]
├── [email protected] ([email protected])
├── [email protected]
├── [email protected]
├── [email protected] ([email protected])
├── [email protected] ([email protected], [email protected])
├── [email protected]
├── [email protected] ([email protected])
├── [email protected] ([email protected], [email protected])
├── [email protected] ([email protected])
├── [email protected] ([email protected])
├── [email protected] ([email protected], [email protected])
├── [email protected] ([email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected])
├── [email protected] ([email protected], [email protected])
├── [email protected] ([email protected])
├── [email protected] ([email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected])
├── [email protected] ([email protected], [email protected])
├── [email protected] ([email protected])
├── [email protected] ([email protected], [email protected], [email protected], [email protected], [email protected])
├── [email protected] ([email protected])
├── [email protected] ([email protected], [email protected], [email protected], [email protected], [email protected], [email protected])
├── [email protected] ([email protected], [email protected], [email protected], [email protected])
├── [email protected] ([email protected], [email protected], [email protected])
├── [email protected] ([email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected])
├── [email protected] ([email protected], [email protected], [email protected], [email protected], [email protected])
├── [email protected]
├── [email protected] ([email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected])
├── [email protected] ([email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected], [email protected])
└── [email protected] ([email protected], [email protected], [email protected])
GitBook version: 3.2.3

再运行:sudo gitbook -V,应该就显示正常的版本号了:

复制代码
LI version: 2.3.2
GitBook version: 3.2.3

现在开始可以使用GitBook了。

三、项目初始化

可以自己新建一个目录,进入到该目录下,执行命令:

bash 复制代码
 ~  mkdir myGitBook && cd myGitBook                                                                                              ✔ │ base Py │ at 22:54:27
 ~/myGitBook  gitbook init                                                                                                       ✔ │ base Py │ at 22:54:46
warn: no summary file in this book
info: create README.md
info: create SUMMARY.md
info: initialization is finished

会生成两个md文档,README.md 是对书籍的简单介绍, SUMMARY.md 是书籍的目录结构。

然后可以通过gitbook serve编译成html格式,完成以后会打开一个 web 服务器,监听在本地的 4000 端口。

这样gitbook就初步搭建完成了。

相关推荐
未来之窗软件服务1 小时前
声音分离人声和配乐-从头设计数字生命第5课, demucs——仙盟创梦IDE
ide·macos·xcode·仙盟创梦ide·数字生命
名字越长技术越强11 小时前
Node.js学习
学习·node.js
我该如何取个名字12 小时前
Mac mini 安装mysql数据库以及出现的一些问题的解决方案
数据库·mysql·macos
知识分享小能手14 小时前
JavaScript学习教程,从入门到精通,Ajax与Node.js Web服务器开发全面指南(24)
开发语言·前端·javascript·学习·ajax·node.js·html5
dwqqw16 小时前
opencv图像库编程
前端·webpack·node.js
ttumetai16 小时前
MacOS中安装Python(homebrew,pyenv)
python·macos
layman052817 小时前
node.js 实战——(fs模块 知识点学习)
javascript·node.js
本本啊18 小时前
node 启动本地应用程序并设置窗口大小和屏幕显示位置
前端·node.js
全栈派森19 小时前
Next15 + Prisma + Auth5 实战讲解
react.js·node.js·next.js
·薯条大王19 小时前
Node.js 开发用户登录功能(使用mysql实现)
数据库·mysql·node.js