Skip to main content

A command-line tool for building documentation from repositories into HTML files. Initially based on

Project description

build status code coverage

A tool for building a set of documentation files in HTML format, from a remote git repository containing markdown files.


The best way to install documentation-builder is with snap:

sudo snap install documentation-builder

If you don’t have snap on your system, you can also install it with pip3:

pip3 install ubuntudesign.documentation-builder

For more information see the documentation.


documentation-builder is a Python module. The main application code lives in ubuntudesign/documentation_builder. Updates to the markup or styling should be made in the default template.

Checking changes

To check your changes to documentation-builder, it’s probably easiest to install the module locally, in editable mode, within an encapsulated environment:

python3 -m venv env3 && source env3/bin/activate  # Create encapsulated environment
pip install -e .  # Install the module in editable mode

documentation-builder --source-folder docs  # build the documentation-builder's own documentation
xdg-open build/en/index.html  # Open up the documentation page

Watching for changes

On Ubuntu et al. you can use inotifywait to watch for changes to the source files, and rebuild when something changes as follows:

sudo apt install inotify-tools  # Ensure inotifywait is installed

# Force rebuild docs when anything changes in the source folder
while inotifywait -r -e close_write "./ubuntudesign"; do bin/documentation-builder --force --source-folder docs; done


To run tests:

./ test


To run a specific test:

./ test --addopts tests/

You can debug tests by adding a debugger to the code and running the test again.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for ubuntudesign.documentation-builder, version 1.6.2
Filename, size File type Python version Upload date Hashes
Filename, size ubuntudesign.documentation-builder-1.6.2.tar.gz (48.8 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page