gitbook安装使用教程

以下是gitbook的简略安装使用过程，可以参考一下。后续有时间我再回头修改完善

实验目的：

安装gitbook后，将相关的文件发布到gitlab上

安装node.js

在cmd下执行安装npm install gitbook-cli

安装GitBook Editor

官网好像不好下，备用下载链接：https://pan.baidu.com/s/1nX6FRtyzvdNXj8ijaVIfng 提取码：3b7w

可以先不安装插件　
为了防止后面步骤报错，需要修改配置文件copyPluginAssets.js将112行改为false。修改了这里好像下面的book.json文件直接忽略也可以
新增book.json文件，内容如下：
{
   "plugins": ["highlight"],
   "pluginsConfig": {
       "highlight": {
           "shortName": "高亮"
       }
   }
}

开始制作gitbook

完成后，点击保存

进入gitbook目录(默认C:\Users\用户名\GitBook\Library\Import)
gitbook init
gitbook serve

然后就可以在浏览器直接访问localhost:4000，会自动显示相关的gitbook

上传至gitlab步骤：
windows上先安装git客户端
打开git bash生成密钥

gitlab添加ssh密钥
git config --global core.autocrlf false #解决LF CRLF警告
然后根据gitlab提示执行即可
git config --global user.name "joe"
git config --global 随便填个邮箱@qq.com

具体上传到gitlab的命令可以先在gitlab中先建一个项目，之后会有相应的命令提示

参考链接：https://www.cnblogs.com/libaoshan/p/10968662.html

来源：oschina

链接：https://my.oschina.net/u/4273197/blog/3291135

标签

gitlab

git

highlight

GitBook