davidbgk
/
larlet-fr-david


			
				
					
						
						
							123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747
							<!doctype html>
<html lang=fr>
<head>
  <!-- Always define the charset before the title -->
  <meta charset=utf-8>
  <title>Le langage de template Django : Pour les auteurs de templates — Biologeek — David Larlet</title>
  <!-- Define a viewport to mobile devices to use - telling the browser to assume that the page is as wide as the device (width=device-width) and setting the initial page zoom level to be 1 (initial-scale=1.0) -->
  <meta name="viewport" content="width=device-width, initial-scale=1"/>
  <!-- Fake favicon, to avoid extra request to the server -->
  <link rel="icon" href="data:;base64,iVBORw0KGgo=">
  <link type="application/atom+xml" rel="alternate" title="Feed" href="/david/log/" />
  <link rel="manifest" href="/manifest.json">
  
  <link rel="stylesheet" href="/static/david/css/larlet-david-_J6Rv.css" data-instant-track />
  
  <noscript>
    <style type="text/css">
      /* Otherwise fonts are loaded by JS for faster initial rendering. See scripts at the bottom. */
      body {
        font-family: 'EquityTextB', serif;
      }
      h1, h2, h3, h4, h5, h6, time, nav a, nav a:link, nav a:visited {
        font-family: 'EquityCapsB', sans-serif;
        font-variant: normal;
      }
    </style>
  </noscript>
  
  <!-- Canonical URL for SEO purposes -->
  <link rel="canonical" href="https://larlet.fr/david/biologeek/archives/20060815-le-langage-de-template-django-pour-les-auteurs-de-templates">

</head>
<body>
  <div>
    
    <header>
      <nav>
        <p>
          <small>
            Je suis <a href="/david/" title="Profil public">David Larlet</a>, <a href="/david/pro/" title="Activité professionnelle">artisan</a> du web qui vous <a href="/david/pro/accompagnement/" title="Activité d’accompagnement">accompagne</a><span class="more-infos"> dans l’acquisition de savoirs pour concevoir des <a href="/david/pro/produits-essentiels/" title="Qu’est-ce qu’un produit essentiel ?">produits essentiels</a></span>. <span class="more-more-infos">Discutons ensemble d’une <a href="/david/pro/devis/" title="En savoir plus">non-demande de devis</a>.</span> Je partage ici mes <a href="/david/blog/" title="Expériences bienveillantes">réflexions</a> et <a href="/david/correspondances/2017/" title="Lettres hebdomadaires">correspondances</a>.
          </small>
        </p>
      </nav>
    </header>
    
    
  <section>
    <h1 property="schema:name">Le langage de template Django : Pour les auteurs de templates</h1>
    <article typeof="schema:BlogPosting">
      <div property="schema:articleBody">
        <img src="/static/david/biologeek/images/logos/django.png" alt="vignette" style="float:left; margin: 0.5em 1em;" property="schema:thumbnailUrl" />
        <p>Le langage de template Django a été conçu dans l'idée d'être un bon compromis
entre puissance et facilité. Il est facilement accessible aux personnes ayant
l'habitude de travailler avec du HTML. Si vous avez déjà utilisé un autre
langage de template, comme <a class="reference" href="http://smarty.php.net/">Smarty</a> ou <a class="reference" href="http://www.cheetahtemplate.org/">CheetahTemplate</a>, vous n'aurez aucune
difficulté à adopter les templates Django.</p>

<div class="section">
<h1><a id="templates" name="templates">Templates</a></h1>
<p>Un template est un simple fichier texte. Il peut générer n'importe quel type de
fichier texte (HTML, XML, CSV, etc).</p>
<p>Un template contient des <strong>variables</strong> qui seront remplacées par leurs valeurs
lors de son évaluation et des <strong>tags</strong> qui controlent la logique du template.</p>
<p>Ci-dessous un template minimal qui illustre les bases. Chaque élément sera
expliqué plus tard dans ce document.:</p>
<pre class="literal-block">
{% extends &quot;base_generic.html&quot; %}

{% block title %}{{ section.title }}{% endblock %}

{% block content %}

&lt;h1&gt;{{ section.title }}&lt;/h1&gt;

{% for story in story_list %}
&lt;h2&gt;
  &lt;a href=&quot;{{ story.get_absolute_url }}&quot;&gt;
    {{ story.headline|upper }}
  &lt;/a&gt;
&lt;/h2&gt;

&lt;p&gt;{{ story.tease|truncatewords:&quot;100&quot; }}&lt;/p&gt;
{% endfor %}
{% endblock %}
</pre>
<div class="admonition-philosophie admonition">
<p class="first admonition-title">Philosophie</p>
<p>Pourquoi utiliser un template au format texte et non au format XML (comme
celui du TAL Zope) ? Nous voulions que le langage de template puisse être
utilisé pour plus que des templates XML/HTML. À World Online, nous
l'utilisons pour les mails, la JavaScript et le CSV. Vous pouvez utiliser le
langage de template pour tout format basé sur du texte.</p>
<p class="last">Oh, encore un truc : Rendre du XML éditable par les humains est sadique !</p>
</div>

</div>

<div class="section">
<h1><a id="variables" name="variables">Variables</a></h1>
<p>Les variables ressemblent à <tt class="docutils literal"><span class="pre">{{</span> <span class="pre">variable</span> <span class="pre">}}</span></tt>. Lorsque le moteur de template
rencontre une variable, il évalue cette variable et la remplace par son
résultat.</p>
<p>Utilisez un point (<tt class="docutils literal"><span class="pre">.</span></tt>) pour accéder aux attributs d'une variable.</p>
<div class="admonition-en-coulisses admonition">

<p class="first admonition-title">En coulisses</p>
<p>Techniquement, lorsque le système de template rencontre un point, il
effectue les recherches suivantes, dans cet ordre :</p>
<blockquote class="last">
<ul class="simple">
<li>Dictionaire</li>
<li>Attribut</li>
<li>Appel de méthode</li>
<li>Index de liste</li>
</ul>
</blockquote>
</div>

<p>Dans le précédent exemple, <tt class="docutils literal"><span class="pre">{{</span> <span class="pre">section.title</span> <span class="pre">}}</span></tt> sera remplacé par l'attribut
<tt class="docutils literal"><span class="pre">title</span></tt> de l'objet <tt class="docutils literal"><span class="pre">section</span></tt>.</p>

<p>Si vous utilisez une variable qui n'existe pas, le système de template va
insérer la valeur contenue dans le paramètre <tt class="docutils literal"><span class="pre">TEMPLATE_STRING_IF_INVALID</span></tt> qui
correspond par défaut à <tt class="docutils literal"><span class="pre">''</span></tt> (chaîne vide).</p>

<p>Lisez <a class="reference" href="#utiliser-les-r-f-rences-incluses">Utiliser les références incluses</a>, ci-dessous, pour vous aider à
connaître les variables disponibles pour un template donné.</p>

<p></div>
<div class="section">
<h1><a id="filtres" name="filtres">Filtres</a></h1>
<p>Vous pouvez modifier des variables lors de l'affichage en utilisant des
<strong>filtres</strong>.</p>
<p>Les filtres ressemblent à <tt class="docutils literal"><span class="pre">{{</span> <span class="pre">name|lower</span> <span class="pre">}}</span></tt>. Ceci affiche la valeur de la
variable <tt class="docutils literal"><span class="pre">{{</span> <span class="pre">name</span> <span class="pre">}}</span></tt> après avoir été filtrée par le filtre <tt class="docutils literal"><span class="pre">lower</span></tt>, qui
convertit un texte en minuscule. Utilisez un pipe (<tt class="docutils literal"><span class="pre">|</span></tt>) pour appliquer un
filtre.</p></p>
<p>Les filtres peuvent « s'enchaîner ». La sortie d'un filtre est l'entrée du
suivant. <tt class="docutils literal"><span class="pre">{{</span> <span class="pre">text|escape|linebreaks</span> <span class="pre">}}</span></tt> est souvent utilisé pour échapper le
contenu d'un texte et convertir ensuite les sauts de lignes en tags <tt class="docutils literal"><span class="pre">&lt;p&gt;</span></tt>.</p>

<p>Certains filtres possèdent des arguments. Un argument de filtre ressemble à :
<tt class="docutils literal"><span class="pre">{{</span> <span class="pre">bio|truncatewords:&quot;30&quot;</span> <span class="pre">}}</span></tt>. Cela va afficher les 30 premiers mots de la
variable <tt class="docutils literal"><span class="pre">bio</span></tt>. Les arguments de filtres sont toujours entre double quotes.</p>

<p>La <a class="reference" href="#r-f-rence-des-filtres-inclus">Référence des filtres inclus</a> ci-dessous décrit l'ensemble des ces filtres.</p>

<p></div>
<div class="section">
<h1><a id="tags" name="tags">Tags</a></h1>
<p>Les tags ressemblent à : <tt class="docutils literal"><span class="pre">{%</span> <span class="pre">tag</span> <span class="pre">%}</span></tt>. Les tags sont plus compliqués que les
variables : certains génèrent une sortie de texte, d'autres contrôlent le flux
grâce aux boucles ou à la logique, et certains chargent des informations
externes dans le template pouvant être utilisées par la suite.</p></p>
<p>Certains tags requièrent des tags de début et de fin (càd.
<tt class="docutils literal"><span class="pre">{%</span> <span class="pre">tag</span> <span class="pre">%}</span> <span class="pre">...</span> <span class="pre">contenu</span> <span class="pre">du</span> <span class="pre">tag</span> <span class="pre">...</span> <span class="pre">{%</span> <span class="pre">endtag</span> <span class="pre">%}</span></tt>). La

<a class="reference" href="#r-f-rence-des-tags-inclus">Référence des tags inclus</a> ci-dessous décris l'ensemble de ces tags. Vous
pouvez écrire vos propres tags si vous connaissez le Python.</p>

