Question 1

Why does Photoswipe gallery fail in sigal 2.5 or 2.6, linking directly to images instead of using the gallery?

Accepted Answer

This is a known bug in sigal up to early 2.6 releases where the Photoswipe theme's album.html template used hardcoded /static paths instead of the {{theme.url}} variable, causing broken links. Update to the latest sigal version (2.6 or newer from PyPI) which includes the fix (commit c143300a). As a temporary workaround for 2.5, edit the Photoswipe theme's album.html (typically in the theme folder) and replace hardcoded references like /static/js/photoswipe.min.js with {{theme.url}}/js/photoswipe.min.js on lines 13–17.

Question 2

Why does sigal show 'Album X contains sub-albums and images' and hide my images?

Accepted Answer

Sigal requires album directories to contain either only images or only sub-albums, not both. To fix this, restructure your directory: move all direct images into a dedicated subfolder (e.g., 'photos'). Then the parent album will only contain subfolders, and all images will appear.

Question 3

Why do links in my photo description markdown cause JavaScript errors and break the gallery page?

Accepted Answer

The markdown parser was not escaping double quotes in the generated HTML, causing broken JavaScript strings in the data array. This has been fixed by pull request #533. Update to the latest version to resolve the issue.

Question 4

How to fix broken album thumbnail in Sigal after converting images to JPEG?

Accepted Answer

If you have image format conversion enabled (e.g., `img_format = 'JPEG'`) and manually set a `Thumbnail` in an `index.md` file, the generated HTML may reference the original file extension (e.g., `.png`) while the actual thumbnail file uses the new extension (`.jpeg`). As a workaround, explicitly set the `Thumbnail` value in `index.md` to the converted filename (e.g., `Thumbnail: Untitled.jpeg`). This is a known bug (issue #476) and will be addressed in a future release.

Question 5

Why does sigal ignore my portrait thumbnail height setting when it is larger than width?

Accepted Answer

In sigal, the settings.py file automatically swaps width and height if the height value is greater than the width for `img_size`, `thumb_size`, and `video_size`. This is to ensure landscape orientation for the default themes. To use portrait-oriented thumbnails where height > width, edit the file `sigal/settings.py`, find the block that checks `if h > w` and swaps them, and comment out those lines. Then set `thumb_size = (300, 400)` or your desired dimensions. Ensure your theme CSS is also adjusted for portrait images. After each sigal upgrade you may need to reapply this change. Clearer comments in the configuration template have been proposed but not yet implemented.

Sigal

Core Features

What It Can't Do

Use Cases

Tags

Getting Started

Similar Projects