Skip to main content

reStructuredText-to-Confluence markup converter

Project description

https://travis-ci.org/netresearch/rst2confluence.svg?branch=master

Supported directives

  • bullet list

  • enumerated list

  • image, figure, confluence image galleries

  • definition list (with classifiers)

  • simple and grid tables

  • block quote

  • text effect

    • strong

    • emphasis

    • monospace

  • code blocks

  • links

  • admonitions

    • info

    • note

    • tip

    • warning

  • field lists

  • line blocks (except nested ones)

  • meta directives

  • substitutions

Additional features

Excerpts

When using the command line option --excerpt, your confluence code will mark up the first paragraph as excerpt.

Image galleries

Images and figures with class names that begin with gallery- form a gallery:

.. image:: cat.jpg
    :class: gallery-1
.. image:: dog.jpg
    :class: gallery-1
.. figure:: horse.jpg
    :class: gallery-2
    :scale: 50%

This creates two galleries: One with cat and dog, the other one with the horse picture only. All attributes are ignored on gallery images.

Gallery-classed images are converted to {gallery:include=a.jpg,b.jpg} Confluence markup.

Usage

./rst2confluence.py /path/to/file.rst

Installation

From git checkout:

$ sudo ./setup.py install

Without a git checkout:

$ pip install rst2confluence

Dependencies

  • python-docutils

  • colordiff (for running the tests)

Tests

We have some examples how rst2confluence should behave.

Check if it does what it should:

./run-tests.sh

Run a single test:

./run-test.sh test/figure.rst

Other tools

Use deploy-rst to automatically deploy rST documents into confluence.

Releasing a new version

  1. Fill ChangeLog

  2. Update version in setup.py

  3. Create release tag

  4. Upload to pip:

    $ ./setup.py sdist upload

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

rst2confluence-0.6.0.tar.gz (6.1 kB view details)

Uploaded Source

File details

Details for the file rst2confluence-0.6.0.tar.gz.

File metadata

File hashes

Hashes for rst2confluence-0.6.0.tar.gz
Algorithm Hash digest
SHA256 68c0554422db71c4f3364fa24861df8ded5dd4637ee5c42a5e9f645fbbfab6d8
MD5 1d1c84e7b3d7525554c5340bf5cc82a5
BLAKE2b-256 4fedfa64a680a1217dfb46fcb7108db384a2ada19cf87321234b44683d5f91e9

See more details on using hashes here.

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