From 0d9b69e03beb8a56e9c2d4b88368bdb04dfafa1e Mon Sep 17 00:00:00 2001 From: yannick Date: Tue, 24 May 2005 20:07:09 +0000 Subject: [PATCH] sync with EN --- docs/fr/appendixes/tips.xml | 18 ++- docs/fr/appendixes/troubleshooting.xml | 13 +- .../designers/chapter-debugging-console.xml | 36 +++-- docs/fr/designers/config-files.xml | 17 ++- .../language-combining-modifiers.xml | 4 +- docs/fr/designers/language-modifiers.xml | 12 +- docs/fr/getting-started.xml | 139 ++++++++++-------- docs/fr/language-snippets.ent | 19 +-- 8 files changed, 154 insertions(+), 104 deletions(-) diff --git a/docs/fr/appendixes/tips.xml b/docs/fr/appendixes/tips.xml index 53471a2c..3c59fc3b 100644 --- a/docs/fr/appendixes/tips.xml +++ b/docs/fr/appendixes/tips.xml @@ -1,6 +1,6 @@ - + Trucs et astuces @@ -48,7 +48,7 @@ Si une variable est utilisée fréquemment dans vos templates, lui appliquer le modificateur par défaut peut être un peu fastidieux. Vous pouvez remédier à celà en lui assignant une valeur par défaut - avec la fonction assign. + avec la fonction {assign}. assigner une valeur par défaut à une variable de template @@ -119,7 +119,8 @@ footer.tpl le titre sera "Archives". Notez que dans l'exemple des archives, on utilise le fichier archives_page.conf plutôt que des variables codées en dur. Remarquez aussi que "BC News" est affichée si la variable $title - n'est pas définie, grâce au modificateur de variable default. + n'est pas définie, grâce au modificateur de variable + default. @@ -202,13 +203,22 @@ function makeTimeStamp($year="", $month="", $day="") if(empty($day)) { $day = strftime("%d"); } - + return mktime(0, 0, 0, $month, $day, $year); } ?> ]]> + + + Voir aussi + {html_select_date}, + {html_select_time}, + date_format + et $smarty.now, + + WAP/WML diff --git a/docs/fr/appendixes/troubleshooting.xml b/docs/fr/appendixes/troubleshooting.xml index fa7bb17d..3b1ac6fc 100644 --- a/docs/fr/appendixes/troubleshooting.xml +++ b/docs/fr/appendixes/troubleshooting.xml @@ -1,6 +1,6 @@ - + Diagnostic des erreurs @@ -44,16 +44,23 @@ Parse error: parse error in /path/to/smarty/templates_c/index.tpl.php on line 75 ]]> - + Quand vous rencontrez une erreur d'analyse PHP, le numéro de la ligne indiqué est celui du fichier PHP compilé et non du template. Vous pouvez alors regarder le template et détecter l'erreur. Voici quelques erreurs fréquentes : - balises fermantes pour {if}{/if} ou {section}{/section} manquantes, ou + balises fermantes pour {if}{/if} + ou {section}{/section} manquantes, ou syntaxe logique incorrecte dans une instruction {if}. Si vous ne trouvez pas l'erreur, vous devrez alors ouvrir le fichier PHP compilé et aller à la ligne correspondante pour trouver d'où vient l'erreur. + + Voir aussi + le débogage, + $error_reporting + et trigger_error(). + - + Console de débogage Il existe une console de débogage dans Smarty. La console vous indique - toutes les variables incluses, assignées et chargées depuis un fichier de - configuration pour le template courant. Un template appelé "debug.tpl" - est inclus dans la distribution de Smarty. Si besoin, vous pouvez définir - $debug_tpl de façon à ce que ce dernier contienne le chemin - du template à utiliser(dans SMARTY_DIR par defaut). + toutes les templates incluses, + les variables assignées et chargées depuis un fichier de + configuration pour le template courant. + Un template appelé "debug.tpl" est inclus dans la distribution de Smarty qui contrôle + le formattage de la console.Définissez $debugging + à true dans Smarty et, si besoin, vous pouvez définir + $debug_tpl de façon à ce que ce dernier + contienne le chemin du template à utiliser(dans + SMARTY_DIR par defaut). Lorsque vous chargez la page, une console javascript est censée surgir et vous donner les noms de toutes les variables inclues et assignées dans votre page courante. Pour voir toutes les variables d'un template particulier, voir la fonction {debug}. - Pour désactiver la console de débogage, définissez $debugging à false. + Pour désactiver la console de débogage, définissez + $debugging à false. Vous pouvez également temporairement activer le débogage en indiquant SMARTY_DEBUG dans l'url si tant est que l'option $debugging_ctrl soit activée. @@ -22,10 +27,11 @@ Note technique - La console de débogage ne fonctionne pas si vous utilisez l'API fetch (), - mais seulement lorsque vous utilisez display (). C'est en effet un jeu - d'instructions javascripts à la fin du template qui déclenchent l'ouverture - de la fenêtre. Si vous n'aimez pas javascript, vous pouvez modifier + La console de débogage ne fonctionne pas si vous utilisez l'API + fetch(), + mais seulement lorsque vous utilisez display(). + C'est en effet un jeu d'instructions javascripts à la fin du template qui déclenchent + l'ouverture de la fenêtre. Si vous n'aimez pas javascript, vous pouvez modifier debug.tpl pour formater les données de la façon qui vous conviendra le mieux. Les données de débogage ne sont pas mises en cache et les informations de debug.tpl ne sont pas incluses dans la sortie de la @@ -38,6 +44,12 @@ indiqués en secondes. + + Voir aussi + troubleshooting, + $error_reporting + et trigger_error(). + + --> \ No newline at end of file diff --git a/docs/fr/designers/config-files.xml b/docs/fr/designers/config-files.xml index 15cc4fc7..43469546 100644 --- a/docs/fr/designers/config-files.xml +++ b/docs/fr/designers/config-files.xml @@ -1,6 +1,6 @@ - + Fichiers de configuration @@ -42,8 +42,8 @@ pass=foobar - Les valeurs des variables de fichiers de configuration peuvent être entre - guillemets, sans que celà soit nécessaire. Si vous vouler utiliser des + Les valeurs des variables de fichiers de configuration + peuvent être entre guillemets, sans que celà soit nécessaire. Si vous vouler utiliser des valeurs sur plusieurs lignes, vous devrez les entourer de triples guillemets ("""). Vous pouvez insérer des commentaires dans les fichiers de configuration en utilisant une syntaxe quelquonque, non valide. @@ -62,11 +62,14 @@ pass=foobar à la fois en tant que globale et à la fois en tant que variable de section, la variable de section est prioritaire. Si vous appelez deux variables dans une même section de la même façon, - la dernière déclarée prime. + la dernière déclarée prime. (voir + $config_overwrite) - Les fichiers de configuration sont chargés dans le template grâce à la - fonction config_load. + Les fichiers de configuration sont chargés dans le template grâce aux + fonctions {config_load}, + et config_load(). Vous pouvez masquer des variables ou des sections entières en préfixant @@ -97,4 +100,4 @@ End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file diff --git a/docs/fr/designers/language-combining-modifiers.xml b/docs/fr/designers/language-combining-modifiers.xml index 9225c5ae..cedd558a 100644 --- a/docs/fr/designers/language-combining-modifiers.xml +++ b/docs/fr/designers/language-combining-modifiers.xml @@ -1,6 +1,6 @@ - + Combiner des modificateurs de variable. @@ -68,4 +68,4 @@ End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> +--> \ No newline at end of file diff --git a/docs/fr/designers/language-modifiers.xml b/docs/fr/designers/language-modifiers.xml index e67427f3..9c1f355e 100644 --- a/docs/fr/designers/language-modifiers.xml +++ b/docs/fr/designers/language-modifiers.xml @@ -1,6 +1,6 @@ - + Modificateurs de variables @@ -65,6 +65,13 @@ comme connues dans le tableau $security_settings['MODIFIER_FUNCS']. + + Voir aussi + register_modifier(), + register_function(), + étendre Smarty avec des plugins + et les modifieurs. + &designers.language-modifiers.language-modifier-cat; &designers.language-modifiers.language-modifier-capitalize; @@ -89,6 +96,7 @@ &designers.language-modifiers.language-modifier-wordwrap; + +--> \ No newline at end of file diff --git a/docs/fr/getting-started.xml b/docs/fr/getting-started.xml index 4b71b323..f399d519 100644 --- a/docs/fr/getting-started.xml +++ b/docs/fr/getting-started.xml @@ -1,9 +1,9 @@ - + Pour commencer - + Qu'est-ce que Smarty ? @@ -92,12 +92,14 @@ Syntaxe des templates configurable, vous - pouvez utiliser {}, {{}}, <!--{}-->, etc. comme délimiteurs. + pouvez utiliser {}, {{}}, <!--{}-->, etc. comme + délimiteurs tag. - Les instructions if/elseif/else/endif + Les instructions if/elseif/else/endif sont passées au parser PHP, la syntaxe de l'expression {if...} peut être aussi simple ou aussi complexe que vous le désirez. @@ -105,29 +107,31 @@ - Imbrication illimitée de sections, de 'if', etc. autorisée. + Imbrication illimitée de sections, de 'if', etc. autorisée. - Il est possible d'inclure du code PHP + Il est possible d'inclure du code PHP directement dans vos templates, bien que celà ne soit pas obligatoire (ni conseillé), vû que le moteur est extensible. - Support de cache intégré. + Support de cache intégré. - Sources de templates arbitraires. + Sources de templates arbitraires. - Fonctions de gestion de cache personnalisables. + Fonctions de gestion de cache personnalisables. @@ -137,17 +141,17 @@ - + Installation - + Ce dont vous avez besoin Smarty nécessite un serveur Web utilisant PHP 4.0.6 ou supérieur. - + Installation de base @@ -169,9 +173,9 @@ debug.tpl /internals/*.php (tous) /plugins/*.php (tous) ]]> - + - + Smarty utilise une constante PHP appelée SMARTY_DIR qui @@ -185,11 +189,11 @@ debug.tpl devez définir SMARTY_DIR explicitement. SMARTY_DIR doit avoir être terminé par un slash. - + Voici comment créer une instance de Smarty dans vos scripts PHP : - + créer une instance de Smarty @@ -201,13 +205,13 @@ $smarty = new Smarty; ]]> - + Essayez de lancer le script ci-dessus. Si vous obtenez une erreur indiquant que le fichier Smarty.class.php n'est pas trouvé, tentez l'une des actions suivantes : - + fournir un chemin absolu vers la bibliothèque Smarty @@ -219,7 +223,7 @@ $smarty = new Smarty; ]]> - + Ajouter le répertoire de la bibliothèque dans l'include_path de PHP @@ -234,7 +238,7 @@ $smarty = new Smarty; ]]> - + Définir explicitement la constante SMARTY_DIR @@ -247,7 +251,7 @@ $smarty = new Smarty; ]]> - + Maintenant que les fichiers de la librairie sont en place, il est temps de définir les répertoires de Smarty, pour votre application. @@ -256,9 +260,13 @@ $smarty = new Smarty; templates_c, configs et cache. Chacun d'entre eux peut être défini - via les attributs $template_dir, - $compile_dir, $config_dir et - $cache_dir respectivement. Il est vivement + via les attributs + $template_dir, + + $compile_dir, + $config_dir et + + $cache_dir respectivement. Il est vivement conseillé que vous régliez ces répertoires séparément pour chaque application qui utilise Smarty. @@ -307,7 +315,7 @@ $smarty = new Smarty; Jetons un coup d'oeil à la structure de fichier obtenue : - + exemple de structure de fichiers @@ -328,10 +336,12 @@ $smarty = new Smarty; ]]> - + Smarty a besoin d'accéder en écriture aux répertoires - $compile_dir et $cache_dir, + + $compile_dir et + $cache_dir, assurez-vous donc que le serveur Web dispose de ces droits d'accès. Il s'agit généralement de l'utilisateur "nobody" et du group "nobody". Pour les utilisateurs de OS X, l'utilisateur par défaut @@ -340,7 +350,7 @@ $smarty = new Smarty; "/usr/local/apache/conf/") pour déterminer quel est l'utilisateur et le groupe auquel il appartient. - + régler les permissions d'accès @@ -353,7 +363,7 @@ chmod 770 /web/www.example.com/smarty/livredor/cache/ ]]> - + Note technique @@ -364,12 +374,12 @@ chmod 770 /web/www.example.com/smarty/livredor/cache/ vous-même à ces fichiers), vous pouvez lui préférer chmod 775. - + Nous devons créer le fichier index.tpl que Smarty va charger. Il va se trouver dans $template_dir. - + Edition de /web/www.example.com/smarty/templates/index.tpl @@ -381,8 +391,8 @@ Hello, {$name}! ]]> - - + + Note technique @@ -394,7 +404,7 @@ Hello, {$name}! adapter la coloration syntaxique. - + Maintenant passons à l'édition du fichier index.php. Nous allons créer une instance de Smarty, assigner une valeur à une variable @@ -403,30 +413,30 @@ Hello, {$name}! include_path. Assurez-vous de faire la même chose ou d'utiliser des chemins absolus. - + édition de /web/www.example.com/docs/livredor/index.php template_dir = '/web/www.example.com/smarty/livredor/templates/'; $smarty->compile_dir = '/web/www.example.com/smarty/livredor/templates_c/'; $smarty->config_dir = '/web/www.example.com/smarty/livredor/configs/'; $smarty->cache_dir = '/web/www.example.com/smarty/livredor/cache/'; - + $smarty->assign('name','Ned'); - + $smarty->display('index.tpl'); ?> ]]> - + Note techique @@ -440,7 +450,7 @@ Hello, {$name}! absolus. Celà nous garantit que Smarty récupèrera les bons fichiers. - + Et maintenant appelez le fichier index.php avec navigateur Web. Vous devriez voir "Hello, Ned!". @@ -451,13 +461,13 @@ Hello, {$name}! Configuration avancée - + Ceci est la suite de l'installation de base, veuillez lire cette dernière avant de poursuivre. - + Une manière un peu plus commode de configurer Smarty est de faire votre propre classe fille et de l'initialiser selon votre environnement. @@ -468,7 +478,7 @@ Hello, {$name}! include_path PHP. Assurez-vous de faire la même chose ou alors d'utiliser des chemins absolus. - + édition de /php/includes/livredor/setup.php @@ -476,67 +486,67 @@ Hello, {$name}! Smarty(); - + $this->template_dir = '/web/www.example.com/smarty/livredor/templates/'; $this->compile_dir = '/web/www.example.com/smarty/livredor/templates_c/'; $this->config_dir = '/web/www.example.com/smarty/livredor/configs/'; $this->cache_dir = '/web/www.example.com/smarty/livredor/cache/'; - + $this->caching = true; $this->assign('app_name', 'Guest Book'); } - + } ?> ]]> - + Modifions maintenant le fichier index.php pour qu'il utilise "setup.php" - + Edition de /web/www.example.com/docs/livredor/index.php assign('name','Ned'); - + $smarty->display('index.tpl'); - + ?> ]]> - + Vous savez maintenant qu'il est facile de créer une instance de Smarty, correctement configurée, en utilisant Smarty_livredor qui initialise automatiquement tout ce qu'il faut pour votre application. - + - + @@ -559,5 +569,4 @@ End: vim600: syn=xml fen fdm=syntax fdl=2 si vim: et tw=78 syn=sgml vi: ts=1 sw=1 ---> - +--> \ No newline at end of file diff --git a/docs/fr/language-snippets.ent b/docs/fr/language-snippets.ent index 1e214b6a..fbd39742 100644 --- a/docs/fr/language-snippets.ent +++ b/docs/fr/language-snippets.ent @@ -1,6 +1,6 @@ - + Note technique @@ -8,8 +8,8 @@ Le paramètre merge respecte les clés du tableau, donc, si vous fusionnez deux tableaux indexés numériquement, ils peuvent se recouvrir les uns les autres ou aboutir à des clés non séquentielles. Ceci - est diférent de la fonction PHP array_merge() qui élimine des clés numériques - et les renumérote. + est diférent de la fonction PHP array_merge() + qui élimine des clés numériques et les renumérote. '> @@ -19,10 +19,11 @@ C'est au cas où vous voudriez compiler plusieurs versions du même template, par exemple, pour avoir des templates compilés pour différents langages. Une autre utilité pour l'identifiant de compilation - compile_id est lorsque vous utilisez plus d'un $template_dir mais - seulement un $compile_dir. Définissez un compile_id - séparé pour chaque $template_dir, sinon, les templates du même nom - s'effaceront. Vous pouvez également définir la variable - $compile_id une seule fois - plutôt que de la passer à chaque appel à la fonction. + compile_id est lorsque vous utilisez plus d'un + $template_dir mais + seulement un $compile_dir. + Définissez un $compile_id + séparé pour chaque $template_dir, + sinon, les templates du même nom s'effaceront. Vous pouvez également + définir la variable $compile_id une seule fois plutôt que de la passer à chaque appel à la fonction. '> \ No newline at end of file