Skip to main content

Auto creation for figures in MkDocs.

Project description

MkDocs auto figure list

Note: This plugin is still in an early development phase and may contain some bugs. You are welcome to contribute to its further development.

This plugin searches through all markdown files for the HTML tags <figure> and <figcaption>. These are then collected in ascending order, and a new markdown file named figure-list.md is created. This file lists all the figures and adds a link to the corresponding image.

This plugin works with the PDF-Exporter Plugin: https://github.com/Privatacc/mkdocs-to-pdf.git

Example of a <figure> tag:

<figure>
  <img src="path/to/img.jpg" alt="my image">
  <figcaption>My figcaption</figcaption>`
</figure>

Installation: You can install this package with pip:

pip install mkdocs-auto-figure-list

Use: The plugin must be added to the mkdocs.yml file as follows: plugins:

Options:

    - auto-figure-list:
        heading: "Figure-List"
        figure_label: "Figure"

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_auto_figure_list-0.2.0.tar.gz (4.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mkdocs_auto_figure_list-0.2.0-py3-none-any.whl (4.9 kB view details)

Uploaded Python 3

File details

Details for the file mkdocs_auto_figure_list-0.2.0.tar.gz.

File metadata

  • Download URL: mkdocs_auto_figure_list-0.2.0.tar.gz
  • Upload date:
  • Size: 4.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.4

File hashes

Hashes for mkdocs_auto_figure_list-0.2.0.tar.gz
Algorithm Hash digest
SHA256 2aadc74d2d0799db1463a66f58528829d7e8bdc1305f8b05251be32430975f65
MD5 7596c9895cd703935b76309866e0b333
BLAKE2b-256 2850608b623688f3cc6630d76305df77a5881ab4351df53af7f7968380d50899

See more details on using hashes here.

File details

Details for the file mkdocs_auto_figure_list-0.2.0-py3-none-any.whl.

File metadata

File hashes

Hashes for mkdocs_auto_figure_list-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 87fccae0e27fee446274b3ee5ab4077938567f1dfb16cc0fe9fb0a59106ef705
MD5 1cb9719a10600a5857e1504bfcb40a85
BLAKE2b-256 d2499e950fa7f518a7a4f1aa755c64b6fbc305ff2fe70caa9ea83ec304df2a11

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page