Configuration

    You can paste your book.json at jsonlint.com to validate the JSON syntax.

    All fields are optionals or default to some extracted values.

    gitbook

    This option is used to detect which version of GitBook will be use to generate the book.
    The format is a SEMVER condition.

    title

      This option defines the title of your book, by default this value is extracted from the README (first title).

      On gitbook.com, this value is defined from the title entered on the platform.

      description

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

      This option defines the description of your book, by default this value is extracted from the README (first paragraph).

      isbn

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

      This option defines the ISBN associated with your book

      language

      This option defines the language of your book, by default value is en.

      This option is used for internationalization and localization, it changes the text from the website.

      On gitbook.com, this value is defined from the language detected in the content or specified in the settings.

      direction

      1. { "direction": "rtl" }

      This option is used to override the text direction from the language.
      It is recommended to set the language field to a language with the correct text direction instead.

      styles

      This option is used to add custom css to your book.

      1. {
      2.     "styles": {
      3.         "website": "styles/website.css",
      4.         "ebook": "styles/ebook.css",
      5.         "pdf": "styles/pdf.css",
      7.         "epub": "styles/epub.css"
      8.     }
      9. }

      plugins

      1. { "plugins": ["mathjax"] }

      The list of plugins being used by a book is defined in the book.json configuration.

      pluginsConfig

      This option contains all plugins specific configurations.

      structure

      This option is used to override files paths used by GitBook.

      For example if you want to use INTRO.md instead of README.md:

      1.     "structure": {
      2.         "readme": "INTRO.md"
      3.     }
      4. }

      Structure types are , langs, summary and glossary.

      variables

      1. {
      2.     "variables": {
      3.         "myTest": "Hello World"
      4.     }
      5. }

      This option defines the variables values being used in .

      pdf

      1. {
      2.     "pdf": {
      3.         "headerTemplate": "Header of the PDF with _TITLE_",
      4.         "footerTemplate": "Footer HTML template. Available variables: _PAGENUM_, _TITLE_, _AUTHOR_ and _SECTION_."
      5. }