GitBook安装

Windows下安装

1. 下载地址：https://nodejs.org/en/

2. 直接安装，并且添加至环境变量，记住最后让添加什么工具得，别勾选，咱们用不到那么多。

3. 执行命令看是否安装成功

   node -v 

4. 安装GitBook

   npm  install gitbook-cli -g

5. 检测Gitbook安装是否成功

   npm -v

Linux下安装

1. 安装NodeJS，依次执行以下命令

   cd /tmp
   wget https://nodejs.org/dist/v12.16.1/node-v12.16.1-linux-x64.tar.xz
   tar xvf node-v12.16.1-linux-x64.tar.xz
   mv node-v12.16.1-linux-x64 /usr/local/
   ln -s /usr/local/node-v12.16.1-linux-x64/bin/node /usr/bin/node
   ln -s /usr/local/node-v12.16.1-linux-x64/bin/npm /usr/bin/npm
   rm -rf node-v12.16.1-linux-x64.tar.xz

2. 检测安装是否成功

   node -v

3. 安装GitBook

   npm install gitbook-cli -g
   ln -s /usr/local/node-v12.16.1-linux-x64/bin/gitbook /usr/bin/gitbook
   gitbook -V

4. 检测安装是否成功

   npm -v

内网环境安装

本文以windows环境搭建为例

1. 下载nodejs安装包拖至内网环境，进行安装

2. 执行如下指令，检查nodejs版本和npm版本

   node -v
   npm -V

3. 在有外网的机器上，执行如下命令安装gitbook, 安装完成后查看安装结果

   npm -npm install gitbook-cli -g
   npm -V

4. 安装完成后，将以下文件夹复制进内网环境的对应的目录下

   C:\Users\自己的用户名\AppData\Roaming\npm

   C:\Users\自己的用户名\AppData\Roaming\npm-cache

   C:\Users\自己的用户名\.gitbook

5. 然后进内网环境，执行命令，查看环境搭建如何

   gitbook -V

安装Typora

下载地址：https://www.typora.io/#windows

安装pandoc

下载地址：https://www.pandoc.org/installing.html

安装包：已上传至自己的网盘，直接安装即可，不需要配置环境变量

安装ebook-convert

下载地址：https://calibre-ebook.com/download_windows64

安装包：已上传至自己的网盘

问题记录

Gitbook常见命令

gitbook -V：查看版本号
gitbook ls：列出本地所有的gitbook版本
gitbook init：初始化
gitbook install：安装插件
gitbook serve：预览
gitbook build：生成
gitbook build --gitbook=2.6.7：生成时指定gitbook的版本, 本地没有会先下载
gitbook uninstall 2.6.7：卸载指定版本号的gitbook
gitbook fetch [version]：获取[版本]下载并安装<版本>
gitbook --help：显示gitbook-cli帮助文档
gitbook help：列出 gitbook 所有的命令
gitbook ls-remote：列出NPM上的可用版本：

Gitbook版本卸载更新

1. 清理缓存

   npm cache verify

2. 删指定版本的Gitbook

   gitbook uninstall 3.2.3

更换npm下载源

• 命令行切换为淘宝源

  npm config set registry https://registry.npm.taobao.org

• 命令行切换回官方源

  npm config set registry https://registry.npmjs.org/