GitBook的使用

GitBook

基于NPM利用GitBook创建自己的电子书

依赖Node.js

Node.js

Node简介

Node.js 是一个基于 Chrome V8 引擎的 JavaScript 运行时。

Node教程

教程

Node.js安装配置

下载位置，安装完就完事。

Liunx-down

Win64

Win32

报错

无法加载文件C:\Users\Administrator\AppData\Roaming\npm\tsc.ps1,因为在此系统上禁止运行脚本

解决

使用管理员身份运行并输入命令：set-ExecutionPolicy RemoteSigned

弹出窗口选择：Y/A即可。

NVM使用

npm是用来干什么的？

Python的pip，Java的Maven一样的作用，包管理，npm管理包而已。

安装

源地址（win）：

其中nvm-noinstall.zip需要配置，nvm-setup.zip解压后直接安装即可，其他的Source是源码，直接一直点击Next安装就可以了。

修改nvm/setting.txt文件内容为(下面是淘宝镜像)：

root: C:\Users<name>\AppData\Roaming\nvm
path: C:\Program Files\nodejs
arch: 64
proxy: none
node_mirror: http://npm.taobao.org/mirrors/node/
npm_mirror: https://npm.taobao.org/mirrors/npm/

常用命令

nvm ls   // 查看目前已经安装的版本
nvm install 10.5.0  // 安装指定的版本的nodejs
nvm use 10.5.0  // 使用指定版本的nodejs
复制代码

NPM使用

由于新版Node.js已经集成了Npm所以直接开始使用就可以了。npm -v查看版本信息，验证是否已经完成安装；sudo npm install npm -g命令用于升级更新旧版本(Linux)，Win下面使用npm install npm -g（附：推荐使用TB镜像npm install -g cnpm --registry=https://registry.npm.taobao.org）添加以前的版本，举例：npm install npm@6.14.10 -g

使用npm命令安装模块（略）

npm install express          # 本地安装
npm install express -g   # 全局安装

安装Gitbook

使用命令行安装，选择好gitbook editor或者Typora等你喜欢的markdown编辑器

问题

安装缓慢

国内Gitbook安装缓慢的话，建议科学上网或者改用淘宝镜像

Node.js版本问题

说明Node.js的版本环境有问题，需要降低Node版本。最新稳定版本是v12.18.3，下面展示上述报错的解决方案。（注：该方法可能只使用于Win10操作系统）

1. 解决办法1：
   卸载已下载版本，重新下载10.22.0版本的Node.js。缺点：对未来Node.js版本的更新或多个版本之间的切换使用不太方便

2. 解决办法2： 使用Windows系统下的Node.js的版本管理器nvm-windows（Node.js Version Manager for Windows）。nvm-windows可以帮助实现在同一台设备上进行多个node版本之间的切换。下载nvm并配置环境路径即可。

Gitbook使用

GitBook教程

1、安装gitbook命令行

$ npm install -g gitbook-cli

2、查看是否安装成功

$ gitbook -V

3、开始使用
（1）初始化

$ mkdir test_gitbook
$ cd test_gitbook
$ touch README.md
$ touch SUMMARY.md
$ vi SUMMARY.md
\* [简介](README.md)
\* [第一章](chapter1/README.md)
\- [第一节](chapter1/section1.md)
\- [第二节](chapter1/section2.md)
\* [第二章](chapter2/README.md)
\- [第一节](chapter2/section1.md)
\- [第二节](chapter2/section2.md)
\* [结束](end/README.md)

（2）生成目录结构

$ gitbook init

（3）查看目录结构

$ tree
.
├── README.md
├── SUMMARY.md
├── chapter1
│  ├── README.md
│  ├── section1.md
│  └── section2.md
├── chapter2
│  ├── README.md
│  ├── section1.md
│  └── section2.md
└── end
└── README.md

（4）本地预览

$ gitbook serve