<p></div>
<div class="section">
<h1><a id="h-ritage-des-templates" name="h-ritage-des-templates">Héritage des templates</a></h1>
<p>La plus intéressante -- mais aussi la plus complexe -- partie du moteur de
template de Django est l'héritage. L'héritage des templates vous permet de
construire un template « squelette » de base contenant tous les éléments usuels
de votre site et définissant des blocs que les templates enfants pourront
écraser et/ou compléter.</p>
<p>Il est plus simple, pour comprendre l'héritage des templates, de commencer par
un exemple:</p>
<pre class="literal-block">
&lt;!DOCTYPE html PUBLIC &quot;-//W3C//DTD XHTML 1.0 Transitional//EN&quot;
    &quot;http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd&quot;&gt;</p>
<p>&lt;html xmlns=&quot;http://www.w3.org/1999/xhtml&quot; xml:lang=&quot;en&quot; lang=&quot;en&quot;&gt;
&lt;head&gt;
    &lt;link rel=&quot;stylesheet&quot; href=&quot;style.css&quot; /&gt;</p>
<pre><code>&amp;lt;title&amp;gt;{% block title %}Mon super site{% endblock %}&amp;lt;/title&amp;gt;
</code></pre>
<p>&lt;/head&gt;</p>
<p>&lt;body&gt;
    &lt;div id=&quot;sidebar&quot;&gt;
        {% block sidebar %}
        &lt;ul&gt;</p>
<pre><code>        &amp;lt;li&amp;gt;&amp;lt;a href=&amp;quot;/&amp;quot;&amp;gt;Accueil&amp;lt;/a&amp;gt;&amp;lt;/li&amp;gt;
        &amp;lt;li&amp;gt;&amp;lt;a href=&amp;quot;/blog/&amp;quot;&amp;gt;Blog&amp;lt;/a&amp;gt;&amp;lt;/li&amp;gt;
    &amp;lt;/ul&amp;gt;

    {% endblock %}
&amp;lt;/div&amp;gt;

&amp;lt;div id=&amp;quot;content&amp;quot;&amp;gt;
    {% block content %}{% endblock %}
&amp;lt;/div&amp;gt;
</code></pre>
<p>&lt;/body&gt;
</pre>
<p>Ce template, que nous appelerons <tt class="docutils literal"><span class="pre">base.html</span></tt>, définit un simple squelette HTML
que vous pouvez utiliser pour une page à deux colonnes. C'est le boulot des
templates « enfants » de compléter les blocs vides avec du contenu.</p></p>
<p>Dans cet exemple, le tag <tt class="docutils literal"><span class="pre">{%</span> <span class="pre">block</span> <span class="pre">%}</span></tt> définit trois blocs que les templates
enfants peuvent compléter. Tout ce que les tags <tt class="docutils literal"><span class="pre">block</span></tt> font c'est d'indiquer
au moteur de template qu'un template enfant peut écraser ces parties du
template.</p>

<p>Un template enfant pourrait ressembler à ça:</p>

<pre class="literal-block">
{% extends &quot;base.html&quot; %}

{% block title %}Mon super blog{% endblock %}

{% block content %}
{% for entry in blog_entries %}
    &lt;h2&gt;{{ entry.title }}&lt;/h2&gt;

    &lt;p&gt;{{ entry.body }}&lt;/p&gt;
{% endfor %}
{% endblock %}
</pre>

<p>Le tag <tt class="docutils literal"><span class="pre">{%</span> <span class="pre">extends</span> <span class="pre">%}</span></tt> est la clé ici. Il indique au moteur de template que ce
template « étend » un autre template. Lorsque le système de template évalue ce
template, il commence par localiser le parent -- dans notre cas, « base.html ».</p>

<p>À ce moment, le moteur de template va tenir compte des trois tags

<tt class="docutils literal"><span class="pre">{%</span> <span class="pre">block</span> <span class="pre">%}</span></tt> dans <tt class="docutils literal"><span class="pre">base.html</span></tt> et remplacer ces blocs avec le contenu du
template enfant. En fonction de la valeur de <tt class="docutils literal"><span class="pre">blog_entries</span></tt>, la sortie devrait
être proche de:</p>

<pre class="literal-block">
&lt;!DOCTYPE html PUBLIC &quot;-//W3C//DTD XHTML 1.0 Transitional//EN&quot;

    &quot;http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd&quot;&gt;
&lt;html xmlns=&quot;http://www.w3.org/1999/xhtml&quot; xml:lang=&quot;en&quot; lang=&quot;en&quot;&gt;
&lt;head&gt;
    &lt;link rel=&quot;stylesheet&quot; href=&quot;style.css&quot; /&gt;

    &lt;title&gt;Mon super blog&lt;/title&gt;
&lt;/head&gt;

