Build Docker Image

Sometimes the default image of asciibook cannot meet the needs, such as adding plugins, modifying fonts, or introducing other processing tools.


Building Docker image requires Docker knowledge. This is beyond the scope of this tutorial, please go to the official Docker documentation to view the relevant content.

For example, in the Plugin chapter we added the asciidoctor-diagram plugin. We can use the following Dockerfile to package its dependencies into an image:

# Replace TAG as you need, see
FROM asciibook/asciibook:TAG

RUN apt-get update && \
  apt-get install default-jre-headless && \
  gem install asciidoctor-diagram

Build docker image:

$ docker build . -t asciibook:custom

Then use the custom image to build asciibook:

$ docker run -it -v $(pwd):/asciibook asciibook/asciibook:custom bash
/asciibook # asciibook build