sphinxcontrib-confluencebuilder 3.0.0

Sphinx extension to build Atlassian Confluence Storage Markup

Atlassian Confluence Builder for Sphinx

Sphinx extension to build Confluence® compatible markup format files and optionally publish them to a Confluence instance.

Notice for Upcoming v3 Release

[!IMPORTANT] Users on Confluence Cloud upgrading to this extension's upcoming v3 release may require additional actions. See the following for more information:

sphinxcontrib-confluencebuilder v3 Cloud Users Notice

Requirements

• Confluence Cloud or Data Center 8.8+
• Python 3.10+
• Requests 2.30.0+
• Sphinx 8.0+

Installing

The recommended method to installing this extension is using pip:

pip install sphinxcontrib-confluencebuilder
 (or)
python -m pip install sphinxcontrib-confluencebuilder

For a more in-depth installation information, see also:

Atlassian Confluence Builder for Sphinx — Installation
https://sphinxcontrib-confluencebuilder.readthedocs.io/install

Usage

• Register the extension sphinxcontrib.confluencebuilder in the project's configuration script (conf.py):

extensions = [
    'sphinxcontrib.confluencebuilder',
]

• Run sphinx-build with the builder confluence:

sphinx-build -M confluence . _build -E -a
 (or)
python -m sphinx -M confluence . _build -E -a

For more information on the usage of this extension, see also:

Atlassian Confluence Builder for Sphinx — Tutorial
https://sphinxcontrib-confluencebuilder.readthedocs.io/tutorial

Configuration

The following is an example of a simple configuration for Confluence generation and publishing:

extensions = [
    'sphinxcontrib.confluencebuilder',
]
confluence_publish = True
confluence_space_key = 'TEST'
confluence_parent_page = 'Documentation'
confluence_server_url = 'https://intranet-wiki.example.com/'
confluence_ask_user = True
confluence_ask_password = True

For a complete list of configuration options, see also:

Atlassian Confluence Builder for Sphinx — Configuration
https://sphinxcontrib-confluencebuilder.readthedocs.io/configuration

Features

For a complete list of supported markup, extensions, etc.; see:

Atlassian Confluence Builder for Sphinx — Features
https://sphinxcontrib-confluencebuilder.readthedocs.io/features

For a complete list of directives supported by this extension, see:

Atlassian Confluence Builder for Sphinx — Directives
https://sphinxcontrib-confluencebuilder.readthedocs.io/directives

Demonstration

A demonstration of this extension can be seen by inspecting the published validation/testing documents found here:

Atlassian Confluence Builder for Sphinx — Online Demo on Confluence Cloud
https://sphinxcontrib-confluencebuilder.atlassian.net/

---

Atlassian Confluence Builder for Sphinx project is unaffiliated with Atlassian.
Atlassian is a registered trademark of Atlassian Pty Ltd.
Confluence is a registered trademark of Atlassian Pty Ltd.