Gitbook安装与使用

gitbook安装

1. 安装node.js
   从官网下载相应版本node.js
   网址 https://nodejs.org/en/download
2. 设置镜像
   nodejs 安装完成后，我们还需要配置一下 nodejs 插件安装的下载镜像地址。因为默认的镜像地址是在国外，需要翻墙才可以访问，因此我们需要设置国内的镜像地址。推荐使用阿里巴巴的镜像地址 http://registry.npm.taobao.org 。执行以下命令，

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

3. 用npm安装gitbook
   npm为node的安装包管理工具，安装node.js时默认安装了npm
   打开命令行输入安装命令

npm install gitbook-cli -g

注意“ -g” 要加空格

4. 检查是否安装成功
   命令行输入以下命令，

node -v

npm -v

gitbook -V

出现版本号，即为安装成功

gitbook使用

1. 初始化gitbook

gitbook init

可提前在.gitbook目录下创建一个空的文件夹用来存放新生产的README.md和SUMMAR.md
README.md：说明文档
SUMMAR.md：书的章节目录

2. 预览书籍

gitbook serve

执行命令后会对 Markdown 格式的文档进行转换，默认转换为 html 格式。最后提示 “Serving book on http://localhost:4000”，打开网址即为gitbook电子书

3. gitbook其余命令

 gitbook build     生成静态网页  
 gitbook help      列出gitbook所有的命令  
 gitbook --help    输出gitbook-cli的帮助信息    
 gitbook serve     生成静态网页并运行服务器      
 gitbook build --gitbook=2.0.1   生成指定gitbook的版本    
 gitbook ls         列出本地所有的gitbook版本   
 gitbook ls-remote    远程可用的gitbook版本   
 gitbook fetch 版本     安装对应的gitbook版本
 gitbook update      更新到gitbook最新版本   
 gitbook uninstall 版本     卸载相应的版本
 gitbook build --debug     输出错误信息
 gitbook build --lo=debug     指定log级别

安装时出现的问题

1. 无法找到node和npm（路径问题）
   检查环境变量是否配置完成

2. 无法找到gitbook（路径问题）

   1. 在配置环境变量时，在path中加入gitbook的路径
   2. 在npm已存在的条件下，无法找到gitbook时，可以将npm.cmd和gitbook.cmd放入同一目录下，此时省去配置环境变量的步骤（个人推荐第二种方法）