HugoPhotoSwipe

screenshot of HugoPhotoSwipe
hugo

HugoPhotoSwipe

Command-line tool for easy PhotoSwipe galleries in Hugo

Overview:

HugoPhotoSwipe is a command line application that allows you to easily create and manage PhotoSwipe albums when using the Hugo static website generator. It provides a convenient way to set photo descriptions, update albums, and generate responsive image sizes and thumbnails automatically.

Features:

  • Simple Installation: HugoPhotoSwipe is available on PyPI and can be easily installed using pip.
  • Hugo Integration: This tool works seamlessly with Hugo and generates a markdown file based on Hugo shortcodes to create the necessary HTML code for PhotoSwipe.
  • Configuration File: You can customize the configuration file to set variables such as the directory for Markdown files, output directory for processed photos, and URL prefix for photo files.
  • Album Creation: You can create a new album by simply running the command and providing the name. The tool will create a directory for the album and generate an album.yml file and an empty photos directory.
  • Photo Management: You can add photos to the album by placing them in the photos directory and setting the necessary fields in the album.yml file, such as title, date, copyright, and cover image filename.
  • Markdown Generation: Running the tool will create the markdown file containing the resized photos and update the album.yml file. It also generates large and small photo sizes, as well as thumbnails using SmartCrop.py.

Summary:

HugoPhotoSwipe is a command line tool that simplifies the process of creating and managing PhotoSwipe albums with Hugo. Its integration with Hugo and use of Markdown files make it easy to customize and update albums with minimal effort. With features like album creation, photo management, and automatic thumbnail generation, HugoPhotoSwipe provides a convenient solution for adding photo albums to your Hugo website.

hugo
Hugo

Hugo is an open-source static site generator that features fast build times, flexible themes, support for multiple content formats, multilingual websites, live reloading, and an active community. It allows developers to easily create and deploy SEO-friendly and mobile-responsive websites.