GitBook编辑文档
在公司使用一些公用组件时,总是苦于文档不健全,每次调用的时候都要去看代码。于是我想我自己写的组件让别人用时就别这么坑了,也方便以后自己查看方便,所以打算为自己开发的文档编写一下开发文档。然后发现GitBook是一个不错的开发文档编写工具,于是...对着文档指示:
安装
npm install gitbook-cli -g
一看到cli
就知道是个脚手架了,对吧!是的,gitbook-cli
是安装和管理GitBook版本库的程序。它会自动安装GitBook所需的模块来创建一本书。
创建
gitbook init
// 使用现有的目录来创建一本书
gitbook init ./dirctory
运行和打包
gitbook serve
gitbook build
跟其他脚手架也差不多
安装其他版本
gitbook 命令可以方便地下载和安装不同版本的GitBook来测试你的书
gitbook fetch 4.0.0-alpha.1
使用 gitbook ls-remote
列出可用于安装的远程版本
$ gitbook ls-remote
Available GitBook Versions:
4.0.0-alpha.5, ...部分省略..., 4.0.0-alpha.1, 3.2.2, 3.2.1, ...部分省略..., 2.0.0-alpha.1
Tags:
latest : 3.2.2
pre : 4.0.0-alpha.5
然而...
一顿操作猛如虎之后...
报错了!!!
真是尴尬... 所有步骤都是按照官网教程来的啊,为什么会报错呢?
于是,只能到百度里google之:有人就说这是因为你使用的node版本太高了,GitBook不兼容造成的,换个node版本吧!
不会吧?我不能为了这么个“私人”项目把node版本吧?那我其他“正经”项目怎么办?
这时候一个单词从我脑海中一闪而过nvm
,对啊,怎么把这事给忘了?
nvm
nvm
就是为了这事而存在的,全名node.js version management,就是nodejs的版本管理工具。通过它可以在一台电脑上安装和切换不同版本的nodejs。
事不宜迟,赶紧下载安装...
然后:
nvm ls-remote // 列出所有可安装的node版本号
nvm install v12.18.3 // 安装指定版本号的node
nvm use v12.18.3 // 切换node版本,这个是全局的
nvm current // 当前node版本
nvm ls // 列出所有已经安装的node版本
先用12.18.3
版本试了一下,还是一样
if(cb) cb.apply(this, arguments)
TypeError: cb.apply is not a function
还不行?又有网友说可能需要用10.xx.xx版本,看来不少朋友都被这个问题困扰过啊!
好吧,那也只好再试一下喽:
nvm install 10.21.0
+ nvm use v10.21.0
这时候再用gitbook serve
, 一个 http://localhost:4000
网站就这样活生生的展示在了我的面前。