Gitbook使用入门

官方网站：https://www.gitbook.com/

入门指南（网上搜一下非常多）：http://www.chengweiyang.cn/gitbook/basic-usage/README.html

                                             https://chrisniael.gitbooks.io/gitbook-documentation/content/

                                             .......

---------------------------------------

 一、基础

1、新建目录，并在其中建两个文件：README.md与SUMMARY.md，其中README.md为电子书的首页，SUMMARY.md表示电子书的目录结构。

2、在目录下执行gitbook init（可以先定义完SUMMARY目录结构，然后执行gitbook init会帮你按照目录结构生成空文件，在修改md内容后需要再次执行gitbook init）

3、执行gitbook serve启动服务，默认为4000端口，要修改端口的话可以执行gitbook serve --port XXXX

 

二、定制

1、安装插件：

（1）新建book.json文件

例子：

{
    "title": "XXX",
    "description": "XXX",
    "plugins": [
        "splitter",
        "expandable-chapters",
        "popup"
    ],
    "pluginsConfig": {
    }
}

（2）执行gitbook install

 

2、修改样式（定制css）

（1）新建css文件

（2）修改book.json

{
    "title": "XXX",
    "description": "XXX",
    "styles": [
        "website": "styles/website.css"
    ],
}