A simple Dockerfile for executing bookbinder on your system.
-
Download the
Dockerfile
to a local directory and change to that directory. -
Build and tag a new image:
$ docker build -t docs/bb .
-
Run the image using a command similar to:
$ docker run -it -p 9292:9292 -p 4567:4567 -v /my/workspace:/github docs/bb
Substitute your workspace, the local directory that you clone Github repositories into, for
/my/workspace
in the above command. -
Within the docker image, go to a directory containing your book configuration. Execute:
$ bundle install
-
Execute bookbinder commands to build or review your work, such as:
bundle exec bookbinder watch
- publishes book tolocalhost:4567
bundle exec bookbinder bind local
- creates book app in directoryfinal_app
using local source filesbundle exec bookbinder bind remote
- creates book app infinal_app
based on source from remote Github reposrackup
from a/final_app
directory - publishes book app tolocalhost:9292
- The docker image is only configured for building MarkDown content. DITA builds aren't yet supported.
- The docker image only works for local builds. You'll need to configure Github authentication within your local image to perform remote builds.