A tool to convert and upload markdown documents into Atlassian Confluence
Project description
confluence-pusher
A tool to convert and upload markdown documents into Atlassian Confluence using Atlassian Python API.
How it works
The flow
File conversion
Please note that Confluence can't create two documents with the same name in the same space, for example: folder /Build and file named build.md
It looks over the folder defined in SOURCE_FOLDER parameter in config.json and then traversing it looking for markdown files. The folder and document structure are being replicated in Confluence as follows with the document conversion being performed by Pandoc using this custom filter:
Local filesystem | Action |
---|---|
SOURCE_FOLDER: | Root document as defined by SOURCE_FOLDER parameter in config.json |
- file01.md | Markdown file to be converted into nesting document under SOURCE_FOLDER name |
- file02.md | The markdown headers are being read during the conversion. If not available, file02 is going to be used with markdown file extension dropped |
- README.md | Will be converted in root document content |
- directory01: | Section document |
-- file03.md | Markdown file to be converted into nesting document under directory01 name with the same rules as above |
-- README.md | Will be converted in section content. The section document is to be renamed with markdown header if available |
Before you begin
Configure Confluence API token here. More help here.
Install
Install from PyPi:
pip install confluence-pusher
Install and run from the source code - Mac OS X
Install Brew:
/usr/bin/ruby -e "\$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"
Run setup.sh:
sh setup.sh
Configure
Get your wiki link and space name:
Update following parameters in config.json
{
"CONFLUENCE_SPACE": "",
"CONFLUENCE_PARENT_PAGE": "", // leaving this blank will put document root page directly into Confluence space listed above
"CONFLUENCE_URL": "https://domain.atlassian.net",
"CONFLUENCE_USERID": "your.email@domain.com",
"CONFLUENCE_OATOKEN": "",
"DELETE_ROOT_DOCUMENT_ON_STARTUP": true
}
Run
Once you configured your credentials in credentials.sh simply run:
python3 cfpusher.py -s ../dir
where ../dir is your folder with markdown files.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.