sync with EN

This commit is contained in:
yannick
2006-02-18 17:54:23 +00:00
parent d6c762d729
commit bc7dc1b9ba
16 changed files with 140 additions and 121 deletions

View File

@@ -1,6 +1,7 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.9 Maintainer: didou Status: ready -->
<!-- EN-Revision: 1.10 Maintainer: didou Status: ready -->
<chapter id="tips">
<title>Trucs et astuces</title>
<para></para>
@@ -22,8 +23,7 @@
<programlisting>
<![CDATA[
{* la m<>thode pas adapt<70>e *}
{if $title eq ""}
{if $title eq ''}
&nbsp;
{else}
{$title}
@@ -31,8 +31,7 @@
{* la bonne m<>thode *}
{$title|default:"&nbsp;"}
{$title|default:'&nbsp;'}
]]>
</programlisting>
</example>
@@ -55,8 +54,8 @@
<title>assigner une valeur par d<>faut <20> une variable de template</title>
<programlisting>
<![CDATA[
{* faites cel<EFBFBD> quelque part en haut de votre template *}
{assign var="title" value=$title|default:"no title"}
{* faites cela quelque part en haut de votre template *}
{assign var='title' value=$title|default:'no title'}
{* si $title est vide, il contiendra alors la valeur "no title" *}
{$title}
@@ -77,45 +76,50 @@
il est d'usage de les mettre dans leurs propres templates et de les inclure
(<link linkend="language.function.include">{include}</link>).
Mais comment faire si l'en-t<>te doit avoir un titre diff<66>rent, selon la page
d'o<> on vient ? Vous pouvez passer le titre <20> l'en-t<>te quand il est inclus.
d'o<> on vient ? Vous pouvez passer le titre <20> l'en-t<>te en tant qu'
<link linkend="language.syntax.attributes">attribut</link> quand il est inclus.
</para>
<example>
<title>passer le titre au template d'en-t<>te</title>
<para>
<filename>mainpage.tpl</filename>
<filename>mainpage.tpl</filename> - Lorsque la page principal est construite,
le titre 'Man Page' est pass<73> au <filename>header.tpl</filename> et sera utilis<69>
en tant que titre.
</para>
<programlisting>
<![CDATA[
{include file="header.tpl" title="Main Page"}
{include file='header.tpl' title='Main Page'}
{* le corps du template va ici *}
{include file="footer.tpl"}
{include file='footer.tpl'}
]]>
</programlisting>
<para>
<filename>archives.tpl</filename>
<filename>archives.tpl</filename> - Lorsque la page principal est construite, le titre
sera 'Archives'. Notez que dans cet exemple, nous utilisons une variable du fichier
<filename>archives_page.conf</filename> au lieu d'une variable classique.
</para>
<programlisting>
<![CDATA[
{config_load file="archive_page.conf"}
{include file="header.tpl" title=#archivePageTitle#}
{* template body goes here *}
{include file="footer.tpl"}
{config_load file='archive_page.conf'}
{include file='header.tpl' title=#archivePageTitle#}
{* corps du template ici *}
{include file='footer.tpl'}
]]>
</programlisting>
<para>
<filename>header.tpl</filename>
<filename>header.tpl</filename> - Notez que "BC News" est affich<63> si la variable
$title n'est pas d<>finie, en utilisant le modificateur de variable par
<link linkend="language.modifier.default">d<EFBFBD>faut</link>.
</para>
<programlisting>
<![CDATA[
<html>
<head>
<title>{$title|default:"BC News"}</title>
<title>{$title|default:'BC News'}</title>
</head>
<body>
]]>
@@ -131,23 +135,14 @@
]]>
</programlisting>
</example>
<para>
Quand la page principale est con<6F>ue, le titre "Main page" est pass<73> <20>
<filename>header.tpl</filename> et sera donc utilis<69> pour le titre.
Quand la page d'archive est con<6F>ue, le titre sera "Archives".
Notez que dans l'exemple des archives, on utilise
le fichier <filename>archives_page.conf</filename> plut<75>t que des
variables cod<6F>es en dur. Remarquez aussi que "BC News" est affich<63>e
si la variable $title n'est pas d<>finie, gr<67>ce au modificateur de variable
<link linkend="language.modifier.default">default</link>.
</para>
</sect1>
<sect1 id="tips.dates">
<title>Dates</title>
<para>
De fa<66>on g<>n<EFBFBD>rale, essayez de toujours passer les dates <20> Smarty
sous forme de timestamp. Cel<65> permet aux designers de templates d'utiliser
sous forme de <ulink url="&url.php-manual;time">timestamp</ulink>.
Cel<65> permet aux designers de templates d'utiliser
<link linkend="language.modifier.date.format">date_format</link>
pour avoir un contr<74>le total sur le formatage des dates et de comparer
facilement les dates entre elles.
@@ -197,8 +192,8 @@ Jan 4, 2001
</example>
<para>
En utilisant la fonction <link linkend="language.function.html.select.date">{html_select_date}</link>
dans un template, le programmeur
veut en g<>n<EFBFBD>ral convertir le r<EFBFBD>sultat d'un formulaire en un timestamp.
dans un template, le programmeur veut en g<>n<EFBFBD>ral convertir le
r<>sultat d'un formulaire en un timestamp.
Voici une fonction qui devrait vous <20>tre utile.
</para>
<example>
@@ -238,8 +233,8 @@ function makeTimeStamp($year='', $month='', $day='')
<link linkend="language.modifier.date.format">date_format</link> et
<link linkend="language.variables.smarty.now">$smarty.now</link>,
</para>
</sect1>
<sect1 id="tips.wap">
<title>WAP/WML</title>
<para>

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.6 Maintainer: gerald Status: ready -->
<!-- EN-Revision: 1.7 Maintainer: gerald Status: ready -->
<sect1 id="language.escaping">
<title>D<EFBFBD>sactiver l'analyse de Smarty</title>
<para>
@@ -42,6 +42,7 @@ $smarty = new Smarty;
$smarty->left_delimiter = '<!--{';
$smarty->right_delimiter = '}-->';
$smarty->assign('foo', 'bar');
$smarty->assign('name', 'Albert');
$smarty->display('example.tpl');
?>
@@ -52,6 +53,7 @@ $smarty->display('example.tpl');
</para>
<programlisting>
<![CDATA[
Bienvenue <!--{$name}--> sur Smarty
<script language="javascript">
var foo = <!--{$foo}-->;
function dosomething() {

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.4 Maintainer: gerald Status: ready -->
<!-- EN-Revision: 1.5 Maintainer: gerald Status: ready -->
<sect1 id="language.syntax.attributes">
<title>Param<EFBFBD>tres</title>
@@ -15,9 +15,10 @@
</para>
<para>
Certains param<61>tres requi<75>rent des valeurs bool<6F>ennes (true / false).
Elles peuvent <20>tre sp<73>cifi<66>es par l'une des valeures suivantes, sans
guillemet: <literal>true</literal>, <literal>on</literal>, et <literal>yes</literal>,
ou <literal>false</literal>, <literal>off</literal>, et <literal>no</literal>.
Elles <link linkend="variable.config.booleanize">peuvent <20>tre sp<73>cifi<66>es</link>
par l'une des valeures suivantes, sans guillemet: <literal>true</literal>,
<literal>on</literal>, et <literal>yes</literal>, ou <literal>false</literal>,
<literal>off</literal>, et <literal>no</literal>.
</para>
<example>
<title>Param<EFBFBD>tres de fonction, syntaxe</title>

View File

@@ -1,16 +1,16 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.4 Maintainer: gerald Status: ready -->
<!-- EN-Revision: 1.5 Maintainer: gerald Status: ready -->
<sect1 id="language.syntax.comments">
<title>Commentaires</title>
<para>
Les commentaires dans Smarty sont entour<75>s d'asterisques,
et entour<75>s par le <link linkend="variable.left.delimiter">d<EFBFBD>limiteurs</link>
de cette fa<66>on : {* voici un commentaire *}
de cette fa<66>on : <emphasis>{* voici un commentaire *}</emphasis>
Les commentaires Smarty ne sont PAS affich<63>s dans la sortie finale du
template, diff<66>remment des &lt;!-- commentaires HTML --&gt;.
Ils sont utilis<69>s pour des notes internes, dans le template, pour aider
template, diff<66>remment des &lt;!-- commentaires HTML --&gt;
et sont utilis<69>s pour des notes internes, dans le template, pour aider
les d<>veloppeurs <20> en comprendre le fonctionnement.
</para>
<example>
@@ -25,7 +25,7 @@
*}
{* Inclusion de l'en t<>te *}
{include file="header.tpl"}
{include file='header.tpl'}
{* Note aux d<>veloppeurs : $includeFile est assign<67> au script foo.php *}
@@ -40,6 +40,7 @@
{html_options options=$vals selected=$selected_id}
</select>
*}
</body>
]]>
</programlisting>

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.7 Maintainer: gerald Status: ready -->
<!-- EN-Revision: 1.8 Maintainer: gerald Status: ready -->
<sect1 id="language.syntax.quotes">
<title>Variables ins<6E>r<EFBFBD>es dans des cha<68>nes de caract<63>res</title>
@@ -11,8 +11,9 @@
cha<68>nes entre guillemets, du moment que leur nom est exclusivement compos<6F>
de chiffres, lettres, underscores et crochets. Si le nom de la variable
contient tout autre caract<63>re (point, r<>f<EFBFBD>rence <20> un objet, etc.)
la variable doit <20>tre entour<75>e d'apostrophes inverses (`). Vous ne pouvez jamais
ins<EFBFBD>rer de <link linkend="language.modifiers">modifieurs</link>, ils doivent toujours <20>tre appliquer <20>
la variable doit <20>tre entour<75>e <link linkend="language.syntax.quotes">d'apostrophes
inverses</link> (`). Vous ne pouvez jamais ins<6E>rer de
<link linkend="language.modifiers">modifieurs</link>, ils doivent toujours <20>tre appliquer <20>
l'ext<78>rieur des guillemets.
</para>
<example>

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.10 Maintainer: gerald Status: ready -->
<!-- EN-Revision: 1.11 Maintainer: gerald Status: ready -->
<sect1 id="language.function.capture">
<title>{capture}</title>

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.9 Maintainer: gerald Status: ready -->
<!-- EN-Revision: 1.10 Maintainer: gerald Status: ready -->
<sect1 id="language.function.include.php">
<title>{include_php}</title>
@@ -65,7 +65,7 @@
<para>
Les balises {include_php} sont utilis<69>es pour inclure directement
un script PHP dans vos templates. Si <link linkend="variable.security">"security" est activ<69></link>,
un script PHP dans vos templates. Si <link linkend="variable.security">$security</link> est activ<69>,
alors le script <20> ex<65>cuter doit <20>tre plac<61> dans le chemin <link
linkend="variable.trusted.dir">$trusted_dir</link>. La balise
{include_php} attends l'attribut "file", qui contient le chemin du
@@ -96,9 +96,9 @@
<?php
// charge des variables depuis une base de donn<6E>es mysql et les assigne au template.
require_once("MySQL.class.php");
require_once('MySQL.class.php');
$sql = new MySQL;
$sql->query("select * from site_nav_sections order by name",SQL_ALL);
$sql->query('select * from site_nav_sections order by name',SQL_ALL);
$this->assign('sections',$sql->record);
?>
@@ -110,7 +110,7 @@ $this->assign('sections',$sql->record);
<programlisting>
<![CDATA[
{* chemin absolu, ou relatif <20> $trusted_dir *}
{include_php file="/chemin/vers/load_nav.php"}
{include_php file='/chemin/vers/load_nav.php'}
{foreach item="curr_section" from=$sections}
<a href="{$curr_section.url}">{$curr_section.name}</a><br />

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.11 Maintainer: yannick Status: ready -->
<!-- EN-Revision: 1.12 Maintainer: yannick Status: ready -->
<sect1 id="language.function.include">
<title>{include}</title>
@@ -10,7 +10,8 @@
l'int<6E>rieur d'autres templates. Toutes les variables disponibles
dans le template r<>alisant l'inclusion sont disponibles dans le
template inclus. La balise {include} doit disposer de l'attribut
"file", qui contient le chemin de la ressource template.
<emphasis>'file'</emphasis>, qui contient le chemin de la
ressource template.
</para>
<para>
Vous pouvez sp<73>cifier un attribut optionnel <emphasis>'assign'</emphasis>

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.8 Maintainer: yannick Status: ready -->
<!-- EN-Revision: 1.9 Maintainer: yannick Status: ready -->
<sect1 id="language.function.strip">
<title>{strip}</title>

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready -->
<sect1 id="language.modifier.strip">
<title>strip</title>
@@ -34,7 +34,7 @@ O
<![CDATA[
{$titreArticle}
{$titreArticle|strip}
{$titreArticle|strip:"&nbsp;"}
{$titreArticle|strip:'&nbsp;'}
]]>
</programlisting>
<para>

View File

@@ -1,20 +1,24 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.2 Maintainer: yannick Status: ready -->
<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready -->
<sect1 id="advanced.features.outputfilters">
<title>Filtres de sortie</title>
<para>
Quand le template est appel<65> via les fonctions display() ou fetch(),
Quand le template est appel<65> via les fonctions
<link linkend="api.display">display()</link> ou
<link linkend="api.fetch">fetch()</link>,
sa sortie est envoy<6F>e <20> travers un ou plusieurs filtres de sorties.
Ils diff<66>rent des filtres de post-compilation dans le sens o<> ils agissent
sur la sortie des templates, une fois ex<65>cut<75>s, et non sur les sources
des templates.
Ils diff<66>rent des <link linkend="advanced.features.postfilters">filtres
de post-compilation</link> dans le sens o<> ils agissent sur la sortie
des templates, une fois ex<65>cut<75>s, et non sur les sources des templates.
</para>
<para>
Les filtres de sortie peuvent <20>tre soit
<link linkend="api.register.outputfilter">d<EFBFBD>clar<EFBFBD>s</link> soit
charg<72>s depuis les r<EFBFBD>pertoires des plugins en utilisant la fonction
charg<72>s depuis les <link linkend="variable.plugins.dir">r<EFBFBD>pertoires
des plugins</link> en utilisant la fonction
<link linkend="api.load.filter">load_filter()</link>
ou en r<>glant la variable
<link linkend="variable.autoload.filters">$autoload_filters</link>.
@@ -36,8 +40,8 @@ function protect_email($tpl_output, &$smarty)
}
// enregistre le filtre de sortie
$smarty->register_outputfilter("protect_email");
$smarty->display("index.tpl");
$smarty->register_outputfilter('protect_email');
$smarty->display('index.tpl');
// dor<6F>navant toute occurence d'un adresse email dans le r<>sultat du template
// aura un protection simple contre les robots spammers
@@ -45,6 +49,14 @@ $smarty->display("index.tpl");
]]>
</programlisting>
</example>
<para>
Voir aussi
<link linkend="api.register.outputfilter">register_outpurfilter()</link>,
<link linkend="api.load.filter">load_filter()</link>,
<link linkend="variable.autoload.filters">$autoload_filters</link>
les <link linkend="advanced.features.postfilters">filtres de post-compilation</link> et
<link linkend="variable.plugins.dir">$plugins_dir</link>.
</para>
</sect1>
<!-- Keep this comment at the end of the file
Local variables:

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready -->
<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready -->
<sect1 id="advanced.features.postfilters">
<title>Filtres de post-compilation</title>

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready -->
<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready -->
<refentry id="api.is.cached">
<refnamediv>
@@ -17,7 +17,7 @@
</methodsynopsis>
<para>
Cel<65> fonctionne seulement si <link linkend="variable.caching">$caching</link>
est d<>fini <20> <literal>true</literal>. Voir aussi la
est d<>fini <20> <literal>true</literal> ; voir aussi la
<link linkend="caching">section sur le cache</link>.
</para>
<example>
@@ -85,7 +85,6 @@ $smarty->display('index.tpl', 'FrontPage');
is_cached() a retourn<72> vrai.
</para>
</note>
<para>
Voir aussi
<link linkend="api.clear.cache">clear_cache()</link>,

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.3 Maintainer: yannick Status: ready -->
<!-- EN-Revision: 1.4 Maintainer: yannick Status: ready -->
<refentry id="api.register.resource">
<refnamediv>
@@ -57,7 +57,6 @@ $smarty->register_resource('db', array(
]]>
</programlisting>
</example>
<para>
Voir aussi
<link linkend="api.unregister.resource">unregister_resource()</link> et

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.5 Maintainer: yannick Status: ready -->
<!-- EN-Revision: 1.6 Maintainer: yannick Status: ready -->
<sect1 id="caching.groups">
<title>Groupes de fichiers de cache</title>
@@ -13,16 +13,18 @@
<para>
Vous pouvez voir les groupes de cache comme une hi<68>rarchie de dossiers.
Par exemple, un groupe de cache "a|b|c" peut <20>tre consid<69>r<EFBFBD> comme
la hi<68>rarchie de dossiers "/a/b/c/". Ainsi, clear_cache(null,"a|b|c") supprimerait
la hi<68>rarchie de dossiers "/a/b/c/". Ainsi,
<link linkend="api.clear.cache">clear_cache</link>(null,"a|b|c") supprimerait
les fichiers "/a/b/c/*". clear_cache(null,"a|b") supprimerait les fichiers
"/a/b/*". Si vous sp<73>cifiez un compile_id de cette fa<66>on : clear_cache(null,"a|b","foo"),
il sera trait<69> comme un groupe de cache appos<6F> "/a/b/c/foo/". Si vous
sp<73>cifiez un nom de template de cette fa<66>on : clear_cache("foo.tpl","a|b|c"),
alors Smarty tentera d'effacer "/a/b/c/foo.tpl". Vous ne POUVEZ PAS effacer
un nom de template sp<73>cifi<66> sous un groupe de cache multiple comme
"/a/b/*/foo.tpl", le groupement de cache fonctionne UNIQUEMENT de gauche <20> droite.
Vous pourriez vouloir grouper vos templates sous un groupe de cache simple
hi<68>rarchis<69> pour <20>tre capable de les effacer comme un groupe.
"/a/b/*". Si vous sp<73>cifiez un <link linkend="variable.compile.id">$compile_id</link>
de cette fa<66>on : clear_cache(null,"a|b","foo"), il sera trait<69> comme un groupe de
cache appos<6F> "/a/b/c/foo/". Si vous sp<EFBFBD>cifiez un nom de template de cette fa<66>on :
clear_cache("foo.tpl","a|b|c"), alors Smarty tentera d'effacer "/a/b/c/foo.tpl".
Vous ne POUVEZ PAS effacer un nom de template sp<73>cifi<66> sous un groupe de
cache multiple comme "/a/b/*/foo.tpl", le groupement de cache fonctionne
UNIQUEMENT de gauche <20> droite. Vous pourriez vouloir grouper vos templates
sous un groupe de cache simple hi<EFBFBD>rarchis<EFBFBD> pour <20>tre capable de les effacer
comme un groupe.
</para>
<para>
Le groupement de cache ne devrait pas <20>tre confondu avec votre hi<68>rarchie

View File

@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1.3 Maintainer: didou Status: ready -->
<!-- EN-Revision: 1.4 Maintainer: didou Status: ready -->
<sect1 id="caching.multiple.caches">
<title>Caches multiples pour une seule page</title>
@@ -11,12 +11,13 @@
display('index.tpl') puisse avoir plusieurs r<>sultats, en fonction de
certaines conditions, et que vous vouliez des fichiers de cache s<>par<61>s
pour chacun d'eux. Vous pouvez faire cel<65> en passant un identifiant de
cache (cache_id) en deuxi<78>me param<61>tre a l'appel de fonction.
cache ($cache_id) en deuxi<78>me param<61>tre a l'appel de fonction.
</para>
<example>
<title>Passage d'un cache_id a display()</title>
<title>Passage d'un $cache_id <EFBFBD> display()</title>
<programlisting>
<![CDATA[
<?php
require('Smarty.class.php');
$smarty = new Smarty;
@@ -25,6 +26,7 @@ $smarty->caching = true;
$my_cache_id = $_GET['article_id'];
$smarty->display('index.tpl',$my_cache_id);
?>
]]>
</programlisting>
</example>
@@ -62,6 +64,7 @@ $smarty->display('index.tpl',$my_cache_id);
<title>Passer un cache_id a is_cached()</title>
<programlisting>
<![CDATA[
<?php
require('Smarty.class.php');
$smarty = new Smarty;
@@ -76,6 +79,7 @@ if(!$smarty->is_cached('index.tpl',$my_cache_id)) {
}
$smarty->display('index.tpl',$my_cache_id);
?>
]]>
</programlisting>
</example>
@@ -88,6 +92,7 @@ $smarty->display('index.tpl',$my_cache_id);
<title>Effacement de tous les fichiers de cache pour un identifiant de cache particulier</title>
<programlisting>
<![CDATA[
<?php
require('Smarty.class.php');
$smarty = new Smarty;
@@ -97,6 +102,7 @@ $smarty->caching = true;
$smarty->clear_cache(null,"sports");
$smarty->display('index.tpl',"sports");
?>
]]>
</programlisting>
</example>