gitbook安装教程

文章目录

• • 前言介绍
  • 一、nodejs安装配置
  • • 1.1 安装
    • 1.2 镜像配置
  • 二、本地gitbook安装配置
  • • 2.1 切换到D盘
    • 2.2 安装gitbook-cli
    • 2.3 查看版本
    • 2.4 初始化gitbook
    • 2.5 启动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

得到如下：