gitbook安装教程

前言介绍

GitBook 是一款现代化的文档平台，这个工具链 (GitBook) 是一个使用 Git 和 Markdown 来构建书籍的工具。它可以将你的书输出很多格式：PDF，ePub，mobi，或者输出为静态网页。

GitBook工具链是开源并且完全免费的

一、nodejs安装配置 1.1 安装

到官网下载：nodejs 下载好后，无脑下一步安装。 测试是否安装成功：在cmd依次执行

node -v

npm -v

如下：

1.2 镜像配置

我们配置淘宝镜像：依次执行 1-配置全局的 registry 属性

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

2-检查配置结果

npm config get registry  

如下则成功：

3-测试一下

npm info express  

二、本地gitbook安装配置 2.1 切换到D盘

在D盘创建一个文件夹，我就命名为write了，切换很简单：D: 这样回车即可： 为什么要切换到D盘？我开始也是C盘，尝试了，会报错没权限，所以我让大家切换到D盘。 在D盘单独创建一个文件名为write，再cd write即可。

2.2 安装gitbook-cli

cmd执行如下命令：

npm install gitbook-cli -g

2.3 查看版本

gitbook --version

回车：

2.4 初始化gitbook

cmd继续执行：

gitbook init

如下： 应该生成两个文件： README.md —— 书籍的介绍写在这个文件里 SUMMARY.md —— 书籍的目录结构在这里配置 但是底部报错了，经过查资料，要降低nodejs版本…

2.5 启动gitbook

cmd继续执行：

gitbook serve

但是会报错如下： 复制报错路径，找到polyfills.js： 编辑它，找到低62-65行，注释掉，保存即可：

然后再来执行：

gitbook serve

回车： 手动在浏览器复制粘贴如下本地端口：

localhost:4000

得到如下：