Skip to main content

GraphViz diagrams preprocessor for Foliant.

Project description

Graphviz Diagrams Preprocessor for Foliant

Graphviz is an open source graph visualization tool. This preprocessor converts Graphviz diagram definitions in the source and converts them into images on the fly during project build.


$ pip install foliantcontrib.graphviz


To enable the preprocessor, add graphviz to preprocessors section in the project config:

    - graphviz

The preprocessor has a number of options:

    - graphviz:
        cache_dir: !path .diagramscache
        graphviz_path: dot
        engine: dot
        format: png
        as_image: true

cache_dir : Path to the directory with the generated diagrams. It can be a path relative to the project root or a global one; you can use ~/ shortcut.

To save time during build, only new and modified diagrams are rendered. The generated images are cached and reused in future builds.

graphviz_path : Path to Graphviz launcher. By default, it is assumed that you have the dot command in your PATH, but if Graphviz uses another command to launch, or if the dot launcher is installed in a custom place, you can define it here.

engine : Layout engine used to process the diagram source. Available engines: (circo, dot, fdp, neato, osage, patchwork, sfdp twopi). Default: dot

format : Output format of the diagram image. Available formats: tons of them. Default: png

as_image : If true — inserts scheme into document as md-image. If false — inserts the file generated by GraphViz directly into the document (may be handy for svg images). Default: true

params : Params passed to the image generation command:

        - graphviz:
                Gdpi: 100

To see the full list of params, run the command that launches Graphviz, with -? command line option.


To insert a diagram definition in your Markdown source, enclose it between <graphviz>...</graphviz> tags:

Here’s a diagram:

    a -> b

You can set any parameters in the tag options. Tag options have priority over the config options so you can override some values for specific diagrams while having the default ones set up in the config.

Tags also have two exclusive options: caption option — the markdown caption of the diagram image and src — path to diagram source (relative to current file).

If src tag option is supplied, tag body is ignored. Diagram source is loaded from external file.

Diagram with a caption:

<graphviz caption="Deployment diagram"
           params="Earrowsize: 0.5"

Note that command params listed in the params option are stated in YAML format. Remember that YAML is sensitive to indentation so for several params it is more suitable to use JSON-like mappings: {key1: 1, key2: 'value2'}.

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

foliantcontrib.graphviz-1.1.5.tar.gz (5.7 kB view hashes)

Uploaded Source

Built Distribution

foliantcontrib.graphviz-1.1.5-py3-none-any.whl (5.8 kB view hashes)

Uploaded Python 3

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