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

Uploaded Python 3

File details

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

File metadata

  • Download URL: mkdocs_auto_figure_list-0.2.2.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.2.tar.gz
Algorithm Hash digest
SHA256 d501daa8278ca71e318f4cdec03ce1a61e500947085d6a4dea5d5bf905db1172
MD5 b4242885553298e5fb2542ab50937446
BLAKE2b-256 7d1b163a11198cb27fcd3b89599f5220a66e3e48a3ff2772cc2570b3e5cded87

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for mkdocs_auto_figure_list-0.2.2-py3-none-any.whl
Algorithm Hash digest
SHA256 b4b4b030088b5d9482ba248d5ce8ef1ec5f7d809d210f0fb5184a318b1a422b6
MD5 0e01e922bd76766fde6a0935f4367526
BLAKE2b-256 79dd8c97482ff1b1c137bffc618f4053f166ab22ddef214647d4c2066d96bccf

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