mirror of
https://github.com/smarty-php/smarty.git
synced 2025-08-05 02:44:27 +02:00
add ommited files
This commit is contained in:
39
docs/fr/bookinfo.xml
Executable file
39
docs/fr/bookinfo.xml
Executable file
@@ -0,0 +1,39 @@
|
||||
<?xml version="1.0" encoding="iso-8859-1"?>
|
||||
<!-- $Revision$ -->
|
||||
<bookinfo id="bookinfo">
|
||||
<title>Smarty - the compiling PHP template engine</title>
|
||||
<authorgroup id="authors">
|
||||
<author>
|
||||
<firstname>Monte</firstname><surname>Ohrt <monte@ispi.net></surname>
|
||||
</author>
|
||||
<author>
|
||||
<firstname>Andrei</firstname><surname>Zmievski <andrei@php.net></surname>
|
||||
</author>
|
||||
</authorgroup>
|
||||
<pubdate>&build-date;</pubdate>
|
||||
<copyright>
|
||||
<year>2001-2004</year>
|
||||
<holder>ispi of Lincoln, Inc.</holder>
|
||||
</copyright>
|
||||
</bookinfo>
|
||||
|
||||
<!-- Keep this comment at the end of the file
|
||||
Local variables:
|
||||
mode: sgml
|
||||
sgml-omittag:t
|
||||
sgml-shorttag:t
|
||||
sgml-minimize-attributes:nil
|
||||
sgml-always-quote-attributes:t
|
||||
sgml-indent-step:1
|
||||
sgml-indent-data:t
|
||||
indent-tabs-mode:nil
|
||||
sgml-parent-document:nil
|
||||
sgml-default-dtd-file:"../../../../manual.ced"
|
||||
sgml-exposed-tags:nil
|
||||
sgml-local-catalogs:nil
|
||||
sgml-local-ecat-files:nil
|
||||
End:
|
||||
vim600: syn=xml fen fdm=syntax fdl=2 si
|
||||
vim: et tw=78 syn=sgml
|
||||
vi: ts=1 sw=1
|
||||
-->
|
427
docs/fr/getting-started.xml
Normal file
427
docs/fr/getting-started.xml
Normal file
@@ -0,0 +1,427 @@
|
||||
<part id="getting.started">
|
||||
<title>Pour commencer</title>
|
||||
|
||||
<chapter id="what.is.smarty">
|
||||
<title>Qu'est-ce que Smarty ?</title>
|
||||
<para>
|
||||
Smarty est un moteur de template pour PHP. Plus pr<70>cis<69>ment, il facilite
|
||||
la s<>paration entre la logique applicative et la pr<70>sentation.
|
||||
Cela s'explique plus facilement dans une situation o<> le
|
||||
programmeur et le designer de templates jouent des r<>les diff<66>rents, ou,
|
||||
comme la plupart du temps, sont deux personnes distinctes.
|
||||
Supposons par exemple que vous concevez une page Web qui affiche un
|
||||
article de newsletter. Le titre, le sous-titre, l'auteur et le corps
|
||||
sont des <20>l<EFBFBD>ments de contenu, ils ne contiennent aucune information
|
||||
concernant la pr<70>sentation. Ils sont transmis <20> Smarty par l'application,
|
||||
puis le designer de templates <20>ditent les templates et utilisent une
|
||||
combinaison de balises HTML et de balises de templates pour formater
|
||||
la pr<70>sentation de ces <20>l<EFBFBD>ments (tableaux HTML, couleurs d'arri<72>re-plan,
|
||||
tailles des polices, feuilles de styles, etc.). Un beau jour le programmeur
|
||||
a besoin de changer la fa<66>on dont le contenu de l'article
|
||||
est r<>cup<75>r<EFBFBD> (un changement dans la logique applicative). Ce
|
||||
changement n'affecte pas le designer de templates, le contenu
|
||||
arrivera toujours au template de la m<>me fa<66>on. De m<>me, si le
|
||||
le designer de templates veut changer compl<70>tement l'apparence
|
||||
du template, aucun changement dans la logique de l'application
|
||||
n'est n<>cessaire. Ainsi le programmeur peut changer la logique
|
||||
de l'application sans restructurer les templates, et le designer
|
||||
de templates peut changer les templates sans briser la logique
|
||||
applicative.
|
||||
</para>
|
||||
<para>
|
||||
Et maintenant un mot rapide sur ce que Smarty NE fait PAS. Smarty n'a
|
||||
pas pour pr<70>tention de supprimer compl<70>tement les traitements au sein des
|
||||
templates.
|
||||
Il est tout <20> fait envisageable de recontrer un traitement dans un template,
|
||||
<20> condition que ce dernier ne d<>sserve que des besoins de pr<70>sentation.
|
||||
Un conseil : laissez la logique applicative en dehors des templates et
|
||||
la logique de pr<70>sentation en dehors de l'application. A l'avenir, cela permet
|
||||
une meilleure gestion des <20>v<EFBFBD>nements.
|
||||
</para>
|
||||
<para>
|
||||
L'un des aspects unique de Smarty est la compilation des templates.
|
||||
Cela signifie que Smarty lit les templates et cr<63>e des scripts PHP <20> partir
|
||||
de ces derniers. Une fois cr<63><72>s, ils sont ex<65>cut<75>s.
|
||||
Il n'y a donc pas d'analyse co<63>teuse de template <20> chaque requ<71>te,
|
||||
et les templates peuvent b<>n<EFBFBD>ficier des solutions de cache PHP
|
||||
comme Zend Accelerator (http://www.zend.com) ou PHP Accelerator
|
||||
(http://www.php-accelerator.co.uk).
|
||||
</para>
|
||||
<para>
|
||||
Quelques caract<63>ristiques de Smarty :
|
||||
</para>
|
||||
<itemizedlist>
|
||||
<listitem><para>Il est tr<74>s rapide.</para></listitem>
|
||||
<listitem><para>Il est efficace, le parser PHP s'occupe
|
||||
du sale travail.</para></listitem>
|
||||
<listitem><para>Pas d'analyse de template co<63>teuse, une seule compilation.
|
||||
</para></listitem>
|
||||
<listitem><para>Il sait ne recompiler que les fichiers de templates
|
||||
qui ont <20>t<EFBFBD> modifi<66>s.</para></listitem>
|
||||
<listitem><para>Vous pouvez cr<63>er des <link linkend="language.custom.functions">
|
||||
fonctions utilisateurs</link> et des <link linkend="language.modifiers">
|
||||
modificateurs de variables</link> personnalis<69>s, le langage de
|
||||
template est donc extr<74>mement extensible.</para></listitem>
|
||||
<listitem><para>Syntaxe des templates configurable, vous
|
||||
pouvez utiliser {}, {{}}, <!--{}-->, etc comme d<>limiteurs.
|
||||
</para></listitem>
|
||||
<listitem><para>Les instructions if/elseif/else/endif
|
||||
sont pass<73>es au parser PHP, la syntaxe de l'expression {if...}
|
||||
peut <20>tre aussi simple ou aussi complexe que vous
|
||||
le d<>sirez.</para></listitem>
|
||||
<listitem><para>Imbrication illimit<69>e de sections,
|
||||
de 'if', etc. autoris<69>e.</para></listitem>
|
||||
<listitem><para>Il est possible d'inclure du code PHP
|
||||
directement dans vos templates, bien que cela ne soit pas obligatoire
|
||||
(ni conseill<6C>), vu que le moteur est extensible.</para></listitem>
|
||||
<listitem><para>Support de cache int<6E>gr<67>.</para></listitem>
|
||||
<listitem><para>Sources de templates arbitraires.</para></listitem>
|
||||
<listitem><para>Fonctions de gestion de cache personnalisables.</para></listitem>
|
||||
<listitem><para>Architecture de plugins</para></listitem>
|
||||
</itemizedlist>
|
||||
</chapter>
|
||||
|
||||
<chapter id="installation">
|
||||
<title>Installation</title>
|
||||
|
||||
<sect1 id="installation.requirements">
|
||||
<title>Ce dont vous avez besoin</title>
|
||||
<para>
|
||||
Smarty n<>cessite un serveur Web utilisant PHP 4.0.6 ou sup<75>rieur.
|
||||
</para>
|
||||
</sect1>
|
||||
|
||||
<sect1 id="installing.smarty.basic">
|
||||
<title>Installation de base</title>
|
||||
<para>
|
||||
Copiez les fichiers biblioth<74>ques de Smarty du r<>pertoire
|
||||
/libs/ de la distribution <20> un emplacement accessible <20> PHP.
|
||||
Ce sont des fichiers PHP que vous NE DEVEZ PAS
|
||||
modifier. Ils sont partag<61>s par toutes les applications et ne seront
|
||||
mis <20> jour que lorsque vous installerez une nouvelle version de
|
||||
Smarty.
|
||||
</para>
|
||||
<example>
|
||||
<title>fichiers de la biblioth<74>que SMARTY</title>
|
||||
<screen>
|
||||
Smarty.class.php
|
||||
Smarty_Compiler.class.php
|
||||
Config_File.class.php
|
||||
debug.tpl
|
||||
/plugins/*.php (tous !)</screen>
|
||||
</example>
|
||||
|
||||
<para>
|
||||
Smarty utilise une constante PHP appel<65>e <link
|
||||
linkend="constant.smarty.dir">SMARTY_DIR</link> qui
|
||||
repr<70>sente le chemin complet de la biblioth<74>que Smarty. En fait,
|
||||
si votre application trouve le fichier
|
||||
<emphasis>Smarty.class.php</emphasis>, vous n'aurez pas
|
||||
besoin de d<>finir la variable SMARTY_DIR, Smarty s'en chargera pour vous.
|
||||
En revanche, si <emphasis>Smarty.class.php</emphasis>
|
||||
n'est pas dans votre r<>pertoire d'inclusion ou que vous ne
|
||||
donnez pas un chemin absolu <20> votre application, vous
|
||||
devez d<>finir SMARTY_DIR explicitement. SMARTY_DIR
|
||||
<emphasis>doit</emphasis> avoir <20>tre termin<69> par un slash.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Voici comment cr<63>er une instance de Smarty dans vos scripts PHP :
|
||||
</para>
|
||||
|
||||
<example>
|
||||
<title>cr<EFBFBD>er une instance de Smarty</title>
|
||||
<screen>
|
||||
require('Smarty.class.php');
|
||||
$smarty = new Smarty;</screen>
|
||||
</example>
|
||||
|
||||
<para>
|
||||
Essayez de lancer le script ci-dessus. Si vous obtenez une erreur indiquant
|
||||
que le fichier <emphasis>Smarty.class.php</emphasis> n'est pas trouv<75>,
|
||||
tentez l'une des choses suivantes :
|
||||
</para>
|
||||
|
||||
<example>
|
||||
<title>fournir un chemin absolu vers la biblioth<74>que Smarty</title>
|
||||
<screen>
|
||||
require('/usr/local/lib/php/Smarty/Smarty.class.php');
|
||||
$smarty = new Smarty;</screen>
|
||||
</example>
|
||||
|
||||
<example>
|
||||
<title>Ajouter le r<>pertoire de la biblioth<74>que au chemin de php_include</title>
|
||||
<screen>
|
||||
// Editez le fichier php.ini, ajoutez le r<>pertoire de la
|
||||
// biblioth<74>que Smarty au include_path et red<65>marrez le serveur Web.
|
||||
// Cela devrait ensuite fonctionner :
|
||||
require('Smarty.class.php');
|
||||
$smarty = new Smarty;</screen>
|
||||
</example>
|
||||
|
||||
<example>
|
||||
<title>D<EFBFBD>finir explicitement la constante SMARTY_DIR</title>
|
||||
<screen>
|
||||
define('SMARTY_DIR','/usr/local/lib/php/Smarty/');
|
||||
require(SMARTY_DIR.'Smarty.class.php');
|
||||
$smarty = new Smarty;</screen>
|
||||
</example>
|
||||
|
||||
<para>
|
||||
Maintenant que les fichiers de la librairie sont en place,
|
||||
il est temps de d<>finir les r<>pertoires de Smarty, pour votre application.
|
||||
Smarty a besoin de quatre r<>pertoires qui sont (par d<>faut)
|
||||
<emphasis>templates</emphasis>,
|
||||
<emphasis>templates_c</emphasis>, <emphasis>configs</emphasis> et
|
||||
<emphasis>cache</emphasis>. Chacun d'entre eux peut <20>tre d<>fini
|
||||
via les attributs <emphasis>$template_dir</emphasis>,
|
||||
<emphasis>$compile_dir</emphasis>, <emphasis>$config_dir</emphasis> et
|
||||
<emphasis>$cache_dir</emphasis> respectivement. Il est vivement
|
||||
conseill<6C> que vous r<>gliez ces r<>pertoires s<>par<61>ment pour chaque
|
||||
application qui utilise Smarty.
|
||||
</para>
|
||||
<para>
|
||||
Assurez-vous de bien conna<6E>tre chemin de la racine
|
||||
de votre arborescence Web. Dans notre exemple, la racine
|
||||
est "/web/www.mydomain.com/docs". Seul Smarty
|
||||
acc<63>de aux r<>pertoires en question, et jamais le serveur Web.
|
||||
Pour des raisons de s<>curit<69>, il est donc conseill<6C> de
|
||||
sortir ces r<>pertoires dans un r<>pertoire
|
||||
<emphasis>en dehors</emphasis> de l'arborescence
|
||||
Web.
|
||||
</para>
|
||||
<para>
|
||||
Dans notre exemple d'installation, nous allons r<>gler l'environnement
|
||||
de Smarty pour une application de livre d'or. Nous avons ici choisi
|
||||
une application principalement pour mettre en <20>vidence une
|
||||
convention de nommage des r<>pertoires. Vous pouvez utiliser le m<>me
|
||||
environnement pour n'importe quelle autre application, il suffit de
|
||||
remplacer "livredor" avec le nom de votre application. Nous allons
|
||||
mettre nos r<>pertoires Smarty dans
|
||||
"/web/www.mydomain.com/smarty/livredor/".
|
||||
</para>
|
||||
<para>
|
||||
Vous allez avoir besoin d'au moins un fichier <20> la racine de
|
||||
l'arborescence Web,
|
||||
il s'agit du script auquel l'internaute a acc<63>s. Nous allons l'appeler
|
||||
"index.php" et le placer dans un sous-r<>pertoire
|
||||
appel<65> "/livredor/". Il est pratique de configurer le serveur Web de
|
||||
sorte que "index.php" soit identifi<66> comme fichier
|
||||
par d<>faut de ce r<>pertoire. Aicnsi, si l'on tape
|
||||
"http://www.mydomain.com/livredor/", le script index.php soit
|
||||
ex<65>cut<75> sans que "index.php" ne soit sp<73>cifi<66> dans l'URL. Avec Apache
|
||||
vous pouvez r<>gler cela en ajoutant "index.php" <20> la ligne o<> se
|
||||
trouve DirectoryIndex (s<>parez chaque entr<74>e par un espace).
|
||||
</para>
|
||||
<para>
|
||||
Jetons un coup d'oeil <20> la structure de fichier obtenue :
|
||||
</para>
|
||||
|
||||
<example>
|
||||
<title>exemple de structure de fichiers</title>
|
||||
<screen>
|
||||
/usr/local/lib/php/Smarty/Smarty.class.php
|
||||
/usr/local/lib/php/Smarty/Smarty_Compiler.class.php
|
||||
/usr/local/lib/php/Smarty/Config_File.class.php
|
||||
/usr/local/lib/php/Smarty/debug.tpl
|
||||
/usr/local/lib/php/Smarty/plugins/*.php
|
||||
|
||||
/web/www.mydomain.com/smarty/livredor/templates/
|
||||
/web/www.mydomain.com/smarty/livredor/templates_c/
|
||||
/web/www.mydomain.com/smarty/livredor/configs/
|
||||
/web/www.mydomain.com/smarty/livredor/cache/
|
||||
|
||||
/web/www.mydomain.com/docs/livredor/index.php</screen>
|
||||
</example>
|
||||
|
||||
<para>
|
||||
Smarty a besoin d'acc<63>der en <20>criture aux r<>pertoires
|
||||
<emphasis>$compile_dir</emphasis> et <emphasis>$cache_dir</emphasis>,
|
||||
assurez-vous donc que le serveur Web dispose de ces droits d'acc<63>s.
|
||||
Il s'agit g<>n<EFBFBD>ralement de l'utilisateur "nobody" et du group
|
||||
"nobody". Pour les utilisateurs de OS X, l'utilisateur par d<>faut
|
||||
est "web" et le group "web". Si vous utilisez Apache, vous pouvez
|
||||
parcourir le fichier httpd.conf (en g<>n<EFBFBD>ral dans
|
||||
"/usr/local/apache/conf/") pour d<>terminer quel est l'utilisateur
|
||||
et le groupe auquel il appartient.
|
||||
</para>
|
||||
|
||||
|
||||
<example>
|
||||
<title>r<EFBFBD>gler les permissions d'acc<63>s</title>
|
||||
<screen>
|
||||
|
||||
chown nobody:nobody /web/www.mydomain.com/smarty/templates_c/
|
||||
chmod 770 /web/www.mydomain.com/smarty/templates_c/
|
||||
|
||||
chown nobody:nobody /web/www.mydomain.com/smarty/cache/
|
||||
chmod 770 /web/www.mydomain.com/smarty/cache/</screen>
|
||||
</example>
|
||||
|
||||
<note>
|
||||
<title>Note technique</title>
|
||||
<para>
|
||||
La commande chmod 770 est relativement bien s<>curis<69>e, elle donne
|
||||
<20> l'utilisateur "nobody" et au groupe "nobody" les acc<63>s en
|
||||
lecture/<2F>criture aux r<>pertoires. Si vous voulez donner le droit d'acc<63>s
|
||||
en lecture <20> tout le monde (principalement pour pouvoir acc<63>der
|
||||
vous-m<>me <20> ces fichiers), vous pouvez lui pr<70>f<EFBFBD>rer chmod 775.
|
||||
</para>
|
||||
</note>
|
||||
|
||||
<para>
|
||||
Nous devons cr<63>er le fichier index.tpl que Smarty va charger.
|
||||
Il va se trouver dans $template_dir.
|
||||
</para>
|
||||
|
||||
<example>
|
||||
<title>Edition de /web/www.mydomain.com/smarty/templates/index.tpl</title>
|
||||
<screen>
|
||||
|
||||
{* Smarty *}
|
||||
|
||||
Hello, {$name}!</screen>
|
||||
</example>
|
||||
|
||||
|
||||
<note>
|
||||
<title>Note technique</title>
|
||||
<para>
|
||||
{* Smarty *} est un commentaire de template. Il n'est pas
|
||||
obligatoire mais il est bon de commencer tous vos templates
|
||||
avec ce commentaire. Cela rend le fichier facilement
|
||||
reconnaissable en plus de son extension. Les <20>diteurs
|
||||
de texte peuvent par exemple reconna<6E>tre le fichier et
|
||||
adapter la coloration syntaxique.
|
||||
</para>
|
||||
</note>
|
||||
|
||||
<para>
|
||||
Maintenant passons <20> l'<27>dition du fichier index.php. Nous allons
|
||||
cr<63>er une instance de Smarty, assigner une valeur <20> une variable
|
||||
de template et afficher le r<>sultat avec index.tpl. Dans notre
|
||||
exemple d'environnement, "/usr/local/lib/php/Smarty" est dans notre
|
||||
include_path. Assurez-vous de faire la m<>me chose ou d'utiliser
|
||||
des chemins absolus.
|
||||
</para>
|
||||
|
||||
<example>
|
||||
<title><EFBFBD>dition de /web/www.mydomain.com/docs/livredor/index.php</title>
|
||||
<screen>
|
||||
// charge la biblioth<74>que Smarty
|
||||
require('Smarty.class.php');
|
||||
|
||||
$smarty = new Smarty;
|
||||
|
||||
$smarty->template_dir = '/web/www.mydomain.com/smarty/livredor/templates/';
|
||||
$smarty->compile_dir = '/web/www.mydomain.com/smarty/livredor/templates_c/';
|
||||
$smarty->config_dir = '/web/www.mydomain.com/smarty/livredor/configs/';
|
||||
$smarty->cache_dir = '/web/www.mydomain.com/smarty/livredor/cache/';
|
||||
|
||||
$smarty->assign('name','Ned');
|
||||
|
||||
$smarty->display('index.tpl');</screen>
|
||||
</example>
|
||||
|
||||
<note>
|
||||
<title>Note techique</title>
|
||||
<para>
|
||||
Dans notre exemple, nous avons configur<75> les chemins absolus
|
||||
pour chacun des r<>pertoires Smarty. Si
|
||||
'/web/www.mydomain.com/smarty/livredor/' est dans votre
|
||||
include_path PHP alors ces r<>glages ne sont pas n<>cessaires.
|
||||
Quoi qu'il en soit il est plus efficace et (par exp<78>rience)
|
||||
moins g<>n<EFBFBD>rateur d'erreurs de les d<>finir avec des chemins
|
||||
absolus. Cela nous garantit que Smarty r<>cup<75>rera les bons fichiers.
|
||||
</para>
|
||||
</note>
|
||||
|
||||
<para>
|
||||
Et maintenant appelez le fichier index.php avec navigateur
|
||||
Web. Vous devriez voir "Hello, Ned!".
|
||||
</para>
|
||||
<para>
|
||||
Vous venez de terminer l'installation de base de Smarty !
|
||||
</para>
|
||||
</sect1>
|
||||
<sect1 id="installing.smarty.extended">
|
||||
<title>Configuration avanc<6E>e</title>
|
||||
|
||||
<para>
|
||||
Ceci est la suite de <link
|
||||
linkend="installing.smarty.basic">l'installation de base</link>, veuillez
|
||||
lire cette derni<6E>re avant de poursuivre.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Une mani<6E>re un peu plus commode de configurer Smarty est de faire votre
|
||||
propre classe fille et de l'initialiser selon votre environnement.
|
||||
De la sorte, nous n'aurons plus besoin de configurer <20> chaques fois les
|
||||
chemins de notre environnement. Cr<43>ons un nouveau r<>pertoire
|
||||
"/php/includes/livredor/" et un nouveau fichier appel<65> "setup.php".
|
||||
Dans notre exemple d'environnement, "/php/includes" est notre
|
||||
include_path PHP. Assurez-vous de faire la m<>me chose ou alors d'utiliser
|
||||
des chemins absolus.
|
||||
</para>
|
||||
|
||||
<example>
|
||||
<title><EFBFBD>dition de /php/includes/livredor/setup.php</title>
|
||||
<screen>
|
||||
|
||||
// charge la librairie Smarty
|
||||
require('Smarty.class.php');
|
||||
|
||||
// le fichier setup.php est un bon
|
||||
// endroit pour charger les fichiers
|
||||
// de librairies de l'application et vous pouvez
|
||||
// faire cela juste ici. Par exemple :
|
||||
// require('livredor/livredor.lib.php');
|
||||
|
||||
class Smarty_livredor extends Smarty {
|
||||
|
||||
function Smarty_livredor() {
|
||||
|
||||
// Constructeur de la classe. Appel<65> automatiquement
|
||||
// <20> l'instanciation de la classe.
|
||||
|
||||
$this->Smarty();
|
||||
|
||||
$this->template_dir = '/web/www.mydomain.com/smarty/livredor/templates/';
|
||||
$this->compile_dir = '/web/www.mydomain.com/smarty/livredor/templates_c/';
|
||||
$this->config_dir = '/web/www.mydomain.com/smarty/livredor/configs/';
|
||||
$this->cache_dir = '/web/www.mydomain.com/smarty/livredor/cache/';
|
||||
|
||||
$this->caching = true;
|
||||
$this->assign('app_name','Guest Book');
|
||||
}
|
||||
|
||||
}</screen>
|
||||
</example>
|
||||
|
||||
<para>
|
||||
Modifions maintenant le fichier index.php pour qu'il utilise "setup.php"
|
||||
</para>
|
||||
|
||||
<example>
|
||||
<title><EFBFBD>dition de /web/www.mydomain.com/docs/livredor/index.php</title>
|
||||
<screen>
|
||||
|
||||
require('livredor/setup.php');
|
||||
|
||||
$smarty = new Smarty_livredor;
|
||||
|
||||
$smarty->assign('name','Ned');
|
||||
|
||||
$smarty->display('index.tpl');</screen>
|
||||
</example>
|
||||
|
||||
<para>
|
||||
Vous savez maintenant qu'il est facile de cr<63>er une instance de Smarty,
|
||||
correctement configur<75>e, en utilisant Smarty_livredor qui initialise
|
||||
automatiquement tout ce qu'il faut pour votre application.
|
||||
</para>
|
||||
|
||||
</sect1>
|
||||
|
||||
</chapter>
|
||||
</part>
|
45
docs/fr/manual.xml
Normal file
45
docs/fr/manual.xml
Normal file
@@ -0,0 +1,45 @@
|
||||
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
|
||||
<!ENTITY preface SYSTEM "preface.sgml">
|
||||
<!ENTITY getting.started SYSTEM "getting-started.sgml">
|
||||
<!ENTITY smarty.for.designers SYSTEM "designers.sgml">
|
||||
<!ENTITY smarty.for.programmers SYSTEM "programmers.sgml">
|
||||
<!ENTITY appendixes SYSTEM "appendixes.sgml">
|
||||
]>
|
||||
|
||||
<book id="index" lang="fr">
|
||||
<bookinfo id="bookinfo">
|
||||
<title>Smarty - le moteur et compilateur de template PHP</title>
|
||||
<authorgroup id="authors">
|
||||
<author>
|
||||
<firstname>Monte</firstname><surname>Ohrt <monte@ispi.net></surname>
|
||||
</author>
|
||||
<author>
|
||||
<firstname>Andrei</firstname><surname>Zmievski <andrei@php.net></surname>
|
||||
</author>
|
||||
</authorgroup>
|
||||
|
||||
<authorgroup id="translators">
|
||||
<author>
|
||||
<firstname>Arnaud</firstname><surname>Cogolu<EFBFBD>gnes <arnaud.cogoluegnes@free.fr></surname>
|
||||
</author>
|
||||
<author>
|
||||
<firstname>G<EFBFBD>rald</firstname><surname>Cro<EFBFBD>s <gcroes@aston.fr></surname>
|
||||
</author>
|
||||
</authorgroup>
|
||||
|
||||
<edition>Version 2.0</edition>
|
||||
<copyright>
|
||||
<year>2001</year>
|
||||
<year>2002</year>
|
||||
<year>2003</year>
|
||||
<holder>ispi of Lincoln, Inc.</holder>
|
||||
</copyright>
|
||||
</bookinfo>
|
||||
|
||||
&preface;
|
||||
&getting.started;
|
||||
&smarty.for.designers;
|
||||
&smarty.for.programmers;
|
||||
&appendixes;
|
||||
|
||||
</book>
|
77
docs/fr/preface.xml
Normal file
77
docs/fr/preface.xml
Normal file
@@ -0,0 +1,77 @@
|
||||
<preface id="preface">
|
||||
<title>Pr<EFBFBD>face</title>
|
||||
<para>
|
||||
"Comment rendre mes scripts PHP ind<6E>pendants de la pr<70>sentation ?".
|
||||
Voici sans doute la question la plus pos<6F>e sur la mailing list
|
||||
PHP. Alors que PHP est <20>tiquet<65> "langage de script
|
||||
pour HTML", on se rend vite compte, apr<70>s quelques projets qui m<>langent
|
||||
sans complexe HTML et PHP, que la s<>paration entre la forme et
|
||||
le contenu est important. De plus, dans de nombreuses entreprises
|
||||
les r<>les du designer et du programmeur sont distincts. La solution template
|
||||
coule donc de source.
|
||||
</para>
|
||||
<para>
|
||||
Dans notre entreprise par exemple, le d<>veloppement d'une application
|
||||
se fait de la mani<6E>re suivante : une fois le cahier des charges <20>crit,
|
||||
le designer r<>alise une maquette, et donne ses interfaces
|
||||
au programmeur. Le programmeur impl<70>mente les fonctionnalit<69>s applicatives
|
||||
et utilise les maquettes pour faire des squelettes de templates. Le projet
|
||||
est alors pass<73> au designer HTML/responsable de la mise en page qui am<61>ne les
|
||||
templates jusqu'au fa<66>te de leur gloire. Il est possible que le projet fasse
|
||||
une fois ou deux des allers/retours entre la programmation et la pr<70>sentation.
|
||||
En cons<6E>quence, il est important de disposer d'un bon syst<73>me de template. Les
|
||||
programmeurs ne veulent pas avoir <20> faire au HTML, et ne veulent pas non plus
|
||||
que les designers HTML bidouillent le code PHP. Les designers ont besoin d'outils
|
||||
comme des fichiers de configuration, des blocs dynamiques et d'autres solutions
|
||||
pour r<>pondre <20> des probl<62>matiques d'interface, mais ne veulent pas
|
||||
n<>cessairement avoir <20> faire <20> toutes les subtilit<69>s de la programmation PHP.
|
||||
</para>
|
||||
<para>
|
||||
Un rapide tour d'horizon des solutions type template aujourd'hui et
|
||||
l'on s'aper<65>oit que la plupart d'entre elles n'offrent que des moyens
|
||||
rudimentaires pour substituer des variables dans des templates, ainsi que des
|
||||
fonctionnalit<69>s limit<69>es de blocs dynamiques. Cependant nous avons
|
||||
besoin d'un peu plus. Nous ne voulons pas que les programmeurs
|
||||
s'occupent de la pr<70>sentation HTML du TOUT, mais cela est pratiquement
|
||||
in<69>vitable. Par exemple, si un designer veut des couleurs d'arri<72>re plan
|
||||
diff<66>rentes pour alterner entre diff<66>rents blocs dynamiques, il est n<>cessaire
|
||||
que ce dernier travaille avec le programmeur. Nous avons aussi besoin que les
|
||||
designers soient capables de travailler avec leurs propres fichiers
|
||||
de configuration pour y r<>cup<75>rer des variables, exploitables dans leurs
|
||||
templates. Et la liste est longue.
|
||||
</para>
|
||||
<para>
|
||||
Fin 1999, nous avons commenc<6E> <20> <20>crire une sp<73>cification pour un moteur de
|
||||
template. Une fois la sp<73>cification termin<69>e,
|
||||
nous avons commenc<6E> <20> travailler sur un moteur de template <20>crit
|
||||
en C qui pourrait, avec un peu de chance, <20>tre inclus <20> PHP.
|
||||
Non seulement nous avons rencontr<74> des probl<62>mes techniques complexes,
|
||||
mais nous avons particip<69>s <20> de nombreux d<>bats sur ce que devait
|
||||
et ce que ne devait pas faire un moteur de template. De cette exp<78>rience nous avons
|
||||
d<>cid<69> qu'un moteur de template se devait d'<27>tre <20>crit sous la forme d'une
|
||||
classe PHP, afin que quiconque puisse l'utiliser <20> sa convenance. Nous
|
||||
avons donc r<>alis<69> un moteur de template qui se contentait de faire cela,
|
||||
et <productname>SmartTemplate</productname> a vu le jour (note : cette
|
||||
classe n'a jamais <20>t<EFBFBD> soumise au public). C'<27>tait une classe qui
|
||||
faisait pratiquement tout ce que nous voulions : substitution de variables,
|
||||
inclusion d'autres templates, int<6E>gration avec des fichiers de configuration,
|
||||
int<6E>gration de code PHP, instruction 'if' basique et une gestion plus robuste
|
||||
des blocks dynamiques imbriqu<71>s. Elle faisait tout cela avec des expressions
|
||||
rationnelles et le code se r<>v<EFBFBD>la, comment dire, imp<6D>n<EFBFBD>trable. De plus, elle <20>tait
|
||||
relativement lente pour les grosses applications <20> cause de l'analyse
|
||||
et du travail sur les expressions rationnelles qu'elle devait faire <20> chaque
|
||||
ex<65>cution. Le plus gros probl<62>me du point de vue du programmeur <20>tait
|
||||
tout le travail n<>cessaire en amont, dans le script PHP, pour configurer
|
||||
et ex<65>cuter les templates, et les blocs dynamiques. Comment rendre tout ceci
|
||||
plus simple ?
|
||||
</para>
|
||||
<para>
|
||||
Puis vint la vision de ce que devait devenir Smarty. Nous
|
||||
savons combien le code PHP peut <20>tre rapide sans le co<63>t
|
||||
d'analyse des templates. Nous savons aussi combien fastidieux
|
||||
et d<>courageant peut para<72>tre le langage pour le designer moyen, et que
|
||||
cela peut <20>tre remplac<61> par une syntaxe sp<73>cifique, beaucoup
|
||||
plus simple. Et si nous combinions les deux forces ? Ainsi, Smarty
|
||||
<20>tait n<>...
|
||||
</para>
|
||||
</preface>
|
Reference in New Issue
Block a user