当前位置: 首页 > 文档资料 > GitBook 中文文档 >

配置

优质
小牛编辑
139浏览
2023-12-01

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文本的方向。可以是rtlltr,默认值取决于language 的值
gitbookGitBook的版本。使用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”)