diff options
| author | Samy Pesse <samypesse@gmail.com> | 2016-02-29 21:50:48 +0100 |
|---|---|---|
| committer | Samy Pesse <samypesse@gmail.com> | 2016-02-29 21:50:48 +0100 |
| commit | c08e5ce62c30cb8d014151448bfe6da6b5a47fcf (patch) | |
| tree | fd9504c00d46786aebe2c65c6a95fa62edb363a7 /docs/themes.md | |
| parent | ec353e179dedf1ebf1ab6e54f6217a88d087ea75 (diff) | |
| download | gitbook-c08e5ce62c30cb8d014151448bfe6da6b5a47fcf.zip gitbook-c08e5ce62c30cb8d014151448bfe6da6b5a47fcf.tar.gz gitbook-c08e5ce62c30cb8d014151448bfe6da6b5a47fcf.tar.bz2 | |
Improve structure of doc
Diffstat (limited to 'docs/themes.md')
| -rw-r--r-- | docs/themes.md | 26 |
1 files changed, 0 insertions, 26 deletions
diff --git a/docs/themes.md b/docs/themes.md deleted file mode 100644 index 48c19db..0000000 --- a/docs/themes.md +++ /dev/null @@ -1,26 +0,0 @@ -# Theming - -Since version 3.0.0, GitBook can be easily themed. Books are using by default the [theme-default](https://github.com/GitbookIO/theme-default). - -The theme to use is specified in the [book's configuration](config.md) using key `theme`. - -> **Caution**: Custom theming can block some plugins from working correctly. - -### Structure of a theme - -A theme is a folder containing templates and assets. All the templates are optionnal, since theme are always extending the default theme. - -| Folder | Description | -| -------- | ----------- | -| `_layouts` | Main folder containing all the templates | -| `_layouts/website/page.html` | Template for a normal page | -| `_layouts/ebook/page.html` | Template for a normal page during ebook generation (PDF< ePub, Mobi) | - - -### Extend/Customize theme in a book - -Authors can extend the templates of a theme directly from the book source (without creating an external theme). Templates will be resolved in the `_layouts` folder of the book first, then in - -### Publish a theme - -Themes are published as plugins ([see related docs](plugins.md)) with a `theme-` prefix. For example the theme `awesome` will be loaded from `theme-awesome` plugin, and then from `gitbook-plugin-theme-awesome` NPM package. |