Skip to main content

MkDocs Plugin to enable pan & zoom on images and mermaid diagrams

Project description

Panzoom for MkDocs

This plugin makes use of the panzoom (LICENCE) library by Andrei Kashcha

Live Demo

Setup

pip install mkdocs-panzoom-plugin

Add it to your mkdocs.yml:

plugins:
  - search
  - panzoom

[!WARNING] Make sure to define the site_url otherwise it won't work!

Example:

site_url: https://playg0n.github.io/mkdocs-panzoom/

Usage

Examples and usage are available in the docs.

Config

Mermaid

This enables panzoom on mermaid diagrams.

plugins:
  - panzoom:
      mermaid: true # default true

Images

This enables panzoom on images.

plugins:
  - panzoom:
      images: true # default true

Exclude Pages

plugins:
  - panzoom:
      exclude:
        - Path/to/page.md

Enable Fullscreen

[!WARNING] This is still in development!

plugins:
  - panzoom:
      full_screen: True # default False

Credits

The structure and some parts are from the enumerate-headings-plugin (LICENCE)

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

mkdocs_panzoom_plugin-0.1.1.tar.gz (18.7 kB view hashes)

Uploaded Source

Built Distribution

mkdocs_panzoom_plugin-0.1.1-py3-none-any.whl (19.5 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