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

Uploaded Python 3

File details

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

File metadata

  • Download URL: mkdocs_auto_figure_list-0.2.1.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.1.tar.gz
Algorithm Hash digest
SHA256 6bb74090afa08f93766f2957ce4bf322012775f63569faa20fc6100ccd4678f5
MD5 b72df254e4c61ad24ace34daafd102ae
BLAKE2b-256 818356a9e215e36a877f7ac31381efb4909bc6638e6a75ad0668c37c8bbfa17d

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for mkdocs_auto_figure_list-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 ae7e7cccad403bcfae4b42107695d9fcd52b8e05f4c89b973ddc131b6df63f1b
MD5 b85e83488cb70245e05d7774522a414a
BLAKE2b-256 e97844e2eb80c10e616a1ab924f73ac7ecb6fd70c27ce59609194d9cb92a9243

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