# hibernate-asciidoctor-theme

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

## Basic Information

- **Project Name**: hibernate-asciidoctor-theme
- **Description**: The Asciidoctor theme used for the documentations of 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

# The Asciidoctor theme used for the documentations of the Hibernate projects

## Content

The theme contains:

 * In the [asciidoc](src/main/resources/asciidoc) subdirectory:
   * CSS and resources used to customize the HTML output
   * a complete PDF theme, including specific fonts
   * some docinfo files shared by several projects
 * In the [javadoc](src/main/resources/javadoc) subdirectory
   * CSS files for JavaDocs generated by different versions of JDK  

## Test

A test document is included to be able to test the output of the themes.

You can generate the test output in `target/asciidoctor` by running the following command:

```
mvn clean test
```

## Fonts

The ``Overpass-*-conums.ttf`` fonts are copies of the according Overpass font including the callout numbers characters of the ``mplus1mn-regular-ascii-conums.ttf`` font.

The Unicode range for the conums is `U+2460` - `U+2473`.

[FontForge](https://fontforge.github.io/) can be used to copy/paste the characters from one font to another and generate the new font.

See https://github.com/asciidoctor/asciidoctor-pdf/issues/409 for all the background about this issue.

## License

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

This repository also contains external resources:

 * a copy of the default Asciidoctor PDF theme as a reference - MIT license
 * the Overpass font - SIL OFL 1.1
 * several of the M+ fonts - see the included license file
 * the Font Awesome font and stylesheets - SIL OFL 1.1 and MIT license