&lt;body&gt;
    &lt;div id=&quot;sidebar&quot;&gt;
        &lt;ul&gt;

            &lt;li&gt;&lt;a href=&quot;/&quot;&gt;Accueil&lt;/a&gt;&lt;/li&gt;
            &lt;li&gt;&lt;a href=&quot;/blog/&quot;&gt;Blog&lt;/a&gt;&lt;/li&gt;
        &lt;/ul&gt;

    &lt;/div&gt;

    &lt;div id=&quot;content&quot;&gt;
        &lt;h2&gt;Billet un&lt;/h2&gt;
        &lt;p&gt;C'est mon premier billet.&lt;/p&gt;

        &lt;h2&gt;Billet deux&lt;/h2&gt;
        &lt;p&gt;C'est mon second billet.&lt;/p&gt;
    &lt;/div&gt;
&lt;/body&gt;
</pre>

<p>Notez que tant que le template enfant ne redéfinit pas le bloc <tt class="docutils literal"><span class="pre">sidebar</span></tt>, la
valeur du template parent est utilisée à la place. Le contenu au sein d'un tag
<tt class="docutils literal"><span class="pre">{%</span> <span class="pre">block</span> <span class="pre">%}</span></tt> dans un template parent est toujours utilisé en dernier lieu.</p>

<p>Vous pouvez utiliser autant de niveaux d'héritage que désiré. L'une des manières
habituelle d'utiliser l'héritage est l'approche à trois niveaux suivante :</p>

<blockquote>
<ul class="simple">
<li>Créez un template <tt class="docutils literal"><span class="pre">base.html</span></tt> qui définit l'apparence globale de votre
site.</li>

<li>Créez un template <tt class="docutils literal"><span class="pre">base_NOMDESECTION.html</span></tt> pour chaque section de votre
site. Par exemple, <tt class="docutils literal"><span class="pre">base_news.html</span></tt>, <tt class="docutils literal"><span class="pre">base_sports.html</span></tt>. Ces templates
étendent tous <tt class="docutils literal"><span class="pre">base.html</span></tt> et incluent le style/design spécifique à la
section.</li>
<li>Créez un template individuel pour chaque type de page, comme les articles
de nouveautés ou les billets d'un blog. Ces templates étendent le template
de la section appropriée.</li>
</ul>
</blockquote>

<p>Cette approche maximise la réutilisation du code et rend facile l'ajout de blocs
partagés entre plusieurs parties du site comme la navigation.</p>

<p>Voici quelques astuces pour utiliser l'héritage :</p>

<blockquote>
<ul class="simple">
<li>Si vous utilisez <tt class="docutils literal"><span class="pre">{%</span> <span class="pre">extends</span> <span class="pre">%}</span></tt> dans un template, ça doit être le
premier tag du template. Dans le cas contraire l'héritage ne fonctionnera
pas.</li>
<li>Il vaut mieux avoir de nombreux tags <tt class="docutils literal"><span class="pre">{%</span> <span class="pre">block</span> <span class="pre">%}</span></tt> dans vos templates de
base. Rappelez-vous, les templates enfants n'ont pas à redéfinir la
totalité des blocs, vous pouvez donc remplir les blocs avec un contenu
intéressant par défaut. Ne redéfinissez ensuite que ceux dont vous avez
besoin. Il vaut mieux en avoir plus que pas assez.</li>

<li>Si vous vous apercevez d'une duplication du contenu dans de nombreux
templates, cela signifie probablement que vous devriez déplacer ce contenu
dans un  <tt class="docutils literal"><span class="pre">{%</span> <span class="pre">block</span> <span class="pre">%}</span></tt> au sein d'un template parent.</li>
<li>Si vous avez besoin du contenu issu du template parent, la variable
<tt class="docutils literal"><span class="pre">{{</span> <span class="pre">block.super</span> <span class="pre">}}</span></tt> est là pour ça. C'est intéressant si vous souhaitez
ajouter quelquechose au contenu parent existant au lieu de l'écraser.</li>

</ul>
</blockquote>

<p>Pour finir, notez l'impossibilité de définir plusieurs tags <tt class="docutils literal"><span class="pre">{%</span> <span class="pre">block</span> <span class="pre">%}</span></tt>
ayant le même nom dans le même template. Cette limitation existe car un tag
block fonctionne dans les deux directions. Cela signifie qu'un tag block ne
procure pas seulement un espace à compléter -- il définit aussi au niveau enfant
le contenu parent accessible dans cet espace (par <tt class="docutils literal"><span class="pre">block.super</span></tt>).</p>

<p></div>
<div class="section">
<h1><a id="utiliser-les-r-f-rences-incluses" name="utiliser-les-r-f-rences-incluses">Utiliser les références incluses</a></h1></p>
<p>L'interface d'administration de Django inclue une référence complète à
l'ensemble des tags et filtres de template disponibles pour un site donné. Pour
y accéder, rendez vous dans votre interface d'administration et cliquez sur le
lien « Documentation » en haut à droite de la page.</p>

<p>La référence est divisée en 4 sections : tags, filtres, modèles et vues.</p>

<p>Les sections <strong>tags</strong> et <strong>filtres</strong> décrivent tous les tags de base (en fait,
les références de tag et de filtre qui suivent proviennent directement de ces
pages) ainsi que vos propres bibliothèques de tags et de filtres disponibles.</p>

<p>La page des <strong>vues</strong> est la plus intéressante. Chaque URL de votre site a une
entrée distincte ici, et cliquer sur cette URL vous donnera accès :</p>

