rvanrooy / sphinx-doc-docker

Sphinx documentation (LaTeX + HTML themes)

General

Dockerfile with:

• Sphinx documentation tool (version 1.3.1)
• LaTeX
• HTML themes from http://docs.writethedocs.org/tools/sphinx-themes

Build image

$ docker build -t sphinx-doc .

Run

Mounts a host directory (/host-dir-with-sphinx-doc) as a container volume (/doc).

$ docker run -i -t -v /host-dir-with-sphinx-doc:/doc sphinx-doc

$ cd /doc

To create Sphinx project:

$ sphinx-quickstart

To create a pdf:

$ make latexpdf

To create a html document:

$ make html