Sigal - Simple Static Gallery Generator
=======================================

.. image:: https://github.com/saimn/sigal/workflows/Run%20unit%20tests/badge.svg
   :target: https://github.com/saimn/sigal/actions
   :alt: CI Status

.. image:: https://codecov.io/gh/saimn/sigal/branch/main/graph/badge.svg
   :target: https://codecov.io/gh/saimn/sigal
   :alt: codecov.io

Sigal is yet another simple static gallery generator. It's written in Python
and it allows to build a static gallery of images with the following features:

* Process directories recursively.
* Generate HTML pages using Jinja2_ templates.
* Relative links for a portable output.
* Support themes, videos, EXIF tags, zip download.
* Parallel processing.
* MIT licensed.

The idea behind Sigal is to ease the use of the javascript libraries like
galleria_. These libraries do a great job to display the images, Sigal does
what is missing: resize images, create thumbnails, generate HTML pages.

Sigal requires Python 3.11+.

Links
-----

* Latest documentation on the website_
* Source, issues and pull requests on GitHub_
* Releases on PyPI_

Themes & Demo
-------------

Sigal comes with three themes, based on the colorbox_, galleria_ and photoswipe_
Javascript libraries:

- `colorbox demo`_
- `galleria demo`_
- `photoswipe demo`_

.. _website: https://sigal.readthedocs.io/en/latest/
.. _GitHub: https://github.com/saimn/sigal/
.. _PyPI: https://pypi.org/project/sigal/
.. _galleria: https://github.com/GalleriaJS/galleria
.. _colorbox: http://www.jacklmoore.com/colorbox
.. _photoswipe: http://photoswipe.com
.. _galleria demo: http://saimon.org/sigal-demo/galleria/
.. _colorbox demo: http://saimon.org/sigal-demo/colorbox/
.. _photoswipe demo: http://saimon.org/sigal-demo/photoswipe/
.. _Jinja2: https://palletsprojects.com/p/jinja/