所有的配置都以 JSON 格式存儲(chǔ)在名為 ?book.json? 的文件中。

你可以粘貼你的 book.json 去 jsonlint.com 驗(yàn)證 JSON 語(yǔ)法。

字段

gitbook

{ "gitbook": ">=2.0.0" }

這個(gè)選項(xiàng)是用來(lái)探測(cè)生成書本的 GitBook 的版本。格式是一個(gè) SEMVER 條件。

在 gitbook.com 中，這個(gè)值是根據(jù)平臺(tái)中輸入的標(biāo)題定義的。

description

{ "description": "This is such a great book!" }

這個(gè)選項(xiàng)定義了書本的描述，默認(rèn)是從 README（第一段）中提取的。

在 gitbook.com 中，這個(gè)值是根據(jù)平臺(tái)輸入的描述定義的。

isbn

{ "isbn": "978-3-16-148410-0" }

這個(gè)選項(xiàng)定義了你書本的ISBN。

language

{ "language": "en" }

這個(gè)選項(xiàng)定義了你書本的語(yǔ)言，默認(rèn)值是 en (英語(yǔ))。

這個(gè)值是用來(lái)做國(guó)際化和本地化的，它改變網(wǎng)站的文字。

在 gitbook.com 中，這個(gè)值是根據(jù)探測(cè)到的語(yǔ)言或指定的設(shè)置定義的。

direction

{ "direction": "rtl" }

這個(gè)選項(xiàng)是用來(lái)重新設(shè)置語(yǔ)言的文字方向的。建議將 language 字段設(shè)置為帶有正確的文字方向的語(yǔ)言。

styles

這個(gè)選項(xiàng)是用來(lái)自定義書本的 css 的。

例子：

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

plugins

{ "plugins": ["mathjax"] }

書本使用的插件列表被定義在 ?book.json? 的配置中。

pluginsConfig

{
    "plugins": ["myplugin"],
    "pluginsConfig": {
        "myPlugin": {
            "message": "Hello World"
        }
    }
}

structure

這個(gè)選項(xiàng)是用來(lái)覆蓋 GitBook 使用的路徑的。

例如你想要使用 INTRO.md 代替 README.md：

{
    "structure": {
        "readme": "INTRO.md"
    }
}

variables

{
    "variables": {
        "myTest": "Hello World"
    }
}

這個(gè)選項(xiàng)定義在 模板 中使用的變量值。