From 467fbd7e3db8075eecb650b85a759cd78174179c Mon Sep 17 00:00:00 2001
From: Matthias Vogelgesang <matthias.vogelgesang@gmail.com>
Date: Tue, 30 Jul 2013 12:08:21 +0200
Subject: [PATCH 1/2] Describe template variables

---
 docs/index.rst | 85 ++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 85 insertions(+)

diff --git a/docs/index.rst b/docs/index.rst
index e2c844a..df07494 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -160,6 +160,91 @@ and is shown below. This file is copied to the current directory with the
    :language: python
 
 
+Templates
+---------
+
+Gallery pages are created from a `Jinja2`_ template ``index.html`` that must be located in ``THEME_DIR/templates``.
+
+.. _Jinja2: http://jinja.pocoo.org/docs/
+
+
+Variables
+~~~~~~~~~
+
+You can use the following variables in your template:
+
+``albums``
+    List of ``album`` objects. An ``album`` object has the following attributes:
+
+    - ``album.name``
+    - ``album.title``
+    - ``album.url``
+    - ``album.thumb``
+
+``breadcrumb``
+    List of ``(url, title)`` tuples defining the current breadcrumb path.
+
+``index_title``
+    Name of the index. This is either the directory name or the title specified
+    in the ``index.md``.
+
+``index_url``
+    URL to the index page.
+
+``medias``
+    List of ``media`` objects. A ``media`` object has the following attributes:
+
+    - ``media.type``: Either ``"img"`` or ``"vid"``.
+    - ``media.file``: Location of the resized image.
+    - ``media.thumb``: Location of the corresponding thumbnail image.
+    - ``media.big``: If not None, location of the unmodified image.
+    - ``media.exif``: If not None contains a dict with EXIF tags. To get the
+      most common tags, see :ref:`simple-exif-data`.
+
+``meta`` and ``description``
+    Meta data and album description. For details how to annotate your albums
+    with meta data, see :ref:`album-information-label`.
+
+``theme.name``
+    Name of the currently used theme.
+
+``settings``
+    The entire dictionary from ``sigal.conf.py``. For example, you could use
+    this to output an optional download link for zipped archives:
+
+    .. code-block:: jinja
+
+        {% if settings.zip_gallery %}
+        <a href="{{ settings.zip_gallery }}">Download archive</a>
+        {% endif %}
+
+``sigal_link``
+    URL to the Sigal homepage.
+
+
+.. _simple-exif-data:
+
+Simpler EXIF data output
+~~~~~~~~~~~~~~~~~~~~~~~~
+
+Because the tags in the ``media.exif`` variable are cumbersome to use, some
+common tags are extracted and formatted for easy use in templates. You can use:
+
+``media.exif.simple.iso``
+    The ISO speed rating.
+
+``media.exif.simple.focal``
+    The focal length, formatted as a decimal number.
+
+``media.exif.simple.exposure``
+    The exposure time formatted as a fractional number, e.g. "1/500".
+
+``media.exif.simple.fstop``
+    The aperture value given as an F-number and formatted as a decimal.
+
+
+.. _album-information-label:
+
 Album information
 -----------------
 

From 02b8a703fc97455938bb977035136371199e593e Mon Sep 17 00:00:00 2001
From: Matthias Vogelgesang <matthias.vogelgesang@gmail.com>
Date: Sat, 3 Aug 2013 15:45:51 +0200
Subject: [PATCH 2/2] Fix exif/raw_exif and add datetime documentation

---
 docs/index.rst | 31 +++++++++++++++++++++++--------
 1 file changed, 23 insertions(+), 8 deletions(-)

diff --git a/docs/index.rst b/docs/index.rst
index df07494..fd71bea 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -198,8 +198,9 @@ You can use the following variables in your template:
     - ``media.file``: Location of the resized image.
     - ``media.thumb``: Location of the corresponding thumbnail image.
     - ``media.big``: If not None, location of the unmodified image.
-    - ``media.exif``: If not None contains a dict with EXIF tags. To get the
-      most common tags, see :ref:`simple-exif-data`.
+    - ``media.exif``: If not None contains a dict with the most common tags. For
+      more information, see :ref:`simple-exif-data`.
+    - ``media.raw_exif``: If not ``None``, it contains the raw EXIF tags.
 
 ``meta`` and ``description``
     Meta data and album description. For details how to annotate your albums
@@ -227,21 +228,35 @@ You can use the following variables in your template:
 Simpler EXIF data output
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
-Because the tags in the ``media.exif`` variable are cumbersome to use, some
-common tags are extracted and formatted for easy use in templates. You can use:
+Because the tags in the ``media.raw_exif`` dictionary are a little bit
+cumbersome to use, some common tags are extracted and formatted for easy use in
+templates. If available, you can use:
 
-``media.exif.simple.iso``
+``media.exif.iso``
     The ISO speed rating.
 
-``media.exif.simple.focal``
+``media.exif.focal``
     The focal length, formatted as a decimal number.
 
-``media.exif.simple.exposure``
+``media.exif.exposure``
     The exposure time formatted as a fractional number, e.g. "1/500".
 
-``media.exif.simple.fstop``
+``media.exif.fstop``
     The aperture value given as an F-number and formatted as a decimal.
 
+``media.exif.datetime``
+    The time the image was *taken*. It is a datetime object, that can be
+    formatted with ``strftime``:
+
+    .. code-block:: jinja
+
+        {% if media.exif.datetime %}
+            {{ media.exif.datetime.strftime('%A, %d. %B %Y') }}
+        {% endif %}
+
+    This will output something like "Monday, 25. June 2013", depending on your
+    locale.
+
 
 .. _album-information-label: