/
Extensions

Extensions

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