Build the Documentation
This section describes how to build the OpenNMS documentation locally. We recommend that you do this to test major changes, particularly if adding a lot of new content or making significant revisions to existing content.
If you already know how to use Git, this is going to sound very familiar:
If the project that you are working on already has version branches, then you will want to set up local copies of those as well.
After you have cloned the repository to your local system, you can track its branches with the following command:
git checkout -b <local_branch_name> <remote_repo>/<remote_branch_name>
To install Antora, follow the instructions on the Antora website.
Transform the Antora repository into a documentation site using the
make docs command.
Antora creates an archive of the documentation in
build/site.zip, and an extracted version in
You can open the latter directly in your browser.
The generic path to a given version of the documentation is
You can also build the docs using a containerized version of Antora. To do so, run the following command in the repository’s root folder:
docker run --rm -v $(pwd):/antora opennms/antora:3.1.1-b8850 --stacktrace generate antora-playbook-local.yml
|You must have Docker installed to build the documentation using this method.|