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.1.4.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.1.4-py3-none-any.whl (4.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: mkdocs_auto_figure_list-0.1.4.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.1.4.tar.gz
Algorithm Hash digest
SHA256 e32e1a122ec7b281aa486e0713fab98550a8d4826ba1b76a50b01e798a28d7d3
MD5 fc8d84ce05dfcdd08d11cdd2a270562c
BLAKE2b-256 b4ea9debd1e08c1ac0bf22f367e2ceafe9003daf7f563e9b719699be58e995dd

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for mkdocs_auto_figure_list-0.1.4-py3-none-any.whl
Algorithm Hash digest
SHA256 a67c144854f9cf87832d829829b0623e317ebdfee0e1d9eb12be692f5c26d4c9
MD5 56b5e95a1626f84f795a3fb9681887f6
BLAKE2b-256 2a0658fafc5e95b3f990194b72dfbe359bbe96b83d193e4dbc9ec583172e1422

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