rhrev is a comprehensive revision history tracking system for the AsciiDoc and Antora ecosystems which automatically creates a grouped, formatted table of document changes.
Supported Backends
-
asciidoctor-pdf
-
asciidoctor
-
Antora
-
Antora-Assembler to asciidoctor-pdf
Inspiration
This extension draws inspiration from:
-
DITA-like automatic revision histories - Darwin Information Typing Architecture (DITA) provides automatic change tracking and revision metadata management in technical documentation systems
-
LaTeX revision tracking tools - LaTeX packages like
changes,trackchanges, and custom revision history macros that automate change documentation in academic and technical publications -
Document management systems - Enterprise documentation platforms that maintain automatic audit trails and change histories
The goal was to bring similar automated revision tracking capabilities to the Asciidoctor ecosystem, with the added benefit of clickable page references and flexible customization options tailored for PDF technical documentation.
Documentation
Full documentation is published at https://baiyibai-antora.gitlab.io.
For configuration details, see doc/modules/ROOT/pages/usage.adoc.
Testing
Run the test suite:
./run-tests.shThis will generate PDFs for all test cases in the tests/ directory.
Ruby GEM Build Instructions (for 白一百 baiyibai)
gem build asciidoctor-pdf-rhrev.gemspec
gem install ./asciidoctor-pdf-rhrev-1.0.0.gemLicense
MIT License. See the LICENSE file for details.
Contributing
Contributions welcome! Please ensure all tests pass before submitting changes.
Copyright
Copyright © 2025-present 白一百 baiyibai
-
The image The «Public Domain Mark» icon from Creative Commons with transparent background. is in the public domain and taken from:
https://commons.wikimedia.org/wiki/File:Cc-public_domain_mark.svg
For the full text of the license, see the LICENSE file.