Releases: dataliquid/asciidoc-maven-plugin
v0.4.2
AsciiDoc Maven Plugin v0.4.2
This release adds configurable YAML tag mapping for rendered output.
New Features
- Configurable YAML Tag Mapping (#50) - Map YAML tags in rendered output
- Configure tag mappings via
yamlTagMappingsparameter in RenderMojo - Output rendered AsciiDoc content with custom tags (e.g.,
!asciidoc→!html) - Fully backward compatible - no tags output when mapping not configured
- Supports literal block style (
|-) for multiline content
- Configure tag mappings via
Requirements
- Java 17 or higher
- Maven 3.9 or higher
Configuration Example
<configuration>
<yamlTagMappings>
<asciidoc>html</asciidoc>
</yamlTagMappings>
</configuration>Example
Input:
content: !asciidoc |
This is a test.Output (with mapping):
content: !html |-
<div class="paragraph">
<p>This is a test.</p>
</div>Output (without mapping):
content: |-
<div class="paragraph">
<p>This is a test.</p>
</div>v0.4.1
AsciiDoc Maven Plugin v0.4.1
This release adds support for pass-through of unknown YAML tags and includes dependency updates.
New Features
- Unknown YAML Tag Pass-Through (#48) - Process YAML files with unknown tags without errors
- Unknown YAML tags (e.g.,
!html:template,!custom:meta) are preserved in output - No more
ConstructorExceptionwhen encountering unknown tags - Works automatically - no configuration required
!asciidoccontent continues to be rendered to HTML
- Unknown YAML tags (e.g.,
Improvements
- Dependency Update (#47) - Updated JUnit Jupiter from 5.13.4 to 6.0.0
- Latest testing framework version
- Improved test reliability and performance
Requirements
- Java 17 or higher
- Maven 3.9 or higher
Example
Input:
template: !html:template "<div>Content</div>"
content: !asciidoc |
== TestOutput:
template: !html:template '<div>Content</div>'
content: |-
<div class="sect1">
<h2 id="_test">Test</h2>
</div>v0.4.0
AsciiDoc Maven Plugin v0.4.0
This release introduces YAML AsciiDoc linting support, allowing validation of AsciiDoc content embedded within YAML files.
New Features
- YAML AsciiDoc Linting (#45) - Added capability to lint AsciiDoc content embedded within YAML files
- Validate AsciiDoc blocks marked with
!asciidoctags in YAML files - Preserve YAML path context in error messages for better debugging
- Consistent behavior with YAML rendering support
- Validate AsciiDoc blocks marked with
Improvements
- Code Simplification - Enhanced YamlAsciiDocProcessor with simplified constructor
- Added extraction-only mode for linting operations
- Cleaner separation between rendering and linting concerns
- Improved code maintainability
Requirements
- Java 17 or higher
- Maven 3.9 or higher
v0.3.0
AsciiDoc Maven Plugin v0.3.0
This release introduces YAML AsciiDoc rendering support, SafeMode configuration for AsciidoctorJ, and various dependency updates.
New Features
-
YAML AsciiDoc Support (#43) - Added capability to render AsciiDoc content embedded within YAML files
- Process AsciiDoc blocks in YAML configuration files
- Seamlessly integrate documentation within YAML structures
-
SafeMode Configuration (#36) - Added SafeMode configuration support for AsciidoctorJ processing
- Configure AsciidoctorJ security settings
- Control the level of access to filesystem and external resources
- Default to UNSAFE mode for backward compatibility
Improvements
-
Build Configuration (#34, #29) - Modernized Maven compiler configuration
- Replaced maven.compiler.release with source/target properties for better compatibility
- Updated to use modern compiler settings
-
Code Quality (#27) - Enhanced code formatting and documentation
- Applied consistent code formatting with formatter-maven-plugin
- Improved JavaDoc documentation structure
Dependency Updates
- parent-oss: 2.1.0 → 2.2.4
- asciidoc-linter: 0.4.0 → 0.5.0
- jackson: 2.19.2 → 2.20.0
- json-schema-validator: 1.5.8 → 1.5.9
- mockito-core: 5.19.0 → 5.20.0
Requirements
- Java 17 or higher
- Maven 3.9 or higher
v0.2.0
AsciiDoc Maven Plugin v0.2.0
This release includes enhanced linting capabilities, improved console output formatting, and various dependency updates.
New Features
-
Enhanced Console Output (#24) - Improved linter output with underlines, suggestions, and configurable formatting
- Added
consoleOutputFormatparameter (standard/enhanced) for output control - Added
maxSuggestionsPerErrorparameter to limit suggestions per error - Visual underlines showing exact error locations in the source
- Better error context with line numbers and snippets
- Added
-
Improved Linting (#22) - Updated to asciidoc-linter 0.4.0 with enhanced validation capabilities
- Better placeholder enforcement
- More comprehensive rule validation
Bug Fixes
- Diagram Generation (#20) - Fixed diagram generation in project root directory
- Test Coverage (#6) - Added comprehensive test coverage for ValidateMojo
Dependency Updates
- asciidoc-linter: 0.1.0 → 0.4.0
- commons-io: 2.19.0 → 2.20.0
- jackson: 2.19.1 → 2.19.2
- json-schema-validator: 1.4.3 → 1.5.8
- junit-jupiter: 5.13.3 → 5.13.4
- jsonassert: 1.5.1 → 1.5.3
- maven: 3.9.10 → 3.9.11
- mockito-core: 5.18.0 → 5.19.0
- plexus-xml: 3.0.0 → 4.1.0
- slf4j-simple: 2.0.12 → 2.0.17
Requirements
- Java 17 or higher
- Maven 3.9 or higher
v0.1.0
AsciiDoc Maven Plugin v0.1.0
Initial release of the AsciiDoc Maven Plugin for processing AsciiDoc files with advanced features.
Features
- AsciidoctorJ Integration - Full AsciiDoc to HTML rendering
- Incremental Builds - SHA-256 based change detection for efficient builds
- Diagram Support - PlantUML, Ditaa, Graphviz rendering (SVG/PNG formats)
- YAML Front Matter - Metadata extraction and JSON schema validation
- StringTemplate4 - Custom templating support for flexible output
- AsciiDoc Linting - Comprehensive validation with asciidoc-linter integration
Maven Goals
render- Convert AsciiDoc files to HTML with template supportvalidate- Validate YAML front matter against JSON schemalint- Comprehensive AsciiDoc validation and style checking
Requirements
- Java 17 or higher
- Maven 3.9 or higher
Installation
<plugin>
<groupId>com.dataliquid.maven</groupId>
<artifactId>asciidoc-maven-plugin</artifactId>
<version>0.1.0</version>
</plugin>