Skip to content

Latest commit

 

History

History

Docker

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 

A simple Dockerfile for executing bookbinder on your system.

Procedure

  1. Download the Dockerfile to a local directory and change to that directory.

  2. Build and tag a new image:

    $ docker build -t docs/bb .
  3. 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.

  4. Within the docker image, go to a directory containing your book configuration. Execute:

    $ bundle install
  5. Execute bookbinder commands to build or review your work, such as:

    • bundle exec bookbinder watch - publishes book to localhost:4567
    • bundle exec bookbinder bind local - creates book app in directory final_app using local source files
    • bundle exec bookbinder bind remote - creates book app in final_app based on source from remote Github repos
    • rackup from a /final_app directory - publishes book app to localhost:9292

Limitations

  • 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.