A MkDocs plugin that converts markdown encoded images into <figure> elements.
Project description
MkDocs Img2Fig v2 Plugin
this project fix bug and add new feature in MkDocs Img2Fig plugin
This MkDocs plugin converts markdown encoded images like
{align="right" width="20%"}
into
<figure class="figure-image">
<img src="../../images/my-image.png" alt="An image caption" align="left" width="20%" >
<figcaption>An image caption</figcaption>
</figure>
- of course, you could leave out
{align="right" width="20%"} - support attr : https://developer.mozilla.org/zh-CN/docs/Web/HTML/Element/img
center image
unfortunately, align:center is not supported. if you want to center image, add style="display:block; margin:0 auto;
for example
{width="20%" style="display:block; margin:0 auto;"}
Requirements
This package requires Python >=3.6 and MkDocs version 1.0 or higher.
Installation
Install the package with pip:
pip install mkdocs-img2figv2-plugin
Enable the plugin in your mkdocs.yml:
plugins:
- search
- img2figv2
Note: If you have no plugins entry in your config file yet, you'll likely also want to add the search plugin. MkDocs enables it by default if there is no plugins entry set, but now you have to enable it explicitly.
More information about plugins in the MkDocs documentation
Known issue
it won't work with setting use_directory_urls: false in your mkdocs.yml ( true is default )
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mkdocs-img2figv2-plugin-0.0.2.tar.gz.
File metadata
- Download URL: mkdocs-img2figv2-plugin-0.0.2.tar.gz
- Upload date:
- Size: 3.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.0 CPython/3.8.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fa9265739978f51191873fbb222de9d385f019fac3e86a997da6071abfa74a06
|
|
| MD5 |
92108816d8e7974cf09c893a43f08cc0
|
|
| BLAKE2b-256 |
ae7e2c15351d2268c6498211a200b10fb2400c0ef699a449054016462f165183
|
File details
Details for the file mkdocs_img2figv2_plugin-0.0.2-py3-none-any.whl.
File metadata
- Download URL: mkdocs_img2figv2_plugin-0.0.2-py3-none-any.whl
- Upload date:
- Size: 4.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/4.0.0 CPython/3.8.5
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c47a02207d84a07827886f11b168bdae2347b61c1e211d025fd884f58849bdcc
|
|
| MD5 |
a06fa59967172b2e61197f34ce2ea646
|
|
| BLAKE2b-256 |
76126b2a8b4d9de8e76e82040b027e6258307010620e970cfb419f56ae868bc0
|