<blockquote>
<ul class="simple">
<li>Au nom de la fonction qui génère cette vue.</li>
<li>À une description succinte de ce que fait la vue.</li>
<li>Au <strong>contexte</strong>, ou une liste de variables accessibles dans le template de
la vue.</li>
<li>Au nom du ou des template(s) qui est(sont) utilisé(s) pour cette vue.</li>
</ul>
</blockquote>

<p>Chaque page de documentation d'une vue dispose aussi d'un bookmarklet que vous
pouvez utiliser pour aller directement de n'importe quelle page à la page de
documentation de cette vue.</p>

<p>Les sites propulsés par Django utilisant généralement des objets de base de
données, la section <strong>modèles</strong> de la page de documentation décrit chaque type
d'objet dans le système courant avec l'ensemble des champs disponibles dans cet
objet.</p>

<p>L'ensemble des pages de documentation vous renseigne sur chaque tag, filtre,
variable et objet disponible pour un template donné.</p>

<p></div>
<div class="section">
<h1><a id="tags-personnalis-s-et-bilbioth-ques-de-filtres" name="tags-personnalis-s-et-bilbioth-ques-de-filtres">Tags personnalisés et bilbiothèques de filtres</a></h1>
<p>Certaines applications procurent des tags personnalisés et des bilbiothèques de
filtres. Pour y accéder dans un template, utilisez le tag <tt class="docutils literal"><span class="pre">{%</span> <span class="pre">load</span> <span class="pre">%}</span></tt>:</p>
<pre class="literal-block">
{% load comments %}</p>
<p>{% comment_form for blogs.entries entry.id with is_public yes %}
</pre></p>
<p>Ci-dessus, le tag <tt class="docutils literal"><span class="pre">load</span></tt> charge la bibliothèque de tags <tt class="docutils literal"><span class="pre">comments</span></tt>, ce qui
rend ensuite le tag <tt class="docutils literal"><span class="pre">comment_form</span></tt> utilisable. Consultez la rubrique
documentation de votre interface d'administration pour trouver la liste des
bibliothèques personnalisées de votre installation.</p>

<p>Le tag <tt class="docutils literal"><span class="pre">{%</span> <span class="pre">load</span> <span class="pre">%}</span></tt> peut prendre plusieurs noms de bibliothèques à la fois,
séparés par des espaces. Exemple:</p>

<pre class="literal-block">
{% load comments i18n %}
</pre>

<div class="section">
<h2><a id="biblioth-ques-personnalis-es-et-h-ritage-des-templates" name="biblioth-ques-personnalis-es-et-h-ritage-des-templates">Bibliothèques personnalisées et héritage des templates</a></h2>
<p>Lorsque vous chargez un tag personnalisé ou une bibliothèque de filtres, les
tags/filtres ne sont accessibles qu'au sein du template courant -- et aucun des
templates parents ou enfants issus de l'héritage des templates n'y a accès.</p>
<p>Par exemple, si un template <tt class="docutils literal"><span class="pre">foo.html</span></tt> a <tt class="docutils literal"><span class="pre">{%</span> <span class="pre">load</span> <span class="pre">comments</span> <span class="pre">%}</span></tt>, un template
enfant (par exemple, un qui a <tt class="docutils literal"><span class="pre">{%</span> <span class="pre">extends</span> <span class="pre">&quot;foo.html&quot;</span> <span class="pre">%}</span></tt>) n'aura <em>pas</em> accès
aux filtres et tags du template comments. Le template enfant doit avoir son
propre <tt class="docutils literal"><span class="pre">{%</span> <span class="pre">load</span> <span class="pre">comments</span> <span class="pre">%}</span></tt>.</p>

<p>C'est une fonctionnalité pour la maintenabilité et l'intégrité des templates.</p>
</div>

<p></div>
<div class="section">
<h1><a id="r-f-rence-des-tags-et-filtres-inclus" name="r-f-rence-des-tags-et-filtres-inclus">Référence des tags et filtres inclus</a></h1>
<p>Pour ceux ne disposant pas d'une interface d'administration, la référence des
tags et filtres suit. En raison de la personnalisation possible de Django, la
référence dans votre administration prévaut sur celle-ci concernant
l'accessibilité et la fonction des tags et filtres.</p>
<div class="section">
<h2><a id="r-f-rence-des-tags-inclus" name="r-f-rence-des-tags-inclus">Référence des tags inclus</a></h2>
</div>
<div class="section">
<h2><a id="r-f-rence-des-filtres-inclus" name="r-f-rence-des-filtres-inclus">Référence des filtres inclus</a></h2>
<p><strong>La suite de la traduction est en cours</strong>, j'ai jugé qu'il était plus important
de publier cette première partie qui pose les bases en attendant. Il faut avouer
que <a class="reference" href="http://www.djangoproject.com/documentation/templates/#built-in-tag-and-filter-reference">la suite (en)</a> est moins passionnante...</p></p>
<p>Vous pouvez maintenant retourner à la <a class="reference" href="https://larlet.fr/david/biologeek/archives/20060617-traduction-francaise-de-la-documentation-de-django-le-framework-web-python/">page d'accueil des traductions de la
documentation de Django</a>.</p>

