hugophotoswipe 0.1.0

Installation

HugoPhotoSwipe is available on PyPI, you can install it easily with pip:

pip install --process-dependency-links hugophotoswipe

After installation, you should be left with a hps program.

Usage

This is a brief overview. See the Wiki for a full description.

Create a new directory for HugoPhotoSwipe and switch to it. For instance:

mkdir hugophotos
cd hugophotos

Next, initialize a HugoPhotoSwipe configuration with:

hps init

This creates a new HugoPhotoSwipe configuration file, called hugophotoswipe.yml. This is a YAML file. In this configuration file, you need to set at least the markdown_dir and output_dir variables. These are respectively the directory where the markdown needs to be placed and the directory where the processed photos need to be placed. You may also want to set the url_prefix variable, which is added before the path to the photo files.

Create a new album using:

hps new

HugoPhotoSwipe will ask you for the name of the new album, and create a directory with that name for you. Try to keep the names short, they are not the final title of the album. Spaces in the name are automatically replaced with underscores. In the new directory you will find an album.yml file and an empty photos directory.

At this point, you should place some photos in the photos directory and set the title field of the album in the album.yml file. You can also set the album date, the copyright line, and the filename of the coverimage. Key/Value pairs you place under the properties line will be placed in the preamble of the markdown file, so you can use them in Hugo layouts. For instance, you may want to add a country field, camera details, etc.

In the main directory (where the hugophotoswipe.yml file is), you can now run:

hps update

To create the markdown file, the resized photos, and will update the album.yml file. HugoPhotoSwipe creates large and small photo sizes, as well as thumbnails using SmartCrop.py.

If you now open the album.yml file, you’ll notice that the fields for the photos and the hashes have been extended. Under photos: all the photos in the directory will be listed, with for each photo a file, name, alt, and caption field. The last three fields can be edited by you. Doing this can be useful for SEO of your photos, but is not required. The hashes field in the album.yml file is used to detect changes in the photos, and don’t need to be edited by you.

Finally, if you want to regenerate all the markdown and resized photos, you can always use:

hps clean

to clean everything. This will of course not touch the original photo files.