Setting up your gallery

With your site configuration complete, it’s time to configure your gallery.

lumeex/
└── config/
    ├── site.yaml
    ├── gallery.yaml
    ├── photos/
    │   ├── gallery
    │   └── hero
    └── themes/
        ├── modern
        └── typewriter

Photos

The photos directory contains all images you want to display on your site. It includes two subdirectories:

  • gallery/: put your gallery photos here.
  • hero/: put carousel photos for the homepage here.
  • Note : Gallery photos are all tagged images displayed throughout your site. Hero photos appear at the top of your site as a carousel, cycling through images in the top title block.

All your gallery photos must be referenced under the gallery.images section in gallery.yaml:

gallery:
  images: []

Similarly, all hero photos must be listed under the hero.images section:

hero:
  images: []

Hero photos power the carousel and automatically cycle to the next image every 7 seconds.

Use the gallery command to automatically populate these sections with all photos located in their respective folders:

Docker
sudo docker exec -it lmx gallery
Python
python3 gallery.py
  • Python: Make sure to run the script from the lumeex/ directory; otherwise, it will not be found.

If you add new photos later, the script appends only the new files to the existing references. If you remove photos from the folders, the script removes their references to keep your gallery up to date and avoid broken entries.

Tagging

Once your gallery.yaml is populated, you can tag each referenced photo like this:

images:
- src: gallery/your_photo_1.jpg
  tags: [portrait]
- src: gallery/your_photo_2.jpg
  tags: [portrait, sunset, "big boats"]
- src: gallery/your_photo_3.jpg
  tags: [landscape, sea, beach, sand]

Tags containing spaces must be enclosed in double quotes (").

✨ Tip: You can also format tags as a list for better readability:
images:
- src: gallery/your_photo_1.jpg
  tags: 
    - portrait
    - sunset
    - photos
Table of Contents