From 42a2caef1ab99f6bd0b1af990db4069f9cc9c4be Mon Sep 17 00:00:00 2001 From: yannick Date: Sun, 10 Jul 2005 19:27:50 +0000 Subject: [PATCH] sync with EN --- docs/fr/appendixes/tips.xml | 158 ++++++++++++++--------- docs/fr/appendixes/troubleshooting.xml | 119 +++++++++++++++-- docs/fr/designers/config-files.xml | 15 ++- docs/fr/designers/language-variables.xml | 9 +- docs/fr/getting-started.xml | 76 ++++++----- 5 files changed, 267 insertions(+), 110 deletions(-) diff --git a/docs/fr/appendixes/tips.xml b/docs/fr/appendixes/tips.xml index 3c59fc3b..d12513ac 100644 --- a/docs/fr/appendixes/tips.xml +++ b/docs/fr/appendixes/tips.xml @@ -1,6 +1,6 @@ - + Trucs et astuces @@ -14,10 +14,11 @@ instruction {if} pour gérer celà, mais il existe un moyen plus facile dans Smarty : l'utilisation du modificateur - de variable default. + de variable défaut. - afficher   quand une variable est vide + Afficher   quand une variable est vide la gestion des variables non-assignées. + Passage du titre à un template d'en-tête Quand la majorité de vos templates utilisent les mêmes en-tête et pied-de-page, - il est d'usage de les mettre dans leurs propres templates et de les inclure. + il est d'usage de les mettre dans leurs propres templates et de les inclure + ({include}). Mais comment faire si l'en-tête doit avoir un titre différent, selon la page d'où on vient ? Vous pouvez passer le titre à l'en-tête quand il est inclus. + passer le titre au template d'en-tête + + + mainpage.tpl + + - -archives.tpl ------------- + + archives.tpl + + + + + + header.tpl + + + + + {$title|default:"BC News"} + + + ]]> + -header.tpl ----------- - - -{$title|default:"BC News"} - - - - -footer.tpl ----------- - - + + footer.tpl + + + + ]]> + - Quand la page principale est conçue, le titre "Main page" est passé à header.tpl - et sera donc utilisé pour le titre. Quand la page d'archive est conçue, - 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 + Quand la page principale est conçue, le titre "Main page" est passé à + header.tpl et sera donc utilisé pour le titre. + Quand la page d'archive est conçue, 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. @@ -192,7 +212,7 @@ Jan 4, 2001 $startDate = makeTimeStamp($startDate_Year, $startDate_Month, $startDate_Day); -function makeTimeStamp($year="", $month="", $day="") +function makeTimeStamp($year='', $month='', $day='') { if(empty($year)) { $year = strftime("%Y"); @@ -210,30 +230,33 @@ function makeTimeStamp($year="", $month="", $day="") ]]> - + Voir aussi {html_select_date}, {html_select_time}, - date_format - et $smarty.now, + date_format et + $smarty.now, WAP/WML - Les templates WAP/WML nécessitent un en-tête "Content-Type" qui doit être + Les templates WAP/WML nécessitent un en-tête + Content-Type qui doit être passé avec le template. Le moyen le plus facile de faire celà est d'écrire - une fonction utilisateur qui écrit l'en-tête. Si vous utilisez le cache, + une fonction utilisateur qui écrit l'en-tête. Si vous utilisez le + cache, celà ne fonctionnera pas. Nous utiliserons donc une balise d'insertion + ({insert}) (rappelez-vous que les balises d'insertion ne sont pas mises en cache !). Assurez-vous qu'aucune sortie rien n'est transmise au navigateur avant l'appel du template, sans quoi la modification de l'en-tête échouera. - Utilisation d'insert pour écrire un en-tête Content-Type WML + Utilisation d'{insert} pour écrire un en-tête Content-Type WML - + + - - - - - - - -

+ + + + + + + +

Welcome to WAP with Smarty! - Press OK to continue... -

- - - -

+ Press OK to continue... +

+ + + +

Pretty easy isn't it? -

- +

+ ]]> @@ -293,8 +316,8 @@ function insert_header() Traditionnellemnt, la programmation avec des templates dans les applications se déroule de la façon suivante : d'abord vous récupérez vos variables dans l'application PHP (peut-être avec des requêtes en base de données), puis - vous instanciez votre objet Smarty, assignez - les variables et affichez le + vous instanciez votre objet Smarty, assign() + les variables et display() le template. Disons par exemple que nous avons un téléscripteur dans notre template. Nous récupérerions les données dans notre application, puis les assignerions ensuite pour les afficher. Mais ne serait-ce pas @@ -308,12 +331,15 @@ function insert_header() Template composant + + function.load_ticker.php - + Efface le fichier du répertoire des + $plugins + assign($params['assign'], $ticker_info); } ?> ]]> + + index.tpl + {mailto}. Exemple de dissimulation d'une adresse email @@ -381,10 +409,12 @@ Send inquiries to Voir aussi - escape. + escape et + {mailto}. + + --> \ No newline at end of file diff --git a/docs/fr/appendixes/troubleshooting.xml b/docs/fr/appendixes/troubleshooting.xml index 3b1ac6fc..defe66b7 100644 --- a/docs/fr/appendixes/troubleshooting.xml +++ b/docs/fr/appendixes/troubleshooting.xml @@ -1,6 +1,6 @@ - + Diagnostic des erreurs @@ -23,21 +23,21 @@ Fatal error: Smarty: [in index.tpl line 28]: syntax error: missing section name ]]> - + Smarty vous indique le nom du template, le numéro de la ligne et l'erreur. Après cela, vous pouvez connaître le numéro de ligne où il y a eu erreur dans la définition de la classe Smarty. - + Il y a certaines erreurs que Smarty ne peut pas détecter, comme les balises fermantes manquantes. Ce type d'erreurs est la plupart du temps repéré dans la phase de compilation PHP du template compilé. - + - erreur d'analyse PHP + Erreur d'analyse PHP + + + + Autres erreurs communes + + + + + + + + + + + Le dossier $template_dir + est incorrect, n'existe pas ou le fichier + the file index.tpl n'est pas dans le dossier + templates/. + + + + + Une fonction {config_load} + est dans un template (ou + config_load() + a été appelé) et soit + $config_dir + est incohérent, n'existe pas, ou + site.conf n'est pas dans le dossier. + + + + + + + + + + + + + Soit le dossier + $compile_dir + n'est pas correctement défini, le dossier n'existe pas, ou + templates_c est un fichier et non un dossier. + + + + + + + Le dossier $compile_dir + n'est pas accessible en écriture par le serveur web. Voir le bas + de la page sur l'installation de + Smarty pour les permissions. + + + + + + + + + Cela signifie que + $caching est activé et soit + le dossier + $cache_dir + n'est pas correctement défini, le dossier n'existe pas, ou + cache est un fichier et non un dossier. + + + + + + + + + Cela signifie que + $caching est activé et le dossier + $cache_dir + n'est pas accessible en écriture par le serveur web. Voir le bas + de la page sur l'installation de + Smarty pour les permissions. + + + + + Voir aussi le débogage, - $error_reporting - et trigger_error(). + $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 43469546..79966ec8 100644 --- a/docs/fr/designers/config-files.xml +++ b/docs/fr/designers/config-files.xml @@ -1,6 +1,6 @@ - + Fichiers de configuration @@ -68,8 +68,8 @@ pass=foobar Les fichiers de configuration sont chargés dans le template grâce aux fonctions {config_load}, - et config_load(). + linkend="language.function.config.load">{config_load} + (voir aussi config_load()). Vous pouvez masquer des variables ou des sections entières en préfixant @@ -80,7 +80,16 @@ pass=foobar êtes sûr que ces derniers n'accèderont pas à ces données de configuration en les chargeant depuis le template. + + Voir aussi + {config_load}, + $config_overwrite, + get_config_vars(), + clear_config() et + config_load(). + + - + Variables @@ -9,9 +9,12 @@ Les variables de Smarty peuvent être soit affichées directement, soit utilisées - comme arguments pour les fonctions et modificateurs, à l'intérieur d'expressions + comme arguments pour les + fonctions + et modificateurs, à l'intérieur d'expressions conditionnelles, etc. - Pour afficher une variable, il suffit de l'entourer par des délimiteurs de + Pour afficher une variable, il suffit de l'entourer par des + délimiteurs de telle sorte qu'elle soit la seule chose qu'ils contiennent. Exemple : - + Pour commencer @@ -136,7 +136,7 @@ - Architecture de plugins + Architecture de plugins @@ -163,7 +163,7 @@ Smarty. - fichiers de la bibliothèque SMARTY + fichiers nécessaires de la bibliothèque SMARTY @@ -182,7 +182,8 @@ debug.tpl représente le chemin complet de la bibliothèque Smarty. En fait, si votre application trouve le fichier Smarty.class.php, vous n'aurez pas - besoin de définir la variable SMARTY_DIR, Smarty s'en chargera pour vous. + besoin de définir la variable SMARTY_DIR, + Smarty s'en chargera pour vous. En revanche, si Smarty.class.php n'est pas dans votre répertoire d'inclusion ou que vous ne donnez pas un chemin absolu à votre application, vous @@ -255,11 +256,16 @@ $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. + + Smarty a besoin de quatre répertoires qui sont (par défaut) - templates, - templates_c, - configs et - cache. Chacun d'entre eux peut être défini + 'templates/', + 'templates_c/', + 'configs/' et + 'cache/'. + + + Chacun d'entre eux peut être défini via les attributs $template_dir, @@ -296,20 +302,26 @@ $smarty = new Smarty; Vous allez avoir besoin d'au moins un fichier à la racine de l'arborescence Web, il s'agit du script auquel l'internaute a accès. Nous allons l'appeler - index.php et le placer dans un sous-répertoire - appelé /livredor/. + 'index.php' et le placer dans un sous-répertoire + appelé /livredor/. Technical Note Il est pratique de configurer le serveur Web de - sorte que "index.php" soit identifié comme fichier + sorte que 'index.php' soit identifié comme fichier par défaut de ce répertoire. Aicnsi, si l'on tape - "http://www.example.com/livredor/", le script index.php soit - exécuté sans que "index.php" ne soit spécifié dans l'URL. Avec Apache - vous pouvez régler celà en ajoutant "index.php" à la ligne où se - trouve DirectoryIndex (séparez chaque entrée par un espace). + 'http://www.example.com/livredor/', le script 'index.php' soit + exécuté sans que 'index.php' ne soit spécifié dans l'URL. Avec Apache, + vous pouvez régler cela en ajoutant 'index.php' à la ligne où se + trouve DirectoryIndex (séparez chaque entrée par un espace) + dans le httpd.conf. + + + DirectoryIndex + index.htm index.html index.php index.php3 default.html index.cgi + @@ -317,7 +329,7 @@ $smarty = new Smarty; - exemple de structure de fichiers + Exemple de structure de fichiers - Smarty a besoin d'accéder en écriture aux répertoires - + Smarty a besoin d'accéder en écriture + aux répertoires $compile_dir et $cache_dir, assurez-vous donc que le serveur Web dispose de ces droits d'accès. @@ -376,8 +388,8 @@ chmod 770 /web/www.example.com/smarty/livredor/cache/ - Nous devons créer le fichier index.tpl que Smarty va charger. - Il va se trouver dans $template_dir. + Nous devons créer le fichier 'index.tpl' que Smarty va charger. + Il va se trouver dans $template_dir. @@ -396,8 +408,8 @@ Hello, {$name}! Note technique - {* Smarty *} est un commentaire de template. Il n'est pas - obligatoire mais il est bon de commencer tous vos templates + {* Smarty *} est un commentaire + de template. Il n'est pas obligatoire mais il est bon de commencer tous vos templates avec ce commentaire. Celà rend le fichier facilement reconnaissable en plus de son extension. Les éditeurs de texte peuvent par exemple reconnaître le fichier et @@ -406,16 +418,16 @@ Hello, {$name}! - Maintenant passons à l'édition du fichier index.php. Nous allons + Maintenant passons à l'édition du fichier 'index.php'. Nous allons créer une instance de Smarty, assigner une valeur à une variable - de template et afficher le résultat avec index.tpl. Dans notre + 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. - édition de /web/www.example.com/docs/livredor/index.php + Édition de /web/www.example.com/docs/livredor/index.php Dans notre exemple, nous avons configuré les chemins absolus pour chacun des répertoires Smarty. Si - /web/www.example.com/smarty/livredor/ + /web/www.example.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érience) + Quoi qu'il en soit, il est plus efficace et (par expérience) moins générateur d'erreurs de les définir avec des chemins absolus. Celà nous garantit que Smarty récupèrera les bons fichiers. @@ -518,11 +530,11 @@ Hello, {$name}! - Modifions maintenant le fichier index.php pour qu'il utilise "setup.php" + Modifions maintenant le fichier 'index.php' pour qu'il utilise 'setup.php' - Edition de /web/www.example.com/docs/livredor/index.php + Édition de /web/www.example.com/docs/livredor/index.php ]]> - +