README
This directory contains the MiniZinc documentation.
Building the docs
You need the following tools to build the documentation:
- Python 3
- GNU make
- Sphinx version 1.8.0. Install it using the command
pip install git+https://github.com/sphinx-doc/sphinx - Sphinx Read The Docs html theme. Install it using the command
pip install sphinx_rtd_theme - If you want to build the PDF documentation, you also need a LaTeX distribution that includes xetex, and install the following fonts: Charter, Lato and Inconsolata.
To build the HTML documentation, simply run make html. To build the PDF, run make latexpdf.
Including the MiniZinc library reference documentation
The reference documentation for the MiniZinc library can be generated automatically from the source code. Then run the following command:
mzn2doc --rst-output --include-stdlib --output-base en ../share/minizinc/std/globals.mzn