thomasweise/docker-bookbuilderpy repository overview

⁠thomasWeise/docker-bookbuilderpy⁠: A Docker Container for Building Electronic Books from Pandoc Markdown

⁠1. Introduction

This is a docker⁠ container intended for building electronic books from pandoc's markdown flavor⁠ by using pandoc⁠, Python⁠, and TeX Live⁠. It has pre-installed the Python package bookbuilderpy⁠ which provides an infrastructure and additional commands to deal with hierarchically structured books and documents.

Please read the documentation of bookbuilderpy⁠ regarding how to use this image as fully-automated book writing and publishing tool chain.

⁠2. Local Book Compilation

The container offers a wide variety of utils to build electronic books from markdown sources, which are all discussed in the documentation of bookbuildeR⁠. Here we just provide a very quick and ultra-short description about how you can run this container locally.

You can apply the bookbuildeR⁠ package locally to a book or document you write on your computer. In order to avoid installing all required software and even to avoid messing with R, you can use this docker container⁠ here that we have developed for this purpose. Docker⁠ is something like a light-weight virtual machine, and our container is basically a copy of a complete Linux installation with all required components that you can run on your local computer.

If you have Linux and docker installed on your system, all what it takes is the following command:

  docker run -v "INPUT_DIR":/input/ \
             -v "OUTPUT_DIR":/output/ \
             -t -i thomasweise/docker-bookbuilderpy BOOK_ROOT_MD_FILE

Here, it is assumed that

• INPUT_DIR is the directory where your book sources reside, let's say /home/my/book/sources/.
• BOOK_ROOT_MD_FILE is the root file of your book, say book.md (in which case, the full path of book.md would be /home/my/book/sources/book.md). Notice that you can specify only a single file, but this file can reference other files in sub-directories of INPUT_DIR by using commands such as \relative.input.
• OUTPUT_DIR is the output directory where the compiled files should be placed, e.g., /home/my/book/compiled/. This is where the resulting files will be placed.

And that's it. No software installation, besides docker, is required. The container brings all required tools, scripts, packages, and what not. Additionally, in the documentation of the bookbuilderpy⁠ package, you can find all extensions to the markdown language we introduce and how the whole build process can be automated by using continuous integration tool chains.

⁠3. License

This image source is located at https://github.com/thomasWeise/bookbuilderpy/⁠ and is licensed under the GNU GENERAL PUBLIC LICENSE Version 3, 29 June 2007, which you can find in file LICENSE.md⁠. The license applies to the way the image is built, while the software components inside the image are under the respective licenses chosen by their respective copyright holders.

⁠4. Contact

If you have any questions or suggestions, please contact Prof. Dr. Thomas Weise⁠ of the Institute of Applied Optimization⁠ at Hefei University⁠ in Hefei, Anhui, China via email to [email protected]⁠ and [email protected]⁠.