wiki:Docs/Build

Version 6 (modified by Amar Takhar, on Jan 19, 2016 at 3:19:03 PM) (diff)

Notes about other targets and dependencies.

Build Documentation

This page explains how to build the documentation from source.

Prerequisites

You will need:

  • waf - The waf build system.
  • Sphinx - The Sphinx documentation system.

Extras

These dependencies are not required by default but are used for other targets.

Target Dependency
pdfTeX (pdflatex)
htmlsingleNode inliner

Sphinx

Note: Version 1.3 is the minimum version of Sphinx required.

Most UNIX distributions have a package for Sphinx. For manual installation refer to the Install Page on the Sphinx website.

Windows users can find detailed instructions on the Sphinx Website.

Getting Source

The source is located at:

Building

Each document can be built on its own by entering the directory and typing:

  # waf configure
  # waf build

This will build the default html target which is several split files.

Targets

Target Result
--pdfBuild PDF
--htmlsingleBuild a Single HTML file