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] 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: