From 458a2e71a5aed948c72c13aa0d4d25567890ff3b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Julien=20Fastr=C3=A9?= <julien@fastre.info>
Date: Fri, 23 Jan 2015 15:01:47 +0100
Subject: [PATCH] add doc for date localisation

Introduce the twig Intl extension and make ref to the doc.

refs #272
---
 source/development/index.rst        |  1 +
 source/development/localisation.rst | 29 +++++++++++++++++++++++++++++
 2 files changed, 30 insertions(+)
 create mode 100644 source/development/localisation.rst

diff --git a/source/development/index.rst b/source/development/index.rst
index 68b5d62f2..a5b832b36 100644
--- a/source/development/index.rst
+++ b/source/development/index.rst
@@ -19,6 +19,7 @@ As Chill rely on the `symfony <http://symfony.com>`_ framework, reading the fram
     Routing <routing.rst>
     Menus <menus.rst>
     Message to users <flashbags.rst>
+    Localisation <localisation.rst>
     Database migrations <migrations.rst>
     Searching <searching.rst>
     Testing <make-test-working.rst>
diff --git a/source/development/localisation.rst b/source/development/localisation.rst
new file mode 100644
index 000000000..04cb54b89
--- /dev/null
+++ b/source/development/localisation.rst
@@ -0,0 +1,29 @@
+.. Copyright (C)  2014 Champs Libres Cooperative SCRLFS
+   Permission is granted to copy, distribute and/or modify this document
+   under the terms of the GNU Free Documentation License, Version 1.3
+   or any later version published by the Free Software Foundation;
+   with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
+   A copy of the license is included in the section entitled "GNU
+   Free Documentation License".
+
+Localisation
+*************
+
+Date and time
+==============
+
+The `Intl extension <http://twig.sensiolabs.org/doc/extensions/intl.html>`_ is enabled on the Chill application. 
+
+You may format date and time using the `localizeddate` function : 
+
+.. code-block:: jinja
+
+   date|localizeddate('long', 'none')
+
+By default, we prefer using the `long` format for date formatting.
+
+.. seealso::
+
+   `Documentation for Intl Extension <http://twig.sensiolabs.org/doc/extensions/intl.html>`_
+      Read the complete doc for the Intl extension.
+