summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorSoreine <nicolas@gitbook.com>2016-05-17 16:35:16 +0200
committerSoreine <nicolas@gitbook.com>2016-05-17 16:37:13 +0200
commitf83975b0221d6a70ba2a23da431dbca7f5fab941 (patch)
tree24452c5688d516de391ae38ccadefef7bb2f5274 /docs
parent167d3957bf2caa1f46bc1b1ef5084fd468594c8d (diff)
downloadgitbook-f83975b0221d6a70ba2a23da431dbca7f5fab941.zip
gitbook-f83975b0221d6a70ba2a23da431dbca7f5fab941.tar.gz
gitbook-f83975b0221d6a70ba2a23da431dbca7f5fab941.tar.bz2
Mention the structure configuration variable
Diffstat (limited to 'docs')
-rw-r--r--docs/config.md13
1 files changed, 13 insertions, 0 deletions
diff --git a/docs/config.md b/docs/config.md
index 0b1e188..3dcfcb4 100644
--- a/docs/config.md
+++ b/docs/config.md
@@ -7,6 +7,7 @@ GitBook allows you to customize your book using a flexible configuration. These
| Variable | Description |
| -------- | ----------- |
| `root` | Path to the root folder containing all the book's files, except `book.json`|
+| `structure` | To specify paths for Readme, Summary, Glossary etc. See [Structure paragraph](#structure). |
| `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. |
@@ -32,6 +33,18 @@ Since version 3.0.0, GitBook can use themes. See [the theming section](themes/RE
| -------- | ----------- |
| `theme` | The theme to use for the book |
+### Structure
+
+In addition to the `root` variable, you can tell Gitbook where to find files for Readme, Summary, Glossary, Languages (instead of using the default paths such as `README.md`).
+These paths are relative to `root` of each book, and can be extended in every language's `book.json`.
+
+| Variable | Description |
+| -------- | ----------- |
+| `structure.readme` | Path to the Readme file (defaults to `README.md`) |
+| `structure.summary` | Path to the Summary file (defaults to `SUMMARY.md`) |
+| `structure.glossary` | Path to the Glossary file (defaults to `GLOSSARY.md`) |
+| `structure.languages` | Path to the Languages file (defaults to `LANGS.md`) |
+
### PDF Options
PDF Output can be customized using a set of options in the `book.json`: