diff options
| author | Samy Pessé <samypesse@gmail.com> | 2016-02-26 09:41:26 +0100 |
|---|---|---|
| committer | Samy Pessé <samypesse@gmail.com> | 2016-02-26 09:41:26 +0100 |
| commit | d3d64f636c859f7f01a64f7774cf70bd8ccdc562 (patch) | |
| tree | 4f7731f37c3a793d187b0ab1cd77680e69534c6c /docs/config.md | |
| parent | 4cb9cbb5ae3aa8f9211ffa3ac5e3d34232c0ca4f (diff) | |
| parent | eef072693b17526347c37b66078a5059c71caa31 (diff) | |
| download | gitbook-d3d64f636c859f7f01a64f7774cf70bd8ccdc562.zip gitbook-d3d64f636c859f7f01a64f7774cf70bd8ccdc562.tar.gz gitbook-d3d64f636c859f7f01a64f7774cf70bd8ccdc562.tar.bz2 | |
Merge pull request #1109 from GitbookIO/3.0.0
Version 3.0.0
Diffstat (limited to 'docs/config.md')
| -rw-r--r-- | docs/config.md | 37 |
1 files changed, 37 insertions, 0 deletions
diff --git a/docs/config.md b/docs/config.md new file mode 100644 index 0000000..060a9d0 --- /dev/null +++ b/docs/config.md @@ -0,0 +1,37 @@ +# Configuration + +GitBook allows you to customize your book using a flexible configuration. These options are specified in a `book.json` file. + +### Configuration Settings + +| Variable | Description | +| -------- | ----------- | +| `title` | Title of your book, default value is extracted from the README. On GitBook.com this field is pre-filled. | +| `description` | Description of your book, default value is extracted from the README. On GitBook.com this field is pre-filled. | +| `author` | Name of the author. On GitBook.com this field is pre-filled. | +| `isbn` | ISBN of the book | +| `language` | ISO code of the book's language, default value is `en` | +| `direction` | `rtl` or `ltr`, default value depends on the value of `language` | +| `gitbook` | [SemVer](http://semver.org) condition to validate which GitBook version should be used | +| `plugins` | List of plugins to load, See [the plugins section](plugins.md) for more details | +| `pluginsConfig` |Configuration for plugins, See [the plugins section](plugins.md) for more details | + +### PDF Options + +PDF Output can be customized using a set of options in the `book.json`: + +| Variable | Description | +| -------- | ----------- | +| `pdf.pageNumbers` | Add page numbers to the bottom of every page (default is `true`) | +| `pdf.fontSize` | Base font size (default is `12`) | +| `pdf.fontFamily` | Base font family (default is `Arial`) | +| `pdf.paperSize` | Paper size, options are `'a0', 'a1', 'a2', 'a3', 'a4', 'a5', 'a6', 'b0', 'b1', 'b2', 'b3', 'b4', 'b5', 'b6', 'legal', 'letter'` (default is `a4`) | +| `pdf.margin.top` | Top margin (default is `56`) | +| `pdf.margin.bottom` | Bottom margin (default is `56`) | +| `pdf.margin.right` | Right margin (default is `62`) | +| `pdf.margin.left` | Left margin (default is `62`) | + +### Plugins + +Plugins and their configurations are specified in the `book.json`. See [the plugins section](plugins.md) for more details. + |