GitBook

The sbt-site plugin has direct support for building GitBook projects. To enable GitBook site generation, simply enable the associated plugin in your build.sbt file:

enablePlugins(GitBookPlugin)

This assumes you have a GitBook project under the src/gitbook directory. To change this, set the sourceDirectory key in the GitBook scope:

sourceDirectory in GitBook := sourceDirectory.value / "doc"

Similarly, the output can be redirected to a subdirectory of target/site via the siteSubdirName key in GitBook scope:

// Puts output in `target/site/book`
siteSubdirName in GitBook := "book"

The plugin can also be configured to manage all GitBook setup and installation by configuring a dedicated directory in which GitBook’s npm packages can be installed.

gitbookInstallDir in GitBook := Some(baseDirectory.value / "node_modules" / "gitbook")