2.1.2.3 Gitbook的使用

2.1.2.3.1 安装Visual Studio Code 10

在官网中找到Visual Studio Code 10安装包并下载安装,如图所示(https://code.visualstudio.com/download#)

img img img img img

2.1.2.3.2 安装Node.js

在官网中找到Node.js安装包并下载安装,使用Gitbook需安装低版本的node.js [v12.x],如图所示(https://nodejs.org/dist/latest-v10.x/)

img img img img img img

2.1.2.3.3 安装Gitbook

1.在开始菜单中找到Node.js command prompt并打开。 img

2.在命令行中输入npm install -g gitbook-cli命令进行安装。 img img 3.安装完成之后,输入gitbook -V命令来检验是否安装成功。 img

2.1.2.3.4 提交Gitbook

1.克隆Git文件 在E盘新建项目文件夹,打开命令提示符,在项目文件夹E:\GITFILE目录下输入要克隆文件的地址,例如:git clone http://192.168.1.98/coony/ddp.doc img 在弹出框中输入Git用户名和密码,克隆完成。 img 2.在Visual Studio Code 中打开文件-打开文件夹,如图所示。

img

3.配置Git 打开命令提示符,在E:\GITFILE\ddp.doc下依次输入Git用户名、邮箱、密码,例如:git config user.name chen.jiaqi,如下图所示。 img 3.保存并Push 在编辑完成后,左侧源代码管理中会出现(1)已修改过的文件,(2)备注信息,(3)提交,(4)Push,发布成功。 img img 4.Visual Studio Code中npm、gitbook插件安装 打开终端-新终端,输入依次npm install,gitbook install,npm run serve 命令,显示Serving book on http://localhost:4000,即成功,可点击链接进行查看。 img img img 注:Windows 10 用户会出现gitbook install失败的情况,此时在搜索栏中打开Windows PowerShell,以管理员身份运行,输入set-ExecutionPolicy RemoteSigned命令,执行策略更改,输入Y确认。 img img

注意:在执行gitbook install时,安装的插件disqus会安装最新版本的插件,该插件需要安装gitbook 4.0.0版本。如果gitbook的版本号为3.2.3,执行gitbook serve或者npm run serve 时会报错。

报错结果如下: info: loading plugin "disqus"... ERROR Error: GitBook doesn't satisfy the requirements of this plugin: >=4.0.0-alpha

解决方法:安装disqus 0.1.0旧版本即可。 执行的命令:

    npm install gitbook-plugin-disqus@0.1.0

results matching ""

    No results matching ""