Skip to main content

Sphinx extension to output Atlassian Confluence Storage Markup documents and publish to Confluence instances.

Project description

pip Version Build Status Documentation Status PyPI download month

Sphinx extension to build Confluence storage format files and optionally publish them to a Confluence instance.

Requirements

If publishing:

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

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 -b confluence . _build/confluence -E -a
 (or)
python -m sphinx -b confluence . _build/confluence -E -a

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

Atlassian Confluence Builder for Sphinx - Tutorial

Configuration

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

extensions = ['sphinxcontrib.confluencebuilder']
confluence_publish = True
confluence_space_name = '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

Directives

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

Atlassian Confluence Builder for Sphinx - Directives

Demonstration

The set of example documents used to assist in validation/testing can be found here:

Atlassian Confluence Builder for Sphinx - Validation Set

The active and older versions of published validation documents can be found here:

Atlassian Confluence Builder for Sphinx - Online Demo on Confluence Cloud

Compatibilities

For a complete list of supported markup, extensions, etc.; consult the following:

Atlassian Confluence Builder for Sphinx - Compatibilities

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sphinxcontrib-confluencebuilder-1.5.0.tar.gz (76.6 kB view hashes)

Uploaded Source

Built Distribution

sphinxcontrib_confluencebuilder-1.5.0-py2.py3-none-any.whl (87.8 kB view hashes)

Uploaded Python 2 Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page