GitBook相关使用以及配置笔记

Webpack 2020-12-29

本地安装

GitBook的安装非常简单。您的系统只需满足这两个要求：

NodeJS（推荐使用v4.0.0及以上版本）
Windows，Linux，Unix或Mac OS X

gitbook-cli 是安装和管理GitBook版本库的程序。它会自动安装GitBook所需的模块来创建一本书。

$ npm install gitbook-cli -g

gitbook使用常见指令：

$ gitbook init  // 在当前目录创建一本书
$ gitbook init ./directory  // 用现有的目录来创建一本书
$ gitbook serve  预览创建的书
$ gitbook build  构建静态网站
$ gitbook install  初始化安装插件

目录结构

一般GitBook目录如下：

.
├── book.json
├── README.md
├── SUMMARY.md
├── chapter-1/
|   ├── README.md
|   └── something.md
└── chapter-2/
    ├── README.md
    └── something.md

book.json:配置文件数据
README.md:简介-书籍的简单介绍
SUMMARY.md:目录

以子目录的方式与项目集成

对于软件项目，可以使用子目录(如docs/)来存储项目的文档。您可以在book.json中通过配置选项告诉GitBook在那里找到根目录：

.
├── book.json
└── docs/
    ├── README.md
    └── SUMMARY.md

book.json配置如下：

{
    "root": "./docs"
}

菜单与页面

GitBook使用一个SUMMARY.md文件来定义文档的菜单。

SUMMARY.md中[]内的内容是标题，()内是文档的路径，章节和子章节用四个空格或者tab键来分级。

菜单示例：

# 概述
### 服务介绍
* [服务介绍](README.md)

### 服务接入流程

* [服务开通](serviceOpen.md)
* [应用配置](appConfig.md)

### 企业实名认证服务端API
* [API服务规范](apiStandard.md)
* [营业执照OCR接口](apiOCR.md)

配置

GitBook允许您使用灵活的配置自定义书籍和文档。这些选项在book.json文件中指定。

常用的配置如下：

,"language" : "zh-hans": {
        "website": "./styles/website.css"
    },"plugins": [
        "hide-element"logo"
    ],"pluginsConfig": {
        "hide-element": {
            "elements": [
                ".gitbook-link"
            ]
        },1)">: {
            "url": "./images/logo.png"
        },"favicon": "./images/favicon.ico": {
            "twitter": false: {
            "copyright":"北京科技XXX公司版权所有"文章修订时间："
        }
    }
}