gitbook配置

1、是什么

明确一点Git 与 GitBook 就像雷锋和雷峰塔彻底没有一点关系。

实际上，GitBook 是 一 个 基 于 Node.js 的 命 令 行 工 具 ， 支 持 Markdown 和 AsciiDoc 两种语法格式，能够输出 HTML、PDF、eBook等格式的电 子书。因此我更喜欢把 GitBook 定义为文档格式转换工具。目前使用的搭配是 GitBook + Typora + Git。

 

2、如何搭建 GitBook 环境？

由于GitBook 是基于 Node.js，因此咱们首先须要安装 Node.js

1、安装 Node.js 

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

LTS 版本是一个支持 NodeJS 老版本特性的特殊新版本，Current 版本属于

一个全新的新版本。若是你的NodeJS 应用使用的比较老的 SDK 开发，LTS 版

本能让你平滑升级到新版本。

若是你的NdoeJS 应用使用的是全新的 SDK 开发选择 Current 版本便可。

 

2、windows 安装

  

 

 

安装结束以后使用cmd 控制台输入node -v 出现版本号则成功、

若是命令没法找到。则须要配置环境变量。

 

1、配置环境变量

 

将node.js 的路径加入环境变量，重启控制台从新输出 node -v 便可

4、mac 安装

1、双击安装程序安装

以下：

2、显示程序将会安装的位置

一直点击继续到最后为

 

3、在终端中输入命令

node –v

npm –v

以下：

 

 

 若展现如上说明node 安装成功

4、若 node-v 提示为失败

- bash: node: command not found

须要配置环境变量了步骤以下

进入，finder 右键选择”前往文件夹”以下

进入etc

 

 

 文件夹中找到“profile”文件，此文件锁定能够复制一份出来加上如下语句： 

　　export NODE_HOME=" node 安装路径(bin 路径的父级路径)"

　　export PATH=$PATH:$NODE_HOME/bin

 

步骤2 中已有 node 安装路径为/usr/local/bin/node因此我本身这边增长语句以下：

 　　export NODE_HOME="/usr/local" export

　　PATH=$PATH:$NODE_HOME/bin

　　ps：（ 若是不记得 node 的安装路径，能够打开终端，输入 which node便可找出node 安装路径 ）

改完profile 副本文件保存为不带后缀的文件，名字亦为profile 便可覆盖原来的 profile，环境变量配置好了就能够按照步骤 3 来验证了。

 

2、安装 gitBook

打开命令行，执行npm install -g gitbook-cli

 

Gitbook-cli 不能有空格

安装完成

 

检验：

Gitbook -v

无错误便可

 

3、GitBook 如何使用

1、配置

 一、建立一个文件夹名为 mybook（名字能够随便取）

 二、在控制台上找到这个文件夹并输入gitbook init

  

安装成功以后，目录下会出现两个文件。

三、将此文件夹拖拽到 VSCode 中就能够进行吧编辑

 

 

SUMMARY.md 为目录超连接文档，语法格式为：markdown 格式。

小括号内为超连接

四、点击此按钮为预览

 

五、编辑成功以后再 cmd 中运行 gitbook serve

 

浏览器访问如上地址

 

六、若是遇到以下问题

 

 请关闭杀毒软件别问我为何

运行成功以后为

 

 

七、若是要写文档则须要新建一个 .md 文档将其路径添加到对应的

　　SUMMARY.md 的超连接中

 

二、未完待续

　　....