Skip to content

Releases: dataliquid/asciidoc-maven-plugin

v0.4.2

08 Oct 19:57

Choose a tag to compare

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 yamlTagMappings parameter 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

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

08 Oct 19:56

Choose a tag to compare

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 ConstructorException when encountering unknown tags
    • Works automatically - no configuration required
    • !asciidoc content continues to be rendered to HTML

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 |
  == Test

Output:

template: !html:template '<div>Content</div>'
content: |-
  <div class="sect1">
  <h2 id="_test">Test</h2>
  </div>

v0.4.0

02 Oct 19:04

Choose a tag to compare

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 !asciidoc tags in YAML files
    • Preserve YAML path context in error messages for better debugging
    • Consistent behavior with YAML rendering support

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

02 Oct 17:55

Choose a tag to compare

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

19 Aug 11:16

Choose a tag to compare

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 consoleOutputFormat parameter (standard/enhanced) for output control
    • Added maxSuggestionsPerError parameter to limit suggestions per error
    • Visual underlines showing exact error locations in the source
    • Better error context with line numbers and snippets
  • 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

10 Jul 22:08

Choose a tag to compare

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 support
  • validate - Validate YAML front matter against JSON schema
  • lint - 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>