Question: Custom AsciiDoc macros

Hey everyone, and first of all thank you for this plugin, which is working great.

I was wondering if there’s any support to give the plugin a custom AsciiDoc macro that will be expanded when the plugin runs.

I am currently generating my API documentation using Spring REST Docs and it’s working fine, now I’d like to upload the same output to Confluence, however, the confluence-publisher plugin doesn’t know about the operations macro that is built-in Spring REST Docs.

Is there any support for Spring REST Docs, or at least custom AsciiDoc macros that could be passed to the AsciiDoc process so that my snippets are correctly rendered in-before going to be uploaded to Confluence ?

Thank you very much for any hindsight 👍

[zeldigas]

It might depend on the way you are using conf-publisher (cli or maven plugin), but overal all you need to do is to make sure that on it’s classpath there is a extension registry with macro you need.

You can find more details in this PR: https://github.com/confluence-publisher/confluence-publisher/pull/287/files:

1. service loader file https://github.com/confluence-publisher/confluence-publisher/pull/287/files#diff-5f908b61cd9292d3cb61ce8d86681f2911a4d09ac37029ded38e3d50fa889a43
2. registry itself: https://github.com/confluence-publisher/confluence-publisher/pull/287/files#diff-60407c447d46e736257e01ea881d48fb70842767ebce895421f6ff4930fe48df
3. macro implementation: https://github.com/confluence-publisher/confluence-publisher/pull/287/files#diff-6b0d3a6b9f5aab5839146c9c164b6cb696f8a68801e11ccc131e14917f948f32

[Aloren]

Thanks @zeldigas for quick tutorial! I was able to build my own extension easily. Also I would like to mention that if you are going to add your custom extension to the asciidoc-confluence-publisher-maven-plugin, you will need to do it like this:

<plugin>
  <!--See: https://confluence-publisher.atlassian.net/wiki/spaces/CPD/overview?mode=global-->
  <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>

This way you can add any extension to the Confluence publisher.