Metadata-Version: 2.1
Name: mkdocs-plantuml-local
Version: 0.5.0
Summary: Render PlantUML diagrams without sending sensitive data to a public server
Home-page: https://github.com/acodeninja/mkdocs-plantuml-local
License: MIT
Author: Lawrence
Author-email: lawrence@acode.ninja
Requires-Python: >=3.9
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Dist: cssselect (>=1.2.0,<2.0.0)
Requires-Dist: lxml (>=5.1.0,<6.0.0)
Requires-Dist: mkdocs (>=1.4.3)
Requires-Dist: pymdown-extensions (>=10.7,<11.0)
Description-Content-Type: text/markdown

# MkDocs PlantUML Local

Render Plantuml codeblocks in mkdocs without sending sensitive diagrams to a public server.

## Configuration

**Minimal**

```yaml
plugins:
  - plantuml-local
markdown_extensions:
  - pymdownx.superfences:
      custom_fences:
        - name: plantuml
          class: plantuml
          format: !!python/name:pymdownx.superfences.fence_code_format
```

**All**

```yaml
plugins:
  - plantuml-local:
      # shortname is language used to identify
      # blocks to process, defaults to `plantuml`
      shortname: puml
      # background_colour sets the background
      # fill colour used, defaults to `transparent`
      background_colour: white
      # class_name is the css class to assign to the
      # rendered svg diagram, by default no class
      # name is set.
      class_name: plantuml-diagram
      # cache, when set to true, will cache rendered
      # diagrams under the folder `.cache`. Not
      # recommended for use in CI, so add `.cache`
      # to your .gitignore
      cache: true
markdown_extensions:
  - pymdownx.superfences:
      custom_fences:
        - name: puml
          class: puml
          format: !!python/name:pymdownx.superfences.fence_code_format
```

## Licence

This MkDocs plugin is licenced under the MIT license.

Plantuml is redistributed with this package, under the [GPL-3.0 license](https://github.com/plantuml/plantuml/blob/master/license.txt).