<p>Cette traduction correspond à la révision 3589 (post 0.95).</p>

<p></div>
</div></p>
      </div>
    </article>
    <footer>
      <h6 property="schema:datePublished">— 15/08/2006</h6>
    </footer>
  </section>
  <section>
    <div>
      <h3>Articles peut-être en rapport</h3>
      <ul>
        <li><a href="/david/biologeek/archives/20060715-comparaison-de-turbogears-et-django-deux-frameworks-web-python/" title="Accès à Comparaison de TurboGears et Django, deux frameworks web Python">Comparaison de TurboGears et Django, deux frameworks web Python</a></li>
        <li><a href="/david/biologeek/archives/20060617-redaction-de-votre-premiere-appli-django-partie-4-conception-d-un-formulaire-et-vues-generiques/" title="Accès à Rédaction de votre première appli Django, partie 4 : Conception d&#39;un formulaire et vues génériques">Rédaction de votre première appli Django, partie 4 : Conception d&#39;un formulaire et vues génériques</a></li>
        <li><a href="/david/biologeek/archives/20060617-redaction-de-votre-premiere-appli-django-partie-3-creation-des-vues-de-l-interface-publique/" title="Accès à Rédaction de votre première appli Django, partie 3 : Création des vues de l&#39;interface publique">Rédaction de votre première appli Django, partie 3 : Création des vues de l&#39;interface publique</a></li>
      </ul>
    </div>
  </section>
  <section>
    <div id="comments">
      <h3>Commentaires</h3>
      
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">Bernard</span> le <span class="comment-date" property="schema:commentTime">16/08/2006</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>waaaoou merci beaucoup! J'en suis a mes premiers babultiements en Python et je voulais justement utiliser django pour un projet web personnel!</p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">djangofan</span> le <span class="comment-date" property="schema:commentTime">13/11/2006</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p><a href="http://www.djangobook.com/en/beta/" title="http://www.djangobook.com/en/beta/" rel="nofollow">www.djangobook.com/en/bet...</a><br />
<br />
-&gt; <a href="http://www.djangobook.com/fr/beta/" title="http://www.djangobook.com/fr/beta/" rel="nofollow">www.djangobook.com/fr/bet...</a><br />
<br />
:D  a mission for biologeek !</p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">djangofan</span> le <span class="comment-date" property="schema:commentTime">13/11/2006</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>Une petite question à propos des templates. J'ai une classe Annonce à laquelle se rattache une classe Photo. Je voudrais afficher une photo dans ma page web, mais je n'arrive pas à extraire l'url du lien.<br />
<br />
J'ai essayé :<br />
<br />
&lt;img src=&quot;{{ annonce.photo[1].url }}&quot; width=&quot;120&quot; height=&quot;90&quot; /&gt;<br />
&lt;img src=&quot;{{ annonce.photo(1).url }}&quot; width=&quot;120&quot; height=&quot;90&quot; /&gt;<br />
<br />
mais ça fonctionne pas. Une idée de la syntaxe à utiliser ?<br />
<br />
Merci<br />
</p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">David, biologeek</span> le <span class="comment-date" property="schema:commentTime">13/11/2006</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>Normalement, tu dois avoir créé une méthode get_aboslute_url() dans ton model qui te permet de récupérer cette url, cf la doc :<br />
<br />
<a href="http://www.djangoproject.com/documentation/model_api/#get-absolute-url" title="http://www.djangoproject.com/documentation/model_api/#get-absolute-url" rel="nofollow">www.djangoproject.com/doc...</a>
<br /><br />
ps : et pour le djangobook c'est en cours de réflexion ;-).
</p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">djangofan</span> le <span class="comment-date" property="schema:commentTime">13/11/2006</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>En fait c'est pas ça, d'ailleurs quand je me relis, c'est pas clair. :-D<br />
Ce que je voudrais en faite c'est acceder à la valeur de la propriété url de la classe photo. Elle meme est une &quot;sous-classe&quot; de la classe annonce.<br />
<br />
Je sais pas si je suis bien compréhensible !<br />
<br />
</p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">David, biologeek</span> le <span class="comment-date" property="schema:commentTime">13/11/2006</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>Pas vraiment :D<br />
Il y a un moyen que tu me colles ton model quelquepart (ou par mail ?)</p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">DjangoJO</span> le <span class="comment-date" property="schema:commentTime">21/12/2006</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>Bonjour,<br />
<br />
Voilà une petite question qui se pose !<br />
J'ai un projet principale qui comporte une partie blog et une partie sondage et accueil. Comment faire pour appeler mon template accueil en y incorporant mon blog et mon sondage?<br />
<br />
personnellement j'y arrive en appellant sondage herité de accueil OU blog herité de accueil mais je n'arrive pas à avoir les deux dans mon template accueil.<br />
<br />
Merci </p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">David, biologeek</span> le <span class="comment-date" property="schema:commentTime">21/12/2006</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>Il y a trois solutions :<br />
<br />
* soit tu passes par les vues génériques et dans ce cas il faut lire l'article de James <a href="http://www.b-list.org/weblog/2006/11/16/django-tips-get-most-out-generic-views" title="http://www.b-list.org/weblog/2006/11/16/django-tips-get-most-out-generic-views" rel="nofollow">www.b-list.org/weblog/200...</a><br />
<br />
* soit tu mets tout ce dont tu as besoin dans le dictionnaire permettant que tu passes à ta vue.<br />
<br />
* soit tu utilises les templatetags, une explication sur b-list aussi (site de référence) : <a href="http://www.b-list.org/weblog/2006/06/07/django-tips-write-better-template-tags" title="http://www.b-list.org/weblog/2006/06/07/django-tips-write-better-template-tags" rel="nofollow">www.b-list.org/weblog/200...</a>.<br />
<br />
Tu peux m'envoyer ton code si tu veux plus d'explications.<br />
</p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">djangofan2</span> le <span class="comment-date" property="schema:commentTime">21/02/2007</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>J'ai un champs :<br />
 CV = models.FileField(&quot;CV &quot;, upload_to=&quot;candidats/&quot;, blank=True)<br />
<br />
Et dans mon template je fait : <br />
<br />
&lt;input type=&quot;file&quot; size=55 maxlength=100000 name=&quot;CV&quot; id=&quot;id_CV&quot;&gt;<br />
<br />
Puis je vérifie dans ma partie administration et dans le champs CV il met que le nom du fichier donc il ne me telecharge pas dans le dossier&quot;candidats&quot; le CV!!!<br />
(( ce qui marche bien sur si je rajoute une candidature à la main dans la partie administration.<br />
<br />
Quelqu'un pourrai m'aider SVP.<br />
<br />
Merci<br />
<br />
<br />
</p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">David, biologeek</span> le <span class="comment-date" property="schema:commentTime">21/02/2007</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>@djangofan2 : tu peux essayer de mettre un chemin absolu pour l'upload. Ah et n'oublie pas les " pour les valeurs de tes attributs dans ton html (pour size et maxlength).</p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">DjangoFan2</span> le <span class="comment-date" property="schema:commentTime">26/02/2007</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>Bonjour,<br />
<br />
J'aimerai tout simplement savoir si il est possible d'utiliser le search_field de la partie admin de django dans un template personnel ?<br />
<br />
A part si bien sûr, il existe un module de recherche de django ? ou bien alors il faut le faire soit même ?<br />
<br />
Comme on peut le voir sur la plus part des sites internet il y a toujours une zone recherche ...<br />
<br />
Merci</p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">David, biologeek</span> le <span class="comment-date" property="schema:commentTime">26/02/2007</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>@DjangoFan2 : c'est une vue à coder soit-même car elle est très spécifique de l'application développée.</p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">DjangoFan2</span> le <span class="comment-date" property="schema:commentTime">26/02/2007</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>Merci,<br />
Bien je vais m'y mettre sans trop tarder alors !!!<br />
<br />
Et juste pour savoir :: <br />
 - j'ai un menu en javascript qui fonctionne très bien mais quand j'utilise les fichiers js de django genre calendar.js il ne se passe rien serais-tu pourquoi ?<br />
<br />
- L'utilisation d'ajax est-il possible ? si oui comment faire pour inclure un fichier (exemple en php :&lt;? include(&quot;menu.php&quot;);?&gt;<br />
<br />
Merci beaucoup pour tous ses renseignements !!!<br />
<br />
<br />
</p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">David, biologeek</span> le <span class="comment-date" property="schema:commentTime">26/02/2007</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>&gt; j'ai un menu en javascript qui fonctionne très bien mais quand j'utilise les fichiers js de django genre calendar.js il ne se passe rien serais-tu pourquoi ?<br />
<br />
Il doit y avoir un conflit entre les variables js de tes deux fichiers (?)<br />
<br />
&gt; L'utilisation d'ajax est-il possible ? <br />
<br />
Bien sûr !<br />
<br />
&gt; si oui comment faire pour inclure un fichier (exemple en php :&lt;? include(&quot;menu.php&quot;);?&gt;<br />
<br />
Ça c'est de l'héritage de template, pas de l'AJAX. cf le billet de Jeff Croft : <a href="http://www2.jeffcroft.com/blog/2006/feb/25/django-templates-the-power-of-inheritance/" title="http://www2.jeffcroft.com/blog/2006/feb/25/django-templates-the-power-of-inheritance/" rel="nofollow">www2.jeffcroft.com/blog/2...</a><br />
</p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">djangoNew</span> le <span class="comment-date" property="schema:commentTime">28/02/2007</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>Merci beaucoup pour le tuto, c'est très clair et bien expliqué .<br />
<br />
Par contre j'aimerai savoir si c'est possible de  comparer une variable dans les &quot;if&quot; ( exemple : {% if cpt=2 %} ou faire le même style d'opération comme en php.<br />
<br />
Car j'ai créer un menu en html et javascript, mais j'ai besoin que ce menu soit complétement dynamique donc il faut que je le remplisse via un modéle.<br />
<br />
Merci beaucoup<br />
<br />
Et encore bravo pour le site</p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">David, biologeek</span> le <span class="comment-date" property="schema:commentTime">28/02/2007</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>Il existe ifequal pour ça  : {% ifequal cpt 2 %}<br />
<br />
Mais pour ton cas, un block extraclass dans chacune des classes de ton menu devrait être plus adapté, enfin c'est ainsi que je procède...<br />
<br />
Bienvenue dans l'univers Django :-)</p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">djangoNew</span> le <span class="comment-date" property="schema:commentTime">02/03/2007</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>Me revoilà pour d'autre petites questions sur des choses que je n'ai pas trop trop compris !<br />
Merci encore pour toutes ses explications !<br />
<br />
C'est une question d'heritage ! En ayant deux module différents genre contact et FAQ comment puis je heriter leurs templates respectif sur un même template general genre base.html !!!<br />
<br />
J'ai compris l'histoire des templates car c'est très bien expliqué mais là je suis un peu perdu !<br />
<br />
MERCI d'avance<br />
</p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">David, biologeek</span> le <span class="comment-date" property="schema:commentTime">03/03/2007</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>Il suffit de faire un {% extends &quot;base.html&quot; %} en première ligne de ton template. Si tu veux tu peux regarder ce que ça donne pour le site de django-fr.org : <a href="http://trac.django-fr.org/trac/browser/site/trunk" title="http://trac.django-fr.org/trac/browser/site/trunk" rel="nofollow">trac.django-fr.org/trac/b...</a></p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">djangoNew</span> le <span class="comment-date" property="schema:commentTime">05/03/2007</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>Merci pour le lien, j'ai regardé les différents templates mais le probléme qui se pour moi, ne se pose pas pour les templates du lien en question, car le texte est rentré en dur dans la page, que personellement je recupére le texte d'une view.<br />
<br />
Je me suis peut être mal exprimé la derniére fois !<br />
<br />
La seule action qui déclenche une view c'est l'url en question (a ce que j'ai compris).<br />
Si je veux afficher les articles de mon module et les contacts de mon autre module normalement il faut que j'appele la view &quot;Articles&quot; et la view &quot;Contact&quot; avec leurs url respectif ( genre : www.monsite/article et www.monsite/contact) !<br />
Mais moi je voudrai que quand je tape par exemple l'url : www.monsite.com/accueil je puisse avoir les articles et les contacts en bas de la page base.html. <br />
<br />
Mais le problème qui se pose : Si j'appele www.monsite/Article, il vas me retourner la view correspondante avec la page article.html que j'&quot;extends&quot; de base.html mais comment faire pour que je puisse aussi appelé la view de contact et l'extends de base.html ??<br />
<br />
Désolé mais je ne n'arrive vraiment pas à voir comment je puisse faire et à cause de se probléme, je ne peux avancer sur mon projet personel ... <br />
<br />
<br />
<br />
</p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">David, biologeek</span> le <span class="comment-date" property="schema:commentTime">05/03/2007</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>Les solutions possibles dans ce cas sont répertoriées dans un précédent commentaire : le numéro 8 (un peu plus haut), notamment les templatetags qui sont je pense la solution la plus élégante.</p>
    </div>
</div>
<div class="comment" typeof="schema:UserComments">
    <p class="comment-meta">
        <span class="comment-author" property="schema:creator">Ouarnier</span> le <span class="comment-date" property="schema:commentTime">19/01/2010</span> :
    </p>
    <div class="comment-content" property="schema:commentText">
        <p>Bonjour,</p>

<p>J&#39;ai un projet qui a deux applications. <br />dans chacune de ces applications, j&#39;ai une template defini. Une template qui affiche un budget de fonctionnement et dans l&#39;autre appli, une template qui affiche un budget de personnel.</p>

<p>je voudrais faire une page tableau de bord qui affiche les deux templates ?<br />comment faire ?</p>

<p>j&#39;ai lu le commentaire 8 mais je ne comprends pas comment faire ?<br />je n&#39;arrive pas à comprendre comment je peux faire ça avec les templates tags.</p>
    </div>
</div>

    </div>
  </section>

    
    <footer>
      <nav>
        <p>
          <small>
            Je réponds quasiment toujours aux <a href="m&#x61;ilto:d&#x61;vid%40l&#x61;rlet&#46;fr" title="Envoyer un email">emails</a> (<a href="/david/signature/" title="Ma signature actuelle avec possibilité de chiffrement">signés</a>) et vous pouvez me rencontrer à Montréal. <span class="more-infos">N’hésitez pas à <a href="/david/log/" title="Être tenu informé des mises à jour">vous abonner</a> pour être tenu informé des publications récentes.</span>
          </small>
        </p>
      </nav>
    </footer>
    
  </div>
  
  <script src="/static/david/js/larlet-david-3ee43f.js" data-no-instant></script>
  
  <script data-no-instant>InstantClick.init()</script>
  
</body>
</html>