1. 简述

本章主要介绍一下 Gitbook 中的相关配置以及说明。

Gitbook 使用了可选的 JSON 格式的配置文件来自定义书籍和文档的配置，这些配置选项通过 Gitbook项目根目录下的 book.json 文件来进行配置和指定。如果对 JSON 语法不熟悉的读者，可以参考：https://www.w3school.com.cn/json/json_syntax.asp 。

2. 配置概览

3. 配置示例

3.1. 基础配置

Gitbook 基础的配置信息，通过下面的这个方式直接配置在 book.json 中。

参考示例：

{
    "root":".",
    "author":"JiangMing",
    "title":"JiangMing Gitbook",
    "language":"zh-hans",
    "description":"This is gitbook",
    "isbn":"000-0-00-000000-0",
    "direction":"ltr",
    "gitbook":">=3.2.3"
}

3.2. structure 结构配置

除了 root 变量，你可以通过 structure 告诉Gitbook [Readme]，[Summary]，[Glossary]，[Languages]的文件名(而不是使用默认名称，如README.md)。这些文件必须在您的书籍项目的根目录。不接受像 doc/README.md 这样的子目录路径。

参考示例：

{
    "structure":{
        "readme":"README.md",
        "summary":"SUMMARY.md",
        "glossary":"GLOSSARY.md",
        "languages":"LANGS.md" // 注意默认已经配置，在 gitbook—V3.2.3版本配置会报错, 可忽略
    }
}

3.3. variables 变量配置

定义一些书籍中的变量信息，定义在 book.json 中的变量可以在 book 作用域下被访问，如：{{ book.blog }} 双括号语法在 书籍中 获取其中的数值。

参考示例：

{
    "variables":{
        "blog":"https://blog.csdn.net/ming_97y"
    }
}

3.4. links 链接导航

通过 links 配置在左侧导航栏添加指定的链接导航，如：添加自己的博客链接，GIthub链接等等...

参考示例：

{
    "links":{
        "sidebar":{
            "Blog":"https://blog.csdn.net/ming_97y",
            "Github":"https://github.com/jiangminggithub"
        }
    }
}

3.5. styles 自定义样式

通过 styles 配置这个选项用来自定义书本的 css 的。

参考示例：

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

3.6. pdf 参数配置

PDF输出可以使用book.json中的 pdf 来进行配置：

参考示例：

{
    "pdf":{
        "pageNumbers":true,
        "fontFamily":"Arial",
        "fontSize":12,
        "paperSize":"a4",
        "margin":{
            "right":62,
            "left":62,
            "top":56,
            "bottom":56
        }
    }
}

3.7. plugins 插件列表

通过 plugins 配置可以配置书籍需要的插件列表。

参考示例：

{
    "plugins": [
        "github",
        "splitter",
        ...
    ]
}

3.8. pluginsConfig 插件配置

通过 插件配置 可以配置插件列表plugins中对应插件的一些配置选项信息。

参考示例：

{
    "plugins": ["github"],
    "pluginsConfig": {
        "github": {
            "url": "https://github.com"
        }
    }
}

4. 参考配置示例

下面的这个是一个简单的 book.json 的配置，可供参考。

{
    "root": ".",
    "author": "JiangMing",
    "title": "JiangMing Gitbook",
    "language": "zh-hans",
    "description": "This is gitbook",
    "isbn": "000-0-00-000000-0",
    "direction": "ltr",
    "gitbook": ">=3.2.3",
    "structure": {
        "readme": "README.md",
        "summary": "SUMMARY.md",
        "glossary": "GLOSSARY.md"
    },
    "variables": {
        "blog": "https://blog.csdn.net/ming_97y"
    },
    "links": {
        "sidebar": {
            "Blog": "https://blog.csdn.net/ming_97y",
            "Github": "https://github.com/jiangminggithub"
        }
    },
    "styles": {
        "website": "styles/website.css",
        "ebook": "styles/ebook.css",
        "pdf": "styles/pdf.css",
        "mobi": "styles/mobi.css",
        "epub": "styles/epub.css"
    },
    "pdf": {
        "pageNumbers": true,
        "fontFamily": "Arial",
        "fontSize": 12,
        "paperSize": "a4",
        "margin": {
            "right": 62,
            "left": 62,
            "top": 56,
            "bottom": 56
        }
    },
    "plugins": [
        "-lunr",
        "-search",
        "advanced-emoji",
        "search-plus",
        "github",
        "splitter",
        "anchor-navigation-ex",
        "chapter-fold",
        "expandable-chapters-small",
        "code",
        "alerts",
        "insert-logo",
        "flexible-alerts"
    ],
    "pluginsConfig": {
        "github": {
            "url": "https://github.com"
        },
        "insert-logo": {
            "url": "jim-logo.png",
            "style": "background: none; max-height: 100px; min-height: 30px"
        },
        "flexible-alerts": {
            "style": "callout",
            "comment": {
                "label": "Comment",
                "icon": "fa fa-comments",
                "className": "info"
            }
        }
    }
}

5. 总结

到此就完成了 Gitbook 中关于配置文件的相关介绍，了解玩这些配置，就可以更好的去配置和使用 Gitbook 来完成自己的电子书籍的书写了。

参考： 官网说明