2.3.1. configuration
使用 book.json
可以灵活的管理自己的数据配置,该配置与 SUMMARY.md
同级:
.
├── book.json
├── README.md
└── SUMMARY.md
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": "."
2.3.1.7. links
在左侧导航栏(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) |