2021-04-14 20:58:06 +00:00
# mkdocs-with-confluence
MkDocs plugin that converts markdown pages into confluence markup
and export it to the Confluence page
2023-02-24 08:40:21 +00:00
# How to use
To enable plugin, you need to set the `MKDOCS_TO_CONFLUENCE` environment variable.
```BASH
export MKDOCS_TO_CONFLUENCE=1
```
By default the dry-run mode is turned off. If you wan't to enable it, you can use the config file, ot the `MKDOCS_TO_CONFLUENCE_DRY_RUN` environment variable
```BASH
export MKDOCS_TO_CONFLUENCE_DRY_RUN=1
```
2021-04-14 20:58:06 +00:00
## Setup
Install the plugin using pip:
`pip install mkdocs-with-confluence`
Activate the plugin in `mkdocs.yml` :
```yaml
plugins:
- search
- mkdocs-with-confluence
```
2021-05-30 18:32:35 +00:00
More information about plugins in the [MkDocs documentation: mkdocs-plugins ](https://www.mkdocs.org/user-guide/plugins/ ).
2021-04-14 20:58:06 +00:00
## Usage
Use following config and adjust it according to your needs:
```yaml
- mkdocs-with-confluence:
host_url: https://< YOUR_CONFLUENCE_DOMAIN > /rest/api/content
space: < YOUR_SPACE >
parent_page_name: < YOUR_ROOT_PARENT_PAGE >
username: < YOUR_USERNAME_TO_CONFLUENCE >
password: < YOUR_PASSWORD_TO_CONFLUENCE >
dryrun: true
```
## Parameters:
### Requirements
- md2cf
- mimetypes
- mistune