Update README.md

This commit is contained in:
Nikolai Rodionov 2023-02-24 17:39:55 +01:00
parent dba633cccf
commit c3a08433de

View File

@ -8,7 +8,9 @@ To enable plugin, you need to set the `MKDOCS_TO_CONFLUENCE` environment variabl
```BASH ```BASH
export MKDOCS_TO_CONFLUENCE=1 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 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 ```BASH
export MKDOCS_TO_CONFLUENCE_DRY_RUN=1 export MKDOCS_TO_CONFLUENCE_DRY_RUN=1
``` ```
@ -16,13 +18,12 @@ export MKDOCS_TO_CONFLUENCE_DRY_RUN=1
## Setup ## Setup
Install the plugin using pip: Install the plugin using pip:
`pip install mkdocs-with-confluence` `pip install https://github.com/allanger/mkdocs-with-confluence/releases/download/v0.3.1/mkdocs_with_confluence-0.3.1.tar.gz`
Activate the plugin in `mkdocs.yml`: Activate the plugin in `mkdocs.yml`:
```yaml ```yaml
plugins: plugins:
- search
- mkdocs-with-confluence - mkdocs-with-confluence
``` ```
@ -37,12 +38,14 @@ Use following config and adjust it according to your needs:
host_url: https://<YOUR_CONFLUENCE_DOMAIN>/rest/api/content host_url: https://<YOUR_CONFLUENCE_DOMAIN>/rest/api/content
space: <YOUR_SPACE> space: <YOUR_SPACE>
parent_page_name: <YOUR_ROOT_PARENT_PAGE> parent_page_name: <YOUR_ROOT_PARENT_PAGE>
username: <YOUR_USERNAME_TO_CONFLUENCE> username: <YOUR_USERNAME_TO_CONFLUENCE> # JIRA_USERNAME env var can be used
password: <YOUR_PASSWORD_TO_CONFLUENCE> password: <YOUR_PASSWORD_TO_CONFLUENCE> # JIRA_PASSWORD env var can be used
dryrun: true dryrun: true # MKDOCS_TO_CONFLUENCE_DRY_RUN env var can be used
``` header_message: <A_MESSAGE_THAT_WILL_BE_ADDED_TO_EVERY_PAGE>
upstream_url: <URL_OF_YOUR_MKDOCS_INTANCE>
header_warning: "‼️ This page is created automatically, all you changes will be overwritten during the next MKDocs deployment. Do not edit a page here ‼️"
## Parameters: ```
### Requirements ### Requirements
- md2cf - md2cf