created:2021-05-14
author:Foobär
top:README:Galleries
sort:004
title:Galleries

<p>
Creating a gallery is very simple, but there also isn't much control over how a gallery looks. Galleries can not have any metadata or a description on their own.
But they can be linked to a corrosponding entry that contains more information. If you are missing functionalities related to galleries, adding a hook may be a
solution. (See the "Hooks" section above.)
</p><p>
A gallery in SBWG simply consists of a directory that contains image files. The name of the directory is the name/title of the gallery. If an entry of the same name
exists on the same web site, a link to the entry will be placed on the gallery page and vice versa and thumbnails of the gallery's images will be included below the
entry. Currently only JPEG and PNG files are supported and the image file names need to have those extensions.
</p><p>
Upon generation of the web site, the images will be resized into three sizes:
</p><p>
The originals of the images will be copied to the output directory as well. The original image files will be linked to from their previews on the gallery page. This
way large original files are not loaded every time a gellery page is opened, but they are available to every visitor if they want to display or download it. If you
don't want to have the original images included on the pulished web site, you need to resize them manually beforehand or include a function that does this in the
settings file. <code>convert</code> or <code>mogrify</code> can be used for this.
</p>
