28 lines
944 B
Markdown
28 lines
944 B
Markdown
# 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``
|
|
|