doc: write about django templates (#20496)

help/fr/misc-substvars.page

@@ -2,7 +2,7 @@
       type="topic" id="misc-substvars" xml:lang="fr">
 
 <info>
-  <link type="seealso" xref="misc-ezt" />
+  <link type="seealso" xref="misc-templates" />
   <revision docversion="0.1" date="2013-07-06" status="draft"/>
   <credit type="author">
     <name>Frédéric Péters</name>

help/fr/misc-templates.page

@@ -1,5 +1,5 @@
 <page xmlns="http://projectmallard.org/1.0/"
-      type="topic" id="misc-ezt" xml:lang="fr">
+      type="topic" id="misc-templates" xml:lang="fr">
 
 <info>
   <revision docversion="0.1" date="2013-07-06" status="draft"/>
@@ -10,7 +10,7 @@
 
 </info>
 
-<title>Mécanique de template</title>
+<title>Mécanique de gabarits</title>
 
 <p>
 De nombreux éléments permettent l'utilisation d'un système simple permettant
@@ -21,9 +21,9 @@ souhaiter la bienvenue.
 
 <example>
 <code>
-Bienvenue [session_user_display_name],
+Bienvenue {{session_user_display_name}},
 
-Toute l'équipe de [site_name] vous remercie de votre inscription
+Toute l'équipe de {{site_name}} vous remercie de votre inscription
 et vous souhaite une agréable visite.
 </code>
 </example>
@@ -44,8 +44,8 @@ et vous souhaite une agréable visite.
 
 <p>
 Il est également possible d'afficher du contenu de manière conditionnelle,
-en utilisant la syntaxe <code>[if-any variable]...[end]</code> ou
-<code>[if-any variable]...[else]...[end]</code> pour vérifier la présence
+en utilisant la syntaxe <code>{% if variable %}...{% endif %}</code> ou
+<code>{% if variable %}...{% else %}...{% endif %}</code> pour vérifier la présence
 d'une valeur dans <var>variable</var>.
 </p>
 
@@ -53,31 +53,39 @@ d'une valeur dans <var>variable</var>.
 <code>
 Pour rappel, voici les renseignements que vous nous avez fournis :
 
-[if-any form_var_regime_alimentaire]
- - Régime alimentaire : [form_var_regime_alimentaire]
-[else]
+{% if form_var_regime_alimentaire %}
+ - Régime alimentaire : {{form_var_regime_alimentaire}}
+{% else %}
  - Aucun régime alimentaire précisé.
-[end]
+{% endif %}
 </code>
 </example>
 
 <p>
 Pour tester non pas la présence d'une valeur mais le contenu de celle-ci, la
-syntaxe est <code>[is variable valeur]...[end]</code>, avec également la
-possibilité d'un <code>[else]</code>.
+syntaxe est <code>{% if variable == valeur %}...{% endif %}</code>, avec également la
+possibilité d'un <code>{% else %}</code>.
 </p>
 
 <example>
 <code>
 Pour toute information complémentaire, n'hésitez pas à nous contacter au
-numéro [is form_var_pays "France"]0800 123 456[else]+33 1 1234 5678[end].
+numéro {% if form_var_pays == "France" %}0800 123 456{% else %}+33 1 1234 5678{% endif %}.
 </code>
 </example>
 
 <note><p>
-Pour plus d'informations, il existe une
+Pour plus d'informations la syntaxe utilisée est celle des gabarits Django, il en
+existe une <link href="https://docs.djangoproject.com/fr/1.8/ref/templates/">documentation
+détaillée</link> en ligne.
+</p></note>
+
+<note style="advanced"><p>
+Précemment un autre langage de description des gabarits était utilisé (EZT),
+caractérisé par l'utilisation de crochets (ex: <code>[form_var_email]</code>), il
+est toujours disponible mais désormais déconseillé; pour mémoire sa
 <link href="https://github.com/gstein/ezt/blob/wiki/Syntax.md#directives">référence
-détaillée</link> sur le système de template (en anglais).
+détaillée</link> (en anglais) est toujours en ligne.
 </p></note>
 
 </page>