前端

GitBook初体验

简介

GitBook是基于git和markdown的的文档和知识库软件，可以帮助你和你的组织、团队建立共享的知识库
下面是GitBook官网(https://www.gitbook.com/)的描述：

安装

1
npm install gitbook -g

建议使用gitbook-cli，这样就可以在你电脑的任何地方使用gitbook的命令

1
npm install -g gitbook-cli

这里需要注意的是如果要全局安装gitbook-cli，需要先卸载之前已经全局安装过的gitbook

1
2
npm uninstall -g gitbook
npm install -g gitbook-cli

使用

GitBook的基本用法非常简单。

  1. 使用gitbook init 初始化书籍目录
  2. 使用gitbook serve 编辑书籍

然而。。。
卡在第一步了

1
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

原因是gitbook跟不上最新版本的NodeJS，使用10版本勉强能用。但又不想为了这么个东西降低版本，因此果断弃坑。

这里有一篇总结了各个版本之间的各种问题：https://xmuli.tech/posts/d7327716/

替代方案是GitBook有个在线版的，https://app.gitbook.com

注册之后可以使用

https://yiny.gitbook.io/