The Confluence Publisher supports AsciiDoctorJ Extensions. These need to be written in Java, and build into a jar file as outlined in the AsciiDoctorJ Extension Guide.

Extensions in Maven

In maven extensions can be added by extending the classpath of the maven plugin.

<plugin>
  <groupId>org.sahli.asciidoc.confluence.publisher</groupId>
  <artifactId>asciidoc-confluence-publisher-maven-plugin</artifactId>
  <version>${asciidoc-confluence-publisher-maven-plugin.version}</version>
  <dependencies>
    <dependency>
      <groupId>my-extension-group-id</groupId>
      <artifactId>my-extension-artifact-id</artifactId>
      <version>my-extension-version</version>
    </dependency>
  </dependencies>
</plugin>

Extensions in the Docker Image

Once the extension has been written it can be put into the /opt/extensions folder inside the provided container image and they will be automatically loaded.

For example:

docker run --rm -e ROOT_CONFLUENCE_URL=http://confluence-host \
   -v /extension.jar:/opt/extensions/extension.jar \
   -e SKIP_SSL_VERIFICATION=false \
   -e MAX_REQUESTS_PER_SECOND=10 \
   -e CONNECTION_TIME_TO_LIVE=500 \
   -e USERNAME=username \
   -e PASSWORD=1234 \
   -e SPACE_KEY=XYZ \
   -e ANCESTOR_ID=012345 \
   -e PAGE_TITLE_PREFIX="Draft - " \
   -e PAGE_TITLE_SUFFIX=" (V 1.0)" \
   -e PUBLISHING_STRATEGY=REPLACE_ANCESTOR \
   -e ORPHAN_REMOVAL_STRATEGY=KEEP_ORPHANS \
   -e VERSION_MESSAGE="V 1.0" \
   -e NOTIFY_WATCHERS=true \
   -e ATTRIBUTES='{"attribute1": "value1", "attribute2": "value2"}' \
   -e PROXY_SCHEME=https \
   -e PROXY_HOST=my.proxy.com \
   -e PROXY_PORT=8443 \
   -e CONVERT_ONLY=false \
   -v /absolute/path/to/asciidoc-root-folder:/var/asciidoc-root-folder \
   confluencepublisher/confluence-publisher:0.0.0-SNAPSHOT

Confluence Publisher Documentation

Extensions

Extensions in Maven

Extensions in the Docker Image

Related content