# hibernate-asciidoctor-extensions

**Repository Path**: mirrors_hibernate/hibernate-asciidoctor-extensions

## Basic Information

- **Project Name**: hibernate-asciidoctor-extensions
- **Description**: Asciidoctor extensions developed for the Hibernate projects
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-08
- **Last Updated**: 2025-08-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Hibernate Asciidoctor extensions

This repository contains assorted Asciidoctor extensions developed for the Hibernate projects.

## Extensions

### Save preprocessed output

The point of this extension is to save the merged Asciidoc document after the includes have been processed.

It generates a single document with all the includes resolved, allowing to easily make a diff.

### Custom role block

This extension is quite specific: it's only usable with the DocBook output.

The goal is to preserve the custom roles used in the Asciidoc document in the DocBook output. Typically, we use it to keep the `#tck-testable#` information present in the Bean Validation specification.

### Custom numbering for examples and tables

The point of this extension is to restart the numbering of examples and tables for each section.

For instance, the reference of the third example of the 14th section will be `Example 14.3`.

## License

The source code is licensed under the Apache License version 2.0.

## Links

 * Issue tracker: https://github.com/hibernate/hibernate-asciidoctor-extensions/issues
 * Continuous integration: https://ci.hibernate.org/job/hibernate-asciidoctor-extensions/