gitbook使用方式

gitbook可以用来管理知识。

搭建gitbook并托管到github pages

安装

需要node.js

cnpm install gitbook-cli -g

命令

# 初始化gitbook
gitbook init

# 预览
gitbook serve

# 生成静态页面
gitbook build

# 初始化安装插件
gitbook install

目录结构

.
├── 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文件中指定。

常用的配置如下：

{
    "root": "./docs", 
    "language" : "zh-hans",
    "styles": {
        "website": "./styles/website.css"
    }, 
    "plugins": [
        "hide-element",
        "back-to-top-button",
        "chapter-fold",
        "code",
        "splitter",
        "custom-favicon",
        "insert-logo",
        "tbfed-pagefooter",
        "-sharing",
        "sharing-plus"
    ], 
    "pluginsConfig": {
        "hide-element": {
            "elements": [
                ".gitbook-link"
            ]
        },
        "insert-logo": {
            "url": "./images/logo.png",
            "style": "background: none; max-height: 60px; min-height: 50px"
        },
        "favicon": "./images/favicon.ico",
        "sharing": {
            "twitter": false,
            "facebook": false,
            "google": false
        },
        "tbfed-pagefooter": {
            "copyright":"北京科技XXX公司版权所有",
            "modify_label":"该文章修订时间：",
            "modify_format": "YYYY-MM-DD HH:mm:ss"
        }
    }
}

也可以使用gitbook editor编辑markdown文件。

待阅读

1. 简书GitBook 使用教程
2. 简书gitbook入门
3. csdn GitBook 从懵逼到入门