2.3.1. configuration

使用 book.json 可以灵活的管理自己的数据配置,该配置与 SUMMARY.md 同级:

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

book.json官网介绍

2.3.1.1. title

设置书本的标题

"title" : "Gitbook Use"

2.3.1.2. author

作者的相关信息

"author" : "MinGRn"

2.3.1.3. description

本书的简单描述

"description" : "记录Gitbook的配置和一些插件的使用"

2.3.1.4. language

Gitbook使用的语言, 版本2.6.4中可选的语言如下:

en, ar, bn, cs, de, en, es, fa, fi, fr, he, it, ja, ko, no, pl, pt, ro, ru, sv, uk, vi, zh-hans, zh-tw

配置使用简体中文

"language" : "zh-hans",

2.3.1.5. gitbook

指定使用的gitbook版本

"gitbook" : "3.2.2",
"gitbook" : ">=3.0.0"

2.3.1.6. root

指定存放 GitBook 文件(除了 book.json)的根目录

"root": "."

在左侧导航栏(home)添加链接信息

"links" : {
    "sidebar" : {
        "Home" : "https://www.gitbook.com"
    }
}

2.3.1.8. styles

自定义页面样式, 默认情况下各generator对应的css文件

{
    "styles": {
        "website": "styles/website.css",
        "ebook":   "styles/ebook.css",
        "pdf":     "styles/pdf.css",
        "mobi":    "styles/mobi.css",
        "epub":    "styles/epub.css"
    }
}

例如使<h1> <h2>标签有下边框, 可以在website.css中设置

h1 , h2{
    border-bottom: 1px solid #EFEAEA;
}

2.3.1.9. plugins

配置使用的插件

"plugins": [
    "disqus"
]

添加新插件之后需要运行gitbook install来安装新的插件

Gitbook默认带有5个插件:

  • highlight
  • search
  • sharing
  • font-settings
  • livereload

如果要去除自带的插件, 可以在插件名称前面加-

"plugins": [
    "-search"
]

2.3.1.10. pluginsConfig

配置插件的属性

"pluginsConfig": {
    "fontsettings": {
        "theme": "sepia",
        "family": "serif",
        "size":  1
    }
}

2.3.1.11. structure

指定 Readme、Summary、Glossary 和 Languages 对应的文件名,下面是这几个文件对应变量以及默认值:

变量 含义和默认值
structure.readme Readme file name (defaults to README.md)
structure.summary Summary file name (defaults to SUMMARY.md)
structure.glossary Glossary file name (defaults to GLOSSARY.md)
structure.languages Languages file name (defaults to LANGS.md)
Copyright © MinGRn 2018 all right reserved,powered by Gitbook最近修订时间: 2019-02-20

results matching ""

    No results matching ""