https://github.com/confluence-publisher/confluence-publisher

Maven plugin and Docker image to convert AsciiDoc and publish it to Confluence
https://github.com/confluence-publisher/confluence-publisher

asciidoc confluence docker maven

Last synced: 5 months ago
JSON representation

Maven plugin and Docker image to convert AsciiDoc and publish it to Confluence

• Host: GitHub
• URL: https://github.com/confluence-publisher/confluence-publisher
• Owner: confluence-publisher
• License: apache-2.0
• Created: 2016-04-24T18:44:05.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2025-05-16T13:52:23.000Z (about 1 year ago)
• Last Synced: 2025-05-16T14:48:31.376Z (about 1 year ago)
• Topics: asciidoc, confluence, docker, maven
• Language: Java
• Homepage:
• Size: 2.73 MB
• Stars: 233
• Watchers: 13
• Forks: 92
• Open Issues: 120
• Metadata Files:
  • Readme: README.adoc
  • Contributing: CONTRIBUTING.md
  • License: LICENSE.txt

Awesome Lists containing this project

• awesome-github-repos - confluence-publisher/confluence-publisher - Maven plugin and Docker image to convert AsciiDoc and publish it to Confluence (Java)

README

          
image:https://img.shields.io/maven-central/v/org.sahli.asciidoc.confluence.publisher/asciidoc-confluence-publisher-maven-plugin.svg["Maven Central", link="https://search.maven.org/artifact/org.sahli.asciidoc.confluence.publisher/asciidoc-confluence-publisher-maven-plugin"]

image:https://github.com/confluence-publisher/confluence-publisher/actions/workflows/ci.yml/badge.svg["Build Status", link="https://github.com/confluence-publisher/confluence-publisher/actions/workflows/ci.yml"]

image:https://coveralls.io/repos/github/confluence-publisher/confluence-publisher/badge.svg?branch=master["Coverage Status", link="https://coveralls.io/github/confluence-publisher/confluence-publisher?branch=master"]

= Confluence Publisher

The Confluence Publisher allows documentation written in AsciiDoc and versioned directly with the documented code base

to be published to a Confluence space. It supports a "docs-as-code" approach.

It converts the resulting AsciiDoc HTML output to XHTML compatible with

Confluence, manages included resources as Confluence attachments and ensures that only content modified since the last

publication is again re-published.

== Vision and Scope

The Confluence Publisher shall support writing conceptual and technical documentation such as design/architecture/product

documentation. In doing so, it tries to balance a useful feature set with acceptable maintenance efforts for the software

itself.

As a consequence, the Confluence Publisher does neither aim to support every concept from AsciiDoc nor every feature or 

macro found in Confluence.

== Documentation

The documentation of the current release version is published to https://confluence-publisher.atlassian.net/wiki/spaces/CPD/overview[https://confluence-publisher.atlassian.net].

== Contributing

Contributions are highly appreciated. In order to avoid lost efforts, consider first opening an issue describing

your idea/requirement and discuss whether the feature fits the vision and scope of the Confluence Publisher.

Please see the link:CONTRIBUTING.md[contribution guide] for instructions on how to build the Confluence Publisher 

locally and what to check before sending a pull request. 

== Acknowledgments

https://www.jetbrains.com/?from=confluence-publisher[JetBrains] kindly supports the core developers with free open-source licenses for their products.