The code of the plugin was heavily inspired by antora-confluence
NOTE: This plugin is in an early phase. It is still in development.
This plugin aims to automatically publish your Antora docs into Confluence. By doing this we leverage the power of Confluence and the Confluence REST API to create and update pages in Confluence, which is a great way to keep your documentation up-to-date and in sync with your code. Most non technical stakeholders are using Confluence, so this plugin aims to make it easy for them to contribute to your documentation.
To install the plugin, you can use the following command in your Antora project:
npm install -D conflutoraINFO: The default output provider
fsin mandatory for the Confluence provider. Make sure to have thefsprovider in yourplaybook.ymlfile.
To use the plugin, you need to add it to your Antora project. You can do this by adding the following to your output section in playbook.yml:
output:
destinations:
- provider: fs
- provider: conflutora
confluence-url: https://<redacted>.atlassian.net
confluence-space-key: my-spacekeyFor full reference, please head over to the docs.
| Option | Description | Info |
|---|---|---|
| confluence-url | URL to your Confluence API endpoint | required |
| confluence-space-key | The Confluence space key to publish the pages to | required |
| confluence-ancestor-id | Specify the overall parent page for your docs. Needs to be the pageId of the parent page, not the DisplayName. | defaults to the space root |
output:
clean: true
dir: ./docs/site # Mandatory for the Confluence provider
destinations:
- provider: fs
- provider: "conflutora"
confluence-url: https://<redacted>.atlassian.net
confluence-space-key: my-spacekey
confluence-ancestor-id: 123456The plugin uses the CONFLUENCE_USERNAME and CONFLUENCE_PASSWORD to authenticate with the Confluence API. You can set these values in the environment variables.