From bb34c90acf796fb942dcd0b4ac64fc3aa6620ece Mon Sep 17 00:00:00 2001 From: yannick Date: Sun, 9 Apr 2006 21:59:55 +0000 Subject: [PATCH] sync with EN --- docs/fr/appendixes/tips.xml | 15 +++-- .../language-syntax-comments.xml | 22 +++++--- .../language-syntax-functions.xml | 18 ++++-- .../language-syntax-variables.xml | 21 ++++--- .../designers/language-builtin-functions.xml | 18 ++++-- .../language-function-capture.xml | 37 ++++++------- .../language-function-insert.xml | 4 +- .../language-function-php.xml | 22 ++++++-- .../language-function-assign.xml | 7 ++- .../language-function-eval.xml | 38 ++++++++++--- docs/fr/designers/language-modifiers.xml | 46 +++++++++++----- .../language-modifier-default.xml | 10 +++- .../language-modifier-escape.xml | 34 ++++++++---- .../language-modifier-nl2br.xml | 40 +++++++------- .../language-modifier-truncate.xml | 4 +- .../language-variables-smarty.xml | 55 +++++++++++++++---- 16 files changed, 262 insertions(+), 129 deletions(-) diff --git a/docs/fr/appendixes/tips.xml b/docs/fr/appendixes/tips.xml index c13a391c..b6ba7803 100644 --- a/docs/fr/appendixes/tips.xml +++ b/docs/fr/appendixes/tips.xml @@ -1,6 +1,6 @@ - + Trucs et astuces @@ -111,7 +111,7 @@ - header.tpl - Notez que "BC News" est affiché si la variable + header.tpl - Notez que "Smarty News" est affiché si la variable $title n'est pas définie, en utilisant le modificateur de variable par défaut. @@ -119,7 +119,7 @@ - {$title|default:'BC News'} + {$title|default:'Smarty News'} ]]> @@ -359,7 +359,7 @@ function smarty_function_load_ticker($params, &$smarty) @@ -387,10 +387,9 @@ Stock Name: {$ticker.name} Stock Price: {$ticker.price} Exemple de dissimulation d'une adresse email Envoyer une demande à +{mailto address=$EmailAddress encode='javascript' subject='Bonjour'} ]]> diff --git a/docs/fr/designers/language-basic-syntax/language-syntax-comments.xml b/docs/fr/designers/language-basic-syntax/language-syntax-comments.xml index 7f445b66..fc06a6c2 100644 --- a/docs/fr/designers/language-basic-syntax/language-syntax-comments.xml +++ b/docs/fr/designers/language-basic-syntax/language-syntax-comments.xml @@ -1,6 +1,6 @@ - + Commentaires @@ -10,15 +10,18 @@ de cette façon : {* voici un commentaire *} Les commentaires Smarty ne sont PAS affichés dans la sortie finale du template, différemment des <!-- commentaires HTML --> - et sont utilisés pour des notes internes, dans le template, pour aider - les développeurs à en comprendre le fonctionnement. + et sont utilisés pour des notes internes, dans le template que personne ne verra ;) - Commentaires + Commentaires dans un template {* Je suis un commentaire Smarty, je n'existe pas dans la sortie compilée *} + + + {$title} + + {* un autre commentaire Smarty sur une seule ligne *} @@ -35,7 +38,7 @@ Un bloc de commentaires multilignes contenant les cr @ css: the style output **********************************************************} -{* Inclusion du fichier d'en tête *} +{* Inclusion du fichier d'en-tête contenant le logo principal *} {include file='header.tpl'} {* Note aux développeurs : $includeFile est assigné au script foo.php *} @@ -48,10 +51,13 @@ Un bloc de commentaires multilignes contenant les cr {html_options options=$vals selected=$selected_id} *} -{* Balise cvs pour un template *} -{* $Id: Exp $ *} +{* Balise cvs pour un template, ci-dessous, le 36 DOIT ÊTRE une devise américaine sinon, +il sera converti en cvs.. *} +{* $Id: Exp $ *} +{* $Id: *} + ]]> diff --git a/docs/fr/designers/language-basic-syntax/language-syntax-functions.xml b/docs/fr/designers/language-basic-syntax/language-syntax-functions.xml index f0e2e30d..64787512 100644 --- a/docs/fr/designers/language-basic-syntax/language-syntax-functions.xml +++ b/docs/fr/designers/language-basic-syntax/language-syntax-functions.xml @@ -1,11 +1,12 @@ - + + Fonctions Les balises Smarty affichent une variable - ou invoquent une fonction. Les fonctions sont appelées + ou invoquent une fonction. Elles sont appelées lorsqu'elles sont entourées, ainsi que leurs paramètres, des délimiteurs Smarty. Par exemple : {nomfonction attr1='val' attr2='val'}. @@ -16,15 +17,15 @@ {$name}! {else} Bonjour, {$name}! {/if} -{include file='footer.tpl'} +{include file='footer.tpl' ad=$random_id} ]]> @@ -39,7 +40,7 @@ comme {if}, {section} et {strip}. - Elles ne devraient pas être modifiées. + Il n'y a aucune raison à ce qu'elles soient modifiées ou changées. Les fonctions utilisateurs sont des fonctions additionnelles, @@ -50,6 +51,11 @@ {popup} sont deux exemples de fonctions utilisateurs. + + + Voir aussi + register_function(). + - + + Variables Les variables de template commence par un signe dollar ($). Elles peuvent contenir des nombres, des lettres et des underscores, tout - comme une variable PHP. + comme une variable PHP. Vous pouvez référencer des tableaux indexés - numériquement ou non. Vous pouvez aussi référencer des propriétés d'objet - ainsi que des méthodes. Les variables des fichiers de + numériquement ou non. Vous pouvez aussi référencer des propriétés d'objet + ainsi que des méthodes. + + + Les variables des fichiers de configuration sont une exception à la synthaxe utilisant un signe dollar. Elles peuvent être - référencées en les entourant du signe dièse (#) ou avec la variable spéciale + référencées en les entourant du signe dièse (#) ou via la variable spéciale $smarty.config. @@ -27,7 +31,7 @@ {#foo#} <-- affiche la variable du fichier de configuration "foo" {$smarty.config.foo} <-- synonyme pour {#foo#} {$foo[bar]} <-- synthaxe uniquement valide dans une section de boucle, voir {section} -{assign var=foo value="baa"}{$foo} <-- affiche "baa", voir {assign} +{assign var=foo value='baa'}{$foo} <-- affiche "baa", voir {assign} Plusieurs autres combinaisons sont autorisées @@ -46,9 +50,10 @@ Plusieurs autres combinaisons sont autoris - Les variables spéciales comme get, post, session, etc. sont également disponibles, + Les variables spéciales comme $_GET, $_SESSION, etc. sont également disponibles, lisez le chapitre sur les variables réservées - $smarty pour plus de détails. + $smarty + pour plus de détails. diff --git a/docs/fr/designers/language-builtin-functions.xml b/docs/fr/designers/language-builtin-functions.xml index b521cd8e..d776001f 100644 --- a/docs/fr/designers/language-builtin-functions.xml +++ b/docs/fr/designers/language-builtin-functions.xml @@ -1,15 +1,23 @@ - + Fonctions natives Smarty est fourni en standard avec plusieurs fonctions natives. - Les fonctions natives sont partie intégrante du language de template. - Vous ne pouvez pas créer de fonctions utilisateurs qui portent le même nom - qu'une fonction native. Vous ne pouvez pas non plus en modifier le - comportement. + Ces fonctions natives sont partie intégrante du moteur de Smarty. + Vous ne pouvez pas créer de + fonctions utilisateurs + qui portent le même nom qu'une fonction native et vous ne pouvez pas non + plus en modifier le comportement. + + + Quelques-unes de ces fonctions ont un attribut + assign qui récupère le résultat de la + fonction et la place dans une variable nommée dans le template plutôt que + de l'afficher.tout comme la fonction + {assign}. &designers.language-builtin-functions.language-function-capture; diff --git a/docs/fr/designers/language-builtin-functions/language-function-capture.xml b/docs/fr/designers/language-builtin-functions/language-function-capture.xml index 2596d587..0c166245 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-capture.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-capture.xml @@ -1,6 +1,6 @@ - + {capture} @@ -8,14 +8,19 @@ {capture} est utilisé pour récupérer la sortie d'éléments dans une variable au lieu de les afficher. Tout contenu situé entre {capture - name="foo"} et {/capture} est intercepté dans une variable dont le nom est - spécifié dans l'attribut name. Le contenu capturé peut être utilisé dans + name='foo'} et {/capture} est intercepté dans une variable dont le nom est + spécifié dans l'attribut name. + + + Le contenu capturé peut être utilisé dans le template par l'intermédiaire de la variable spéciale $smarty.capture.foo où "foo" est la valeur de l'attribut name. Si vous ne donnez pas de valeur - à l'attribut name, alors "default" est utilisé. Toutes les commandes - {capture} doivent être utilisées de paire avec {/capture}. Vous pouvez - imbriquer les demandes de captures. + à l'attribut name, alors "default" est utilisé en tant que nom, i.e. + $smarty.capture.default. + + + {capture} peut être imbriqué. @@ -65,38 +70,32 @@ - Capturer le contenu d'un template. + {capture} avec le nom de l'attribut - - - {$smarty.capture.banner} - - - + {/if} ]]> - Capturer le contenu dans une variable + {capture} dans une variable de template Cet exemple démontre également la fonction {popup} +Votre IP est {$smarty.server.REMOTE_ADDR}. {/capture} - -help +Aide ]]> diff --git a/docs/fr/designers/language-builtin-functions/language-function-insert.xml b/docs/fr/designers/language-builtin-functions/language-function-insert.xml index 1ca03749..adf724c4 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-insert.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-insert.xml @@ -1,6 +1,6 @@ - + {insert} @@ -9,7 +9,7 @@ Les balises {insert} fonctionnent à peu près comme les balises include, à l'exception que leur sortie n'est PAS placée en cache lorsque - le cache est activé. + le cache du template est activé. Les balises {insert} seront exécutées à chaque appel du template. diff --git a/docs/fr/designers/language-builtin-functions/language-function-php.xml b/docs/fr/designers/language-builtin-functions/language-function-php.xml index aaa6d182..c05a2b6b 100644 --- a/docs/fr/designers/language-builtin-functions/language-function-php.xml +++ b/docs/fr/designers/language-builtin-functions/language-function-php.xml @@ -1,6 +1,6 @@ - + {php} @@ -9,11 +9,11 @@ template. Ils ne seront pas ignorés, quelle que soit la valeur de $php_handling. Pour les utilisateurs avancés seulement, son utilisation n'est normalement pas - nécessaire. + nécessaire et n'est pas recommandée. Balises {php} - + - Balises {php} avec le mot clé global + Balises {php} avec le mot clé global et assignement d'une variable assign('varX','Strawberry'); +{/php} +{$varX} est ma glâce favorite +]]> + + + Ce qui suit n'est vrament PAS recommandé, vu que c'est dans le contexte du template. + + + diff --git a/docs/fr/designers/language-custom-functions/language-function-assign.xml b/docs/fr/designers/language-custom-functions/language-function-assign.xml index b2b420cf..c4880840 100644 --- a/docs/fr/designers/language-custom-functions/language-function-assign.xml +++ b/docs/fr/designers/language-custom-functions/language-function-assign.xml @@ -1,11 +1,12 @@ - + {assign} - {assign} est utilisé pour déclarer ou modifier des variables de template. + {assign} est utilisé pour déclarer des variables de template + durant l'exécution du template. @@ -73,7 +74,7 @@ La valeur de $name est Bob. Accès aux variables {assign} depuis un script PHP. - Pour accéder aux variables {assign} depuis PHP, utilisez + Pour accéder aux variables {assign} depuis le script PHP, utilisez get_template_vars(). Cependant, les variables ne sont disponibles qu'après ou pendant l'exécution du template, comme le montre l'exemple suivant : diff --git a/docs/fr/designers/language-custom-functions/language-function-eval.xml b/docs/fr/designers/language-custom-functions/language-function-eval.xml index 0a0ab0f9..7bff3e86 100644 --- a/docs/fr/designers/language-custom-functions/language-function-eval.xml +++ b/docs/fr/designers/language-custom-functions/language-function-eval.xml @@ -1,6 +1,6 @@ - + {eval} @@ -71,9 +71,8 @@ {eval} emphend = titre = Bienvenue sur la homepage de {$company} ! @@ -82,16 +81,16 @@ ErrorDept = Vous devez sp ]]> - Où index.tpl est : + Où le template est : @@ -104,10 +103,33 @@ Ceci est le contenu de foo. Bienvenue sur la homepage de FictifLand. Vous devez spécifier un nom de ville. Vous devez spécifier un département. - ]]> + + + un autre exemple avec {eval} + + Ceci va afficher le nom du serveur (en majuscule) et son IP. + La variable $str également venir d'une requête de base de données. + + +assign('foo',$str); + ]]> + + + Où le template est : + + + + + - + Modificateurs de variables - Les modificateurs de variables peuvent être appliqués aux variables, - fonctions utilisateurs ou chaînes de caractères. Pour appliquer un modificateur + Les modificateurs de variables peuvent être appliqués aux + variables, + fonctions utilisateurs + ou chaînes de caractères. Pour appliquer un modificateur de variable, tappez une valeure suivie de | (pipe) et du nom du modificateur. Un modificateur de variable est succeptible d'accepter des paramètres additionnels, qui en affectent le comportement. Ces paramètres suivent le nom du modificateur et sont séparés par un : (deux points). + De plus, toutes les fonctions PHP peuvent être utilisées en tant que modifieurs + implicitement. Exemple de modificateur @@ -21,21 +25,35 @@ {$titre|upper} {* modificateur avec paramètres *} -{$titre|truncate:40:"..."} +{$titre|truncate:40:'...'} {* applique un modificateur à un paramètre de fonction *} {html_table loop=$mavariable|upper} {* avec paramètres *} -{html_table loop=$mavariable|truncate:40:"..."} +{html_table loop=$mavariable|truncate:40:'...'} {* applique un modificateur à une chaine de caractères *} -{"foobar"|upper} +{'foobar'|upper} {* utilise date_format pour mettre en forme la date *} {$smarty.now|date_format:"%d/%m/%Y"} {* applique un modificateur à une fonction utilisateur *} -{mailto|upper address="moi@domaine.dom"} +{mailto|upper address='smarty@example.com'} + +{* utilisation de la fonction PHP str_repeat *} +{'='|str_repeat:80} + +{* Compteur PHP *} +{$myArray|@count} + +{* mélange aléatoire des IP du serveur grâce à PHP *} +{$smarty.server.SERVER_ADDR|shuffle} + +(* ceci va mettre en majuscule et tronque le tableau *} + ]]> @@ -49,21 +67,21 @@ Les modificateurs sont chargés automatiquement depuis votre répertoire - de plugin $plugins_dir (voir aussi: - convention de nommage) - ou peuvent être enregistrés explicitement (voir: register_modifier). + de plugin $plugins_dir + ou peuvent être enregistrés explicitement avec register_modifier() ; ceci est utile + pour partager une fonction dans un scirpt PHP et les templates Smarty. - De même, toutes les fonction php peuvent être utilisées comme modificateur, + Toutes les fonction PHP peuvent être utilisées comme modificateur, sans autre déclaration. (L'exemple avec - @count ci dessus utilise la fonction count(), et non un modificateur + @count ci-dessus utilise la fonction count(), et non un modificateur Smarty. Utiliser des fonctions PHP en tant que modificateur comporte deux risques: Premièrement: il arrive que l'ordre des paramètres ne soit pas celui attendu ({"%2.f"|sprintf:$float} fonctionne, mais demande une syntaxe plus naturelle, par exemple{$float|string_format:"%2.f"} fourni dans la distribution Smarty). Deuxièmement : lorsque $security est activé, les fonctions php + linkend="variable.security">$security est activé, les fonctions PHP utilisées en tant que modificateur doivent être explicitement déclarées comme connues dans le tableau $security_settings['MODIFIER_FUNCS']. diff --git a/docs/fr/designers/language-modifiers/language-modifier-default.xml b/docs/fr/designers/language-modifiers/language-modifier-default.xml index 6d25af58..e5dcde52 100644 --- a/docs/fr/designers/language-modifiers/language-modifier-default.xml +++ b/docs/fr/designers/language-modifiers/language-modifier-default.xml @@ -1,6 +1,6 @@ - + default @@ -9,6 +9,14 @@ Si la variable est vide ou indéfinie, la valeur donnée est affichée en lieu et place. Default attends un seul argument. + + + + Avec error_reporting(E_ALL), les variables non déclarées lanceront toujours une erreur + dans le template. Cette fonction est utile pour remplacer les chaînes vides ou de longueurs vides. + + + diff --git a/docs/fr/designers/language-modifiers/language-modifier-escape.xml b/docs/fr/designers/language-modifiers/language-modifier-escape.xml index 211e3454..ff8a406f 100644 --- a/docs/fr/designers/language-modifiers/language-modifier-escape.xml +++ b/docs/fr/designers/language-modifiers/language-modifier-escape.xml @@ -1,13 +1,13 @@ - + escape - "Echappe" les caractères spéciaux html, d'url, pour - les quotes d'une chaîne, les valeurs - hexadécimales, les entités hexadécimales ou javascript. + Utile pour encoder / échapper une variable pour quelles soient compatibles + pour les URL Html, pour les hexadécimaux, pour les entités hexadécimales, pour javascript + et pour les e-mails. Par défaut, ce paramètre est html. @@ -76,12 +76,13 @@ $smarty->assign('EmailAddress','smarty@example.com'); {$EmailAddress|escape:"hexentity"} -{$EmailAddress|escape:'mail'} +{$EmailAddress|escape:'mail'} {* ceci convertit l'e-mail en texte *} +{'mail@example.com'|escape:'mail'} ]]> @@ -97,6 +98,7 @@ $smarty->assign('EmailAddress','smarty@example.com'); \'Stiff Opposition Expected to Casketless Funeral Plan\' bob..snip..et smarty [AT] example [DOT] com +mail [AT] example [DOT] com ]]> @@ -108,11 +110,21 @@ smarty [AT] example [DOT] com click here ]]> + + Et ceci est utile pour les e-mails, mais lisez plutôt la documentation de + {mailto} + + {$EmailAddress|escape:'mail'} +]]> + Voir aussi la - désactivation de l'analyse de Smarty et - le mascage des adresses E-mail. + l'anayse Smarty d'échappement, + {mailto} et + le mascage des adresses e-mail. diff --git a/docs/fr/designers/language-modifiers/language-modifier-nl2br.xml b/docs/fr/designers/language-modifiers/language-modifier-nl2br.xml index a849f553..a05848e7 100644 --- a/docs/fr/designers/language-modifiers/language-modifier-nl2br.xml +++ b/docs/fr/designers/language-modifiers/language-modifier-nl2br.xml @@ -1,6 +1,6 @@ - + nl2br @@ -10,7 +10,7 @@ nl2br - + assign('articleTitle', ?> ]]> - - -Où le template est : - - + + + Où le template est : + + - - -Ce qui donne en sortie : - - + + + Affichera : + + aujourd'hui, nuit noire ]]> - - - - Voir aussi - word_wrap, - count_paragraphs et - count_sentences. - + + + + Voir aussi + word_wrap, + count_paragraphs et + count_sentences. + - + truncate @@ -90,6 +90,7 @@ O {$titreArticle|truncate:30:"---"} {$titreArticle|truncate:30:"":true} {$titreArticle|truncate:30:"...":true} +{$articleTitle|truncate:30:'..':true:true} ]]> @@ -103,6 +104,7 @@ Deux soeurs r Deux soeurs réunies après--- Deux soeurs réunies après 18 a Deux soeurs réunies après 1... +Deux soeurs ... de séparation. ]]> diff --git a/docs/fr/designers/language-variables/language-variables-smarty.xml b/docs/fr/designers/language-variables/language-variables-smarty.xml index c8c26fb3..5b212578 100644 --- a/docs/fr/designers/language-variables/language-variables-smarty.xml +++ b/docs/fr/designers/language-variables/language-variables-smarty.xml @@ -1,12 +1,12 @@ - + Variable réservée {$smarty} La variable PHP réservée {$smarty} peut être utilisée pour accéder à plusieurs - variables spéciales du template. En voici la liste complète. + variables d'environnements. En voici la liste complète. @@ -51,6 +51,12 @@ directement, cependant, {$smarty.server.SCRIPT_NAME} est la solution proposée pour accéder à cette valeur. + +click me +click me +]]> + @@ -59,10 +65,12 @@ Le timestamp courant peut être récupéré grâce à {$smarty.now}. - Le nombre obtenu correspond au nombre de secondes écoulées depuis + La valeur correspond au nombre de secondes écoulées depuis Epoch (1 Janvier 1970) et peut être passé directement au modificateur de variable date date_format - à des fins d'affichage. + à des fins d'affichage. Notez que time() est appelé à chaque invocation, i.e. + un script qui prend 3 secondes à s'exécuter avec $smarty.now au début et à la fin montrera + les 3 secondes de différence. Utilisation de {$smarty.now} @@ -82,9 +90,16 @@ Voir aussi les constantes smarty. - Utiliser {$smarty.const} + Utiliser {$smarty.const} pour accéder aux constantes + + + @@ -94,9 +109,9 @@ {$smarty.capture} - La capture réalisée via + La sortie du template réalisée via {capture}..{/capture} - peut être récupérée par l'intermédiaire de la variable {$smarty}. Voir la section + peut être récupérée par l'intermédiaire de la variable {$smarty.capture}. Voir la section sur {capture} pour un exemple à ce sujet. @@ -120,27 +135,47 @@ des boucles 'section' et 'foreach'. Voir la documentation de {section} et {foreach}. + Ils ont des valeurs vraiment utiles comme .first, .index, etc. {$smarty.template} - Cette variable contient le nom du template en cours de traitement. + Retourne le nom du template courant. Cet exemple montre le container.tpl + ainsi que le banner.tpl inclu avec {$smarty.template}. + +Le conteneur principal est {$smarty.template} +{include file='banner.tpl} + ]]> + +Affichera : + + Le conteneur principal est container.tpl + banner.tpl + ]]> + {$smarty.version} - Cette variable contient la version de Smarty utilisée pour compiler un template. + Retourne la version de Smarty ayant servie à compiler le template. + +Généré par Smarty {$smarty.version} +]]> + {$smarty.ldelim}, {$smarty.rdelim} - Cette variable est utilisée pour afficher le délémiteur gauche et le délimiteur droit. Lisez aussi + Ces variables sont utilisées pour afficher le délémiteur gauche et le délimiteur droit. Lisez aussi la partie {ldelim},{rdelim}.