gitbook的安装、使用及部分指令

一、gitbook的安装

注意：gitbook的安装部分需要翻墙后才能进行。

1.第一步：安装Node

gitbook是基于Node.js，所以首先要安装Node.js（下载地址：https://nodejs.org/en/download）
正常安装后，Node.js会自带npm工具，打开命令行（win + R，输入CMD ），执行以下命令：

npm install -g gitbook-cli

2.第二步：安装Typora和Git版本管理工具

• Typora 下载地址:https://typora.io/
• Git 版本管理工具下载地址:https://git-scm.com/downloads

二、gitbook的使用

1.第一步：建立一本书

在你的硬盘上建立一个需要放书的文件夹，我们暂时命名成mybook文件夹，在命令行CD到mybook文件夹，执行以下命令

gitbook init

执行完成后，mybook文件夹多出来两个文件README.md 和 SUMMARY.md，它们的作用如下：

• README.md —— 书籍的介绍
• SUMMARY.md —— 书籍的目录结构的配置

2.第二步：建立书的目录结构

编辑 SUMMARY.md 文件，内容修改为：

# 目录
* [前言](README.md)
* [第一章](Chapter1/README.md)
* [第二章](Chapter2/README.md)
* [第三章](Chapter3/README.md)
* [第四章](Chapter4/README.md)

然后我们回到命令行，在 mybook 文件夹中再次执行 gitbook init 命令。GitBook 会查找 SUMMARY.md 文件中描述的目录和文件，如果没有则会将其创建。

3.第三步：编辑内容

具体请参照教程：https://www.runoob.com/markdown/md-tutorial.html

三、一些其他命令

1.build指令

gitbook build [书籍路径] [输出路径]

2.serve指令

gitbook serve --port 2333  # 用于指定端口
gitbook serve  #本地启动一个服务器

3.pdf指令生成PDF文件

gitbook pdf ./ ./mybook.pdf

4.epub指令生成epub电子书

gitbook epub ./ ./mybook.epub

5.mobi指令

gitbook mobi ./ ./mybook.mobi

6.git版本管理

执行 git remote add 添加远程仓库。接着就可以 commit，push，pull 相关指令了！