amontaigu/gitbook repository overview

⁠docker-gitbook

⁠Purpose

A gitbook docker image to allow you to build and publish your documentation.

Available software:

• gitbook with pdf option thanks to calibre
• calibre required by gitbook for pdf generation
• npm required for gitbook
• lftp to upload your docs on a distant site
• git to get your doc source

⁠Usage

To build your documentation in a specific directory:

docker run -v /my_gitbook:/gitbook amontaigu/gitbook gitbook build docs html

To go inside the container an play with available commands in a shell:

docker run -it --rm --entrypoint=/bin/sh amontaigu/gitbook

⁠References and thanks

• https://www.gitbook.com/⁠
• https://hub.docker.com/_/node/⁠
• https://www.npmjs.com/package/gitbook⁠
• https://www.npmjs.com/package/gitbook-cli⁠
• https://github.com/Fellah/docker/blob/master/gitbook/Dockerfile⁠
• https://toolchain.gitbook.com/syntax/asciidoc.html⁠
• http://asciidoctor.org/docs/asciidoc-syntax-quick-reference/⁠
• https://youtu.be/1rKgVF5CEEY⁠
• https://calibre-ebook.com/download_linux⁠
• https://toolchain.gitbook.com/ebook.html⁠