Contents

Settings

You can apply a range of settings to how your books build in _data/settings.yml.

Electric Book Manager

These settings are not yet used. In future, we expect to use this setting to allow or disallow Electric Book Manager servers to access your book project.

electric-book-manager: enable electric-book-manager-key: “”

Variants

See Variants.

Masthead

These settings control the content of your masthead in web and app outputs. You can have different settings for web and app output. Your masthead can display:

For example:

web:
  masthead:
    content: page-title
app:
  masthead:
    content: breadcrumbs

Note that breadcrumbs slows your site build down significantly. So we recommend not using them for very big sites.

Pagination

Pagination is the links to the previous and next HTML pages in your books. By default these links appear at the bottom of each page.

You define pagination for web and app output separately, so that they can differ if you need them to.

See Pagination for details.

Epub settings

You’ll need to adjust the epub settings if you want to embed fonts or hide the epub’s nav element. See Epub output for details.

App settings

Among other things, this is where you enable a Google Play expansion file, if you need one for a large app. This is a rare need, so by default this is off (false).

google-play-expansion-file-enabled: false
google-play-public-api-key: ""

External media

If a large number of images makes your project too big, you can store your images in a separate location. See External media for details.