配置
GitBook允许您使用灵活的配置自定义书籍和文档。这些选项在book.json文件中指定。对于不熟悉JSON语法的作者，您可以使用JSONlint等工具验证语法。
常规设置
| 变量 | 说明 |
|---|---|
root |
包含所有图书文件的根文件夹的路径，除了book.json |
structure |
指定自述，摘要，词汇表等的路径。请参见结构段落。 |
title |
书的标题，默认值从README中提取。在GitBook.com上，此字段已预填。 |
description |
您的图书说明，默认值从自述文件中提取。在GitBook.com上，此字段已预填。 |
author |
作者姓名。在GitBook.com上，此字段已预填。 |
isbn |
书的国际码ISBN |
language |
语言ISO规范的书的语言，默认值是en |
direction |
文本的方向。可以是rtl或ltr，默认值取决于language 的值 |
gitbook |
GitBook的版本。使用SemVer规范并接受诸如“> = 3.0.0”的条件 |
插件
插件及其配置在book.json中指定。有关更多详细信息，请参阅插件部分。
从3.0.0版本开始，GitBook可以使用主题。有关详细信息，请参阅主题部分。
| 变量 | 说明 |
|---|---|
plugins |
要加载的插件列表 |
pluginsConfig |
插件配置 |
结构体
除了root变量，你可以告诉Gitbook Readme，Summary，Glossary，Languages的文件名(而不是使用默认名称，如README.md)。
这些文件必须在您的书的根(或每个语言书的根)。不接受诸如dir/MY_README.md之类的路径。
| 变量 | 说明 |
|---|---|
structure.readme |
自述文件名(默认为“README.md”) |
structure.summary |
摘要文件名(默认为“SUMMARY.md”) |
structure.glossary |
词汇表文件名(默认为“GLOSSARY.md”) |
structure.languages |
语言文件名(默认为LANGS.md) |
PDF选项
PDF输出可以使用book.json中的一组选项来定制：
| 变量 | 说明 |
|---|---|
pdf.pageNumbers |
将页码添加到每个页面的底部(默认为“true”) |
pdf.fontSize |
基本字体大小(默认为12) |
pdf.fontFamily |
基本字体系列(默认为Arial) |
pdf.paperSize |
纸张大小，选项为“a0”，“a1”，“a2”，“a3”，“a4”，“a5”，“a6”，“b0”，“b1”，“b2”，“b3” 'b4'，'b5'，'b6'，'legal'，'letter''(默认为'a4') |
pdf.margin.top |
顶部边距(默认为56) |
pdf.margin.bottom |
底边距(默认为56) |
pdf.margin.right |
右边距(默认为“62”) |
pdf.margin.left |
左边距(默认为“62”) |
作者: 雪之梦技术驿站
链接: https://snowdreams1006.github.io/gitbook-official/zh/config.html
来源: 雪之梦技术驿站
本文原创发布于「雪之梦技术驿站」,转载请注明出处,谢谢合作!
