搭建Gitbook+Gitee电子书管理工具（一）

搭建Gitbook+Gitee电子书管理工具

Gitbook 是一个基于node.js命令的电子书制作工具。其支持Markdown等语法格式进行编辑，可生成HTML与PDF等格式的电子书。关于Gitbook的具体介绍可以参考博文：Gitbook 从懵逼到入门。常搭配版本管理平台为Github （网上已有许多相关教程）。由于Github有时不稳定，本文采用Gitbook + Gitee的搭配。

1.安装使用gitbook

具体步骤如下：

1. 安装Node.js
   可通过 node -v检查是否安装Node.js以及其版本，若未安装则选择一个版本进行安装。本文采用10.14.2版本，下载地址为：https://nodejs.org/download/release/
   Ps. 1）Node.js版本不匹配会导致后续出现报错
   2）如需Node.js 多版本控制则需要用到nvm，本文不做扩充。

2. 安装Gitbook
   采用命令 npm install gitbook-cli -g进行全局安装
   采用命令gitbook -V查看安装情况

CLI version: 2.3.2 
#先出现 
Installing Gitbook 3.2.3 
#安装完成后 
GitBook version: 3.2.3

3. 编辑器推荐
   个人推荐Typroa

4. 实例展示
   Gitbook init 初始化
   会生成文件README.md与SUMMARY.md。
   可以通过编辑文件SUMMARY.md来确立电子书主体结构。
   示例代码:

* [简介](README.md)
* [第一章](part1/part1.md)
  * [第一节](part1/part1_1.md)
  * [第二节](part1/part1_2.md)

可在通过命令Gitbook init自动生成对应文件夹、文件。
执行Gitbook serve后通过访问http://localhost:4000浏览电子书。示例效果如下图。

2.搭建Gitee仓库进行版本管理

Gitbook + Gitee的配置类似于Gitbook + Github（网上有很多教程）。
本文以下只做几点注释：

1. 为什么要配置ssh？
   并不是必须设置，但是建议设置。git基于多种传输协议，如https和ssh，来保障数据传输安全。如果不设置ssh公钥每次提交代码都要输入你的帐号密码。设置ssh密钥的目的是为了省略输入用户名密码的过程。
2. 如何添加SSH密钥？
   生成/添加SSH公钥的方法见:官方文档。
3. 如何进行版本控制？
   Git相关基本操作可见网址Git基本操作。