From e27f9a220fd8597266d52934bcb06dbe1681b338 Mon Sep 17 00:00:00 2001 From: pacien Date: Tue, 16 Jun 2020 23:30:32 +0200 Subject: compiler: allow setting thumbnails for all items Not only for directories. GitHub: closes #224 --- compiler/ldgallery.1.md | 20 +++++++++++--------- 1 file changed, 11 insertions(+), 9 deletions(-) (limited to 'compiler/ldgallery.1.md') diff --git a/compiler/ldgallery.1.md b/compiler/ldgallery.1.md index a60a3b1..2fbddc5 100644 --- a/compiler/ldgallery.1.md +++ b/compiler/ldgallery.1.md @@ -67,22 +67,24 @@ Available options are: A gallery source directory contains the gallery items and their sidecar metadata files, optionally grouped inside sub-directories. -Directory thumbnails can be set by placing a picture file named "_directory", with any image file extension, inside of directories. +Thumbnails can be associated to items by suffixing their name with "_thumbnail", followed by an image file extension. +Directory thumbnails can be placed within their repsective directories themselves, without any prefix. An example input gallery directory structure could be as follows: ``` ./example-gallery -├── DSC0001.jpg --------- a picture -├── DSC0001.jpg.yaml ---- its associated sidecar metadata file -├── Some directory ------ a directory grouping gallery items -│ ├── _directory.jpg -- a thumbnail for its parent directory -│ ├── _directory.yaml - directory sidecar metadata file +├── DSC0001.jpg ----------------- a picture +├── DSC0001.jpg.yaml ------------ its associated sidecar metadata file +├── Some directory -------------- a directory grouping gallery items +│ ├── _directory.yaml --------- directory sidecar metadata file +│ ├── _thumbnail.jpg ---------- a thumbnail for its parent directory │ ├── DSC0002.jpg │ ├── DSC0002.jpg.yaml -│ ├── DSC0003.jpg -│ └── DSC0003.jpg.yaml -└── gallery.yaml -------- gallery settings file +│ ├── song.ogg +│ ├── song.ogg.yaml +│ └── song.ogg_thumbnail.jpg -- a thumbnail for song.ogg +└── gallery.yaml -888------------ gallery settings file ``` -- cgit v1.2.3