===============
Optimize Images
===============
``Optimize Images`` is a plugin for
`Pelican <http://docs.getpelican.com/>`_, a static site generator written
in Python.
``Optimize Images`` applies lossless compression on JPEG and PNG images,
with no effect on image quality. It uses jpegtran_ and OptiPNG_.
.. image:: https://img.shields.io/pypi/v/minchin.pelican.plugins.optimize-images.svg?style=flat
:target: https://pypi.python.org/pypi/minchin.pelican.plugins.optimize-images/
:alt: PyPI version number
.. image:: https://img.shields.io/badge/-Changelog-success
:target: https://github.com/MinchinWeb/minchin.pelican.plugins.optimize_images/blob/master/CHANGELOG.rst
:alt: Changelog
.. image:: https://img.shields.io/pypi/pyversions/minchin.pelican.plugins.optimize-images?style=flat
:target: https://pypi.python.org/pypi/minchin.pelican.plugins.optimize-images/
:alt: Supported Python version
.. image:: https://img.shields.io/pypi/l/minchin.pelican.plugins.optimize-images.svg?style=flat&color=green
:target: https://github.com/MinchinWeb/minchin.pelican.plugins.optimize_images/blob/master/LICENSE.txt
:alt: License
.. image:: https://img.shields.io/pypi/dm/minchin.pelican.plugins.optimize-images.svg?style=flat
:target: https://pypi.python.org/pypi/minchin.pelican.plugins.optimize-images/
:alt: Download Count
Installation
============
The easiest way to install ``Optimize Images`` is through the use of pip.
This will also install the required Python dependencies automatically.
.. code-block:: sh
pip install minchin.pelican.plugins.optimize_images
It is assumed both jpegtran_ and OptiPNG_ are installed on system path.
If you are using Pelican 4.5, it should automatically be activated (through my
AutoLoader plugin).
If you are using an earlier version of Pelican or autoloading isn't working,
then in your ``pelicanconf.py`` file, add ``Optimize Images`` to your list of
plugins:
.. code-block:: python
PLUGINS = [
# others...
"minchin.pelican.plugins.optimize_images",
# ...
]
Requirements
============
``Optimize Images`` depends on (and is really only useful with) Pelican.
This can be manually installed with pip:
.. code-block:: sh
pip install pelican
It is assumed both jpegtran_ and OptiPNG_ are installed on system path. On
Windows, installers are available at each respective website. On Ubuntu
systems, the two can be installed via ``apt-get``:
.. code-block:: sh
apt-get install optipng libjpeg-progs
Configuration and Usage
=======================
The plugin will activate and optimize images upon ``finalized`` signal of
pelican.
If add ``OPTIMIZE_IMAGES_DEV_MODE = True`` to your ``pelicanconf.py``, this
will disable the plugin, which is useful when developing your site locally.
Known Issues
============
Image manipulation like this can take some time to run. You may consider only
adding this plugin to your ``publishconf.py`` (rather than your base
``pelicanconf.py``) or add ``OPTIMIZE_IMAGES_DEV_MODE = True`` to your
``pelicanconf.py``, which will then only run this image optimization in
preparation for site publication.
An issue, as such, is that there is no formal test suite. Testing is
currently limited to my in-use observations. I also run a basic check upon
uploaded the package to PyPI that it can be downloaded and loaded into
Python.
The package is tested in Python 3.10; compatibility with other version of
Python is unknown, but there should be nothing particular keeping it from
working with other "modern" versions of Python.
Credits
=======
Original plugin from the `Pelican-Plugins repo
<https://github.com/getpelican/pelican-plugins>`_.
License
=======
The plugin code is assumed to be under the AGPLv3 license (this is the
license of the Pelican-Plugins repo).
.. _jpegtran: http://jpegclub.org/jpegtran/
.. _OptiPNG: http://optipng.sourceforge.net/
Raw data
{
"_id": null,
"home_page": "https://github.com/MinchinWeb/minchin.pelican.plugins.optimize_images",
"name": "minchin.pelican.plugins.optimize-images",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "",
"author": "William Minchin",
"author_email": "w_minchin@hotmail.com",
"download_url": "https://files.pythonhosted.org/packages/53/15/16d188fd1914f3e87aa551ccf537bbd0c9ce97769719841bde338eb876af/minchin.pelican.plugins.optimize_images-1.2.2.tar.gz",
"platform": "any",
"description": "===============\r\nOptimize Images\r\n===============\r\n\r\n``Optimize Images`` is a plugin for\r\n`Pelican <http://docs.getpelican.com/>`_, a static site generator written\r\nin Python.\r\n\r\n``Optimize Images`` applies lossless compression on JPEG and PNG images,\r\nwith no effect on image quality. It uses jpegtran_ and OptiPNG_.\r\n\r\n.. image:: https://img.shields.io/pypi/v/minchin.pelican.plugins.optimize-images.svg?style=flat\r\n :target: https://pypi.python.org/pypi/minchin.pelican.plugins.optimize-images/\r\n :alt: PyPI version number\r\n\r\n.. image:: https://img.shields.io/badge/-Changelog-success\r\n :target: https://github.com/MinchinWeb/minchin.pelican.plugins.optimize_images/blob/master/CHANGELOG.rst\r\n :alt: Changelog\r\n\r\n.. image:: https://img.shields.io/pypi/pyversions/minchin.pelican.plugins.optimize-images?style=flat\r\n :target: https://pypi.python.org/pypi/minchin.pelican.plugins.optimize-images/\r\n :alt: Supported Python version\r\n\r\n.. image:: https://img.shields.io/pypi/l/minchin.pelican.plugins.optimize-images.svg?style=flat&color=green\r\n :target: https://github.com/MinchinWeb/minchin.pelican.plugins.optimize_images/blob/master/LICENSE.txt\r\n :alt: License\r\n\r\n.. image:: https://img.shields.io/pypi/dm/minchin.pelican.plugins.optimize-images.svg?style=flat\r\n :target: https://pypi.python.org/pypi/minchin.pelican.plugins.optimize-images/\r\n :alt: Download Count\r\n\r\n\r\nInstallation\r\n============\r\n\r\nThe easiest way to install ``Optimize Images`` is through the use of pip.\r\nThis will also install the required Python dependencies automatically.\r\n\r\n.. code-block:: sh\r\n\r\n pip install minchin.pelican.plugins.optimize_images\r\n\r\nIt is assumed both jpegtran_ and OptiPNG_ are installed on system path.\r\n\r\nIf you are using Pelican 4.5, it should automatically be activated (through my\r\nAutoLoader plugin). \r\n\r\nIf you are using an earlier version of Pelican or autoloading isn't working,\r\nthen in your ``pelicanconf.py`` file, add ``Optimize Images`` to your list of\r\nplugins:\r\n\r\n.. code-block:: python\r\n\r\n PLUGINS = [\r\n # others...\r\n \"minchin.pelican.plugins.optimize_images\",\r\n # ...\r\n ]\r\n\r\n\r\nRequirements\r\n============\r\n\r\n``Optimize Images`` depends on (and is really only useful with) Pelican.\r\nThis can be manually installed with pip:\r\n\r\n.. code-block:: sh\r\n\r\n pip install pelican\r\n\r\nIt is assumed both jpegtran_ and OptiPNG_ are installed on system path. On\r\nWindows, installers are available at each respective website. On Ubuntu\r\nsystems, the two can be installed via ``apt-get``:\r\n\r\n.. code-block:: sh\r\n\r\n apt-get install optipng libjpeg-progs\r\n\r\n\r\nConfiguration and Usage\r\n=======================\r\n\r\nThe plugin will activate and optimize images upon ``finalized`` signal of\r\npelican.\r\n\r\nIf add ``OPTIMIZE_IMAGES_DEV_MODE = True`` to your ``pelicanconf.py``, this\r\nwill disable the plugin, which is useful when developing your site locally.\r\n\r\n\r\nKnown Issues\r\n============\r\n\r\nImage manipulation like this can take some time to run. You may consider only\r\nadding this plugin to your ``publishconf.py`` (rather than your base\r\n``pelicanconf.py``) or add ``OPTIMIZE_IMAGES_DEV_MODE = True`` to your\r\n``pelicanconf.py``, which will then only run this image optimization in\r\npreparation for site publication.\r\n\r\nAn issue, as such, is that there is no formal test suite. Testing is\r\ncurrently limited to my in-use observations. I also run a basic check upon\r\nuploaded the package to PyPI that it can be downloaded and loaded into\r\nPython.\r\n\r\nThe package is tested in Python 3.10; compatibility with other version of\r\nPython is unknown, but there should be nothing particular keeping it from\r\nworking with other \"modern\" versions of Python.\r\n\r\n\r\nCredits\r\n=======\r\n\r\nOriginal plugin from the `Pelican-Plugins repo\r\n<https://github.com/getpelican/pelican-plugins>`_.\r\n\r\n\r\nLicense\r\n=======\r\n\r\nThe plugin code is assumed to be under the AGPLv3 license (this is the\r\nlicense of the Pelican-Plugins repo).\r\n\r\n\r\n.. _jpegtran: http://jpegclub.org/jpegtran/ \r\n.. _OptiPNG: http://optipng.sourceforge.net/\r\n",
"bugtrack_url": null,
"license": "GNU Affero General Public License v3",
"summary": "This Pelican plugin optimizes images (jpg and png).",
"version": "1.2.2",
"project_urls": {
"Homepage": "https://github.com/MinchinWeb/minchin.pelican.plugins.optimize_images"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "562a08a5b06f95db12df29a626354b0d0d6941fa577393f36dad036c3dfa4b43",
"md5": "4c1aa9557cfe246c163b253d6f8d9257",
"sha256": "424b211f1f624066d481639190e1c38e5202a6f16c33d3f65fba3276852bba62"
},
"downloads": -1,
"filename": "minchin.pelican.plugins.optimize_images-1.2.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "4c1aa9557cfe246c163b253d6f8d9257",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 17888,
"upload_time": "2023-08-09T20:27:29",
"upload_time_iso_8601": "2023-08-09T20:27:29.956443Z",
"url": "https://files.pythonhosted.org/packages/56/2a/08a5b06f95db12df29a626354b0d0d6941fa577393f36dad036c3dfa4b43/minchin.pelican.plugins.optimize_images-1.2.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "531516d188fd1914f3e87aa551ccf537bbd0c9ce97769719841bde338eb876af",
"md5": "b56412a3b7715ab8f93b45f19bbc5d09",
"sha256": "f3ddbfdc36969c89f362e642de542af96502680cb9dc615547b430aa0b502617"
},
"downloads": -1,
"filename": "minchin.pelican.plugins.optimize_images-1.2.2.tar.gz",
"has_sig": false,
"md5_digest": "b56412a3b7715ab8f93b45f19bbc5d09",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 18787,
"upload_time": "2023-08-09T20:26:58",
"upload_time_iso_8601": "2023-08-09T20:26:58.339075Z",
"url": "https://files.pythonhosted.org/packages/53/15/16d188fd1914f3e87aa551ccf537bbd0c9ce97769719841bde338eb876af/minchin.pelican.plugins.optimize_images-1.2.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-09 20:26:58",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "MinchinWeb",
"github_project": "minchin.pelican.plugins.optimize_images",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"lcname": "minchin.pelican.plugins.optimize-images"
}
JSON
