Build the Documentation
This section describes how to build the OpenNMS docs 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, then 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 docs is as follows:
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:2.3.4-b6293 --stacktrace generate antora-playbook-local.yml
|You must have Docker installed to build the docs using this method.