Download

Prerequisites

First install Liquibase.

Installation

CLI usersMaven usersGradle users

1. Locate the Liquibase installation folder (subsequently called LIQUIBASE_HOME)
2. Download the extension JAR (from GitHub or Maven Central)
3. Place the JAR in the lib folder of LIQUIBASE_HOME
4. Run liquibase --version, the extension should be listed

Tip

Maven Central remains the recommended download location. It includes PGP, MD5 and SHA-1 files to validate the integrity of the downloadable artefact.

Regular usersLiquibase plugin users

Make sure to add the liquibase-asciidoc dependency as follows, alongside your other dependencies.

<dependency>
    <groupId>net.biville</groupId>
    <artifactId>liquibase-asciidoc</artifactId>
    <version>0.1.0</version>
</dependency>

Info

The extension requires the org:liquibase:liquibase-core dependency to be included. If you are a Spring Framework or Spring Boot user for instance, liquibase-core is likely a transitive dependency and may not appear directly in your project file. Make sure liquibase-core is resolved in your dependency tree (run mvn dependency:tree to display the latter).

Make sure to add the liquibase-asciidoc dependency to the plugin definition.

<plugin>
    <groupId>org.liquibase</groupId>
    <artifactId>liquibase-maven-plugin</artifactId>
    <version>4.20.0</version>
    <dependencies>
        <dependency>
            <groupId>net.biville</groupId>
            <artifactId>liquibase-asciidoc</artifactId>
            <version>0.1.0</version>
        </dependency>
    </dependencies>
</plugin>

Regular usersLiquibase plugin users

Make sure to add the liquibase-asciidoc dependency as follows, alongside your other dependencies.

runtimeOnly 'net.biville:liquibase-asciidoc:0.1.0'

Info

The extension requires the org:liquibase:liquibase-core dependency to be included. If you are a Spring Framework or Spring Boot user for instance, liquibase-core is likely a transitive dependency and may not appear directly in your project file. Make sure liquibase-core is resolved in your dependency tree (run gradle -q dependencies to display the latter).

Make sure to add the liquibase-asciidoc dependency as follows.

liquibaseRuntime 'net.biville:liquibase-asciidoc:0.1.0'