Skip to content


Repository files navigation

License Build Status

Table of Contents


This project contains documentation source for SIMP, a compliance-management framework built on Puppet.


Setup requirements

  • Python 3 & pip (for building the docs)
  • Ruby 2.4+ & bundler (for rake tasks)

You may need some additional OS packages for building PDFs with sphinx

Beginning with simp-doc

Install python dependencies:

virtualenv venv
source venv/bin/activate

pip install --upgrade pip setuptools
pip install -r requirements.txt

Install ruby dependencies:



Common build tasks are automated with rake (installed by bundler).

  • To list all available build tasks, run: rake -T.
  • To read documentation on a task, run: rake -D <task name>.

Building the docs

Building the docs as an HTML site (generates directory structure under html/)

bundle exec rake docs:html

After building the HTML docs, you can run a local HTTP server to view them locally:

# run a local web server to view HTML docs on http://localhost:5000
rake docs:server[5000]

Build HTML docs, specifying a local simp-core repository (this will avoid downloading simp.spec from GitHub):

SIMP_CORE_PATH=/path/to/simp-core rake docs:html

Build HTML docs for a specific SIMP version, as specified by a tag/branch:

SIMP_BRANCH='6.4.0-0' rake docs:html

Packaging the simp-doc RPM

Special considerations on EL6

If you want to build the RPM on EL6 systems, you will need to ensure that the SCL and python versions are appropriately available using the following repositories and check the RPM spec file for the relevant required packages.

name=CentOS-6 - SCLo sclo

name=CentOS-6 - SCLo rh

name=CentOS-$releasever - Extras


Build process

simp-doc build workflow

Environment variables


Path to a local simp-core git repository. Can be used to test new revisions of the simp-core Changelog.rst. This defaults to ../.. under the assumption that this repository has been checked out as part of the simp-core SIMP ISO build.

SIMP_CORE_PATH=$PWD/../simp-core rake docs:html


Sets the tag/branch to use when automatically downloading simp.spec from the simp-core GitHub repository. The downloaded simp.spec file will be read to determine the SIMP release and version variables used while building the docs. If unset, the branch will default to master.

SIMP_BRANCH=6.4.0-0 rake docs:html

CAUTION: SIMP_BRANCH is used only to determine the URL to download from GitHub. It does not directly set the SIMP release and version used when building the documentation.

Managing Sphinx prerequisites with pip

If you are using PyPi to manage python packages, you may need to run something like the following:

# simp install
sudo pip install -q -r requirements.txt

# upgrading (needed in some cases when rst2pdf prereqs get stuck)
sudo pip install --upgrade --force-reinstall  -r requirements.txt -v

The prerequisites for rst2pdf may require extra OS packages:

# fedora 24
sudo dnf install -y libjpeg-devel zlib-devel python-devel

# centos 7
sudo yum install -y libjpeg-devel zlib-devel python-devel

# Debian 8.5 (containers)
sudo apt-get install -y python-dev zlib1g-dev libjpeg-dev