mirror of https://github.com/saimn/sigal.git
You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
47 lines
1.3 KiB
47 lines
1.3 KiB
=================== |
|
Album information |
|
=================== |
|
|
|
Information on an album can be given in a file using the `markdown`_ syntax, |
|
named ``index.md`` : |
|
|
|
:: |
|
|
|
Title: Another example gallery |
|
Thumbnail: test2.jpg |
|
Author: John Doe |
|
Sort: -name |
|
|
|
And a description with *Markdown* syntax. |
|
|
|
Some meta-data keys are used by Sigal to get the useful informations on the |
|
gallery: |
|
|
|
- *Title*: the gallery title. |
|
- *Thumbnail*: the thumbnail that will be used in the parent directory to |
|
represent the gallery. |
|
- *Author*: the author of the gallery, if present it is used instead of the |
|
author setting. |
|
- *Sort*: the sort order for this album. If prefixed with a '-' it will be in |
|
reversed order. |
|
|
|
Any additional meta-data is available in the templates. For instance:: |
|
|
|
Authors: Waylan Limberg |
|
John Doe |
|
|
|
can be used in the template with: |
|
|
|
.. code-block:: jinja |
|
|
|
{% if 'authors' in album.meta %} |
|
<p>Authors: {{ album.meta.authors|join(', ') }}</> |
|
{% endif %} |
|
|
|
If this file does not exist or if some meta-data is missing: |
|
|
|
- The directory's name is used for the title. |
|
- The first landscape image of the directory is used as thumbnail, or the first |
|
image if no landscape image is found. |
|
|
|
.. _markdown: http://daringfireball.net/projects/markdown/
|
|
|