Tips:任何技术文章都有时效性，《从0到1手动打造移动广告归因系统》系列会尽力提供技术背景和环境，还请参考前务必看清文章发布时间，以免产生误导
量U移动归因的技术文档采用 gitbook 工具写成，这篇文章将介绍如何在 CentOS、Windows 和 macOS下安装 gitbook 这款写书工具
- CentOS
- macOS
- Windows
CentOS 下安装
CentOS 8.2 及以上
截止当前（2021年5月份），CentOS 7.9 之前版本的官方源均已失效，意味着无法再使用 yum 命令进行在线软件安装，从而对 gitbook 的安装过程造成一些障碍。故这里使用CentOS 8.2做演示，理论上 CentOS 7.9 也可用，但需要自行验证
- 安装 nodejs
目前 nodejs官网下载 LTS版本为14.16.1，内置的npm包管理器版本为 6.14.12
如果你的CPU是 intel x86_64 位架构，选择 Linux Binaries (x64) 进行下载，如果系统为32位，那么很可能会安装失败
如果你的CPU是 ARM 架构，选择 Linux Binaries (ARM) 对应的版本进行下载
官网下载.png
将下载文件移动到 root 目录下，然后右键点击解开压缩包到当前目录，当然不一定要在 root 目录下进行，可以根据需要更改。如果你不是 root 用户，那就移动到 /home/{登录名} 的家目录下，然后进入到解开的 node-v14.16.1-linux-x64/bin 目录，并在这个 bin 目录下打开 shell 窗口
- 安装文件准备就绪，设置软链接进行安装
//root用户
ln -s /root/node-v14.16.1-linux-x64/bin/node /usr/bin/node
ln -s /root/node-v14.16.1-linux-x64/bin/npm /usr/bin/npm
//非root用户
ln -s /home/登录名/node-v14.16.1-linux-x64/bin/node /usr/bin/node
ln -s /home/登录名/node-v14.16.1-linux-x64/bin/npm /usr/bin/npm
这里的安装其实就是在 /usr/bin 下设置了两条软链接指向下载好的nodejs安装文件，因为 /usr/bin 目录已经是系统默认环境变量的二进制执行目录，所以不需要再额外修改环境变量就可以直接在shell窗口中执行 node 和 npm 命令
- 开始安装 gitbook-cli
npm install -g gitbook-cli // -g 为全局安装选项
安装完成后可以看到当前目录下多了一个gitbook文件
gitbook-cli 安装完成后开始安装 gitbook，这是两个不同的东西，然后网上有些帖子说是要执行
npm install -g gitbook //error 会报错
但实际上并不能安装成功
猜测是某些库跟当前 nodejs 版本不兼容
正确的安装方式
ln -s /root/node-v14.16.1-linux-x64/bin/gitbook /usr/bin/gitbook //设置gitbook-cli的软链接
gitbook -V //再查询gitbook-cli的版本 注意这里是大写V 然后会自动触发 gitbook 3.2.3的安装
会出现一个错误，但不要紧，后面会讲怎么修复这个错误，之所以会出现这个错误，是因为 gitbook 3.2.3的版本跟nodejs 14.16.1 不兼容，据说需要 nodejs 降级为 10.23.0，这里不再去进行验证。总之，gitbook的安装条件很苛刻，这篇文章的目的并不是找出这些兼容性的搭配，而是快速找到一种完美可重现的方法供大家使用，大大减少大家在安装上的试错成本，从而将大量的时间和精力投入到真正有意义的工作上。
- 我们来修复这个 cb.apply 报错
//根据提示路径打开这个 polyfills_js 文件 说实在的这个路径结构有点迷
vim /root/node-v14.16.1-linux-x64/lib/node_modules/gitbook-cli/node_modules/npm/node_modules/graceful-fs/polyfills.js
使用:set number打开行号显示，注释掉62-64行，这几行是对低版本的兼容，因为不需要再做兼容，所以我们将其注释掉（这里不拘泥于vim编辑，任何一种文本编辑器打开这个js文件都可以）
:wq保存之后，再执行 gitbook -V，安装成功
- 开始进入正题，启动gitbook
不要贸然相信网上所说的初始化
[root@localhost bin]# gitbook init
warn: no summary file in this book
info: create README.md
info: create SUMMARY.md
TypeError [ERR_INVALID_ARG_TYPE]: The "data" argument must be of type string or an instance of Buffer, TypedArray, or DataView. Received an instance of Promise
这个时候并没有完全初始化成功，而只是在当前目录下生成了一个 README.md 文件
- 手写 SUMMARY.md 和 README.md两个文件或者git clone 网上的空白模板
mkdir book //新建一个 book 目录
cd ./book //进入 book 目录
touch SUMMARY.md
touch README.md
gitbook serve ./ //启动 gitbook
- 启动成功，打开浏览器 localhost:4000 进行查看，此后就是按照 markdown 语法编写 SUMMARY.md 和 README.md这两个文件，再额外添加章节md文件来愉快地进行写书了
[root@localhost book]# 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 0 asset files
info: >> generation finished with success in 0.2s !
Starting server ...
Serving book on http://localhost:4000
macOS 下安装
macOS Big Sur 11.2.3及以上
nodejs官网首页会跟随你的系统自动显示对应的安装文件
macOS下载的是node-v14.16.1.pkg文件，直接双击文件进行安装
安装对话框里也直接告诉你了node和npm的安装路径会在哪(/usr/local/bin)
安装完成后在终端里node和npm命令都显示可用
然后使用下面的命令安装 gitbook-cli
sudo npm install -g gitbook-cli
注意：在macOS下一定要在前面加 sudo 否则会报错无法安装
gitbook-cli 安装完成后接下来和 CentOS 下一样，在终端输入
gitbook -V //注意V是大写
会自动安装 gitbook ，当然也会遇到和 CentOS 一样的报错
没关系，同样的错误同样的处理方法。不过在使用 vim 编辑的时候也要使用 sudo 权限
修改完这个文件后再次执行 gitbook -V 完成 gitbook 的安装
之后就和 CentOS 下的操作一样了
//在有 SUMMARY.md 和 README.md 两个文件的文件夹下执行
gitbook serve .
Windows 下安装
Windows 10
安装前需要做一些准备工作，你需要安装一款可以运行命令的终端，当然你也可以直接使用系统自带的cmd界面，这里使用的是 git-scm，安装完后鼠标右键点击桌面会多出两个 Git Gui Here 和 Git Bash Here 的菜单选项，选择 Git Bash Here 即可打开 shell 终端，其实这个 git-scm 真正的用途是一款 git 工具，不过这里就是借用了它的 shell 终端罢了
和前面两款系统一样，Windows下nodejs官网也会跟随系统显示Windows下的安装文件 node-v14.16.1-x64.msi，下载下来后直接双击安装即可，安装过程中也可以选择安装路径
和 macOS 一样，安装完成后 node 和 npm 命令直接在终端里可用，因为安装过程会自动添加环境变量
然后安装 gitbook-cli 和 gitbook
npm install -g gitbook-cli
安装等待时间可能会有一点长，但最后还是能安装上的，等待总是值得的
gitbook -V
等待时间还是很长，并且也会遇到 CentOS 和 macOS 下一样的错误
一样的错误就用一样的解决方法
根据错误提示的路径，找到这个 polyfills.js 文件，在 Windows下你要怎么打开这个文件就随意了，可以是记事本，也可以是任何一款代码编辑IDE
保存后再次执行 gitbook -V
经过漫长等待，安装成功后在桌面新建一个 book 文件夹，然后在文件夹内手动新建两个空白文件 SUMMARY.md 和 README.md，在该文件夹的路径下启动 gitbook 就可以了
gitbook serve ./
最后需要提醒的是需要注意你的 shell 终端打开的路径，就是终端标题栏那里，如果路径显示的是桌面，那么需要指定启动的文件夹是 book，启动命令如下
gitbook serve ./book
如果路径是在 book 文件夹内部，那么直接用命令 gitbook serve ./ 就好
祝大家写书愉快！
（完结)
