MkDocs plugin to resize images according to the configuration.
Project description
MkDocs Resize Images Plugin
This MkDocs plugin finds all folders with a certain name, by default assets-large
, resizes all images in those folders according to the plugin configuration.
Then saves the resized images in a different folder, by default assets
.
The plugin also supports caching: if a file has not changed since the last time the plugin ran, it won't be processed again.
Installation
Install the plugin using pip from PyPI:
pip install mkdocs-resize-images
Activate the plugin in mkdocs.yml
:
plugins:
- search
- resize-images
Create .gitignore
file in your project root directory and add the following line to it:
assets-large # or whatever you have set as source-dir
.resize-hash # if you have enabled caching
Usage
By default, the plugin will look for images in all directories named assets-large, resize them to 800x600 pixels, and then save the resized images in assets directories in the same parent directories as the assets-large directories.
You can configure the plugin in your mkdocs.yml:
plugins:
- search
- resize-images:
source-dir: assets-large
target-dir: assets
enable_cache: True
size: [800, 600]
extensions: ['.jpg', '.jpeg', '.png', '.gif', '.svg']
source-dir
: The name of the directories to search for images to resize. Default is assets-large
.
target-dir
: The name of the directories to save the resized images in. Default is assets
.
size
: The size to resize the images to, specified as [width, height]. Default is [800, 600]
.
extensions
: List of image file extensions to consider for resizing. The plugin will look for images with these extensions in both lower and upper case. Default is ['.jpg', '.jpeg', '.png', '.gif', '.svg']
.
enable_cache
: Whether to enable caching. If enabled, the plugin will check if a file has changed since the last time the plugin ran, and if not, it won't process the file again. Default is True
.
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
Hashes for mkdocs-resize-images-1.0.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2717d86dee4350fe65848ecc813e2767b2899e12e0442053ad53f6f5aa7d6925 |
|
MD5 | 3f84307b730a0157e72210828fd4933c |
|
BLAKE2b-256 | 3900722ee67b10dbe27ddb0ace2fed4090e74f1a598f5322b3048f7d8f2f2df3 |
Hashes for mkdocs_resize_images-1.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | caa55c9e82ec471b2490d9b7da7e5b8ac72ee08f8c1053f4ca7ba90052117dd5 |
|
MD5 | 98efaf37198b6eef301ae2d10fa2c52d |
|
BLAKE2b-256 | 7fd905d70cfe7a5aad92832c53d46686b625c4472a2993d83e15bc1f902981f8 |