You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by lg...@apache.org on 2013/01/27 15:32:37 UTC
svn commit: r1439089 - /httpd/httpd/trunk/docs/manual/mod/mod_macro.xml.fr
Author: lgentis
Date: Sun Jan 27 14:32:36 2013
New Revision: 1439089
URL: http://svn.apache.org/viewvc?rev=1439089&view=rev
Log:
Update.
Modified:
httpd/httpd/trunk/docs/manual/mod/mod_macro.xml.fr
Modified: httpd/httpd/trunk/docs/manual/mod/mod_macro.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_macro.xml.fr?rev=1439089&r1=1439088&r2=1439089&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_macro.xml.fr (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_macro.xml.fr Sun Jan 27 14:32:36 2013
@@ -1,8 +1,9 @@
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1436366:1436574 (outdated) -->
+<!-- English Revision: 1436574 -->
<!-- French translation: Fabien Coelho -->
+<!-- Updated by Lucien Gentis -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
@@ -43,7 +44,7 @@ de configuration Apache.</description>
<p>Définition d'une macro :</p>
<ul>
- <li> dans une section <Macro> au style homogène à la
+ <li> dans une section <Macro> au style conforme à la
syntaxe des fichiers de configuration Apache.</li>
<li> l'utilisateur choisit le nom de la macro et de ses paramètres.</li>
<li> les noms de macro sont insensibles à la casse, comme les directives Apache.</li>
@@ -51,25 +52,25 @@ de configuration Apache.</description>
<li> les paramètres d'une macro doivent avoir des noms distincts.</li>
<li> il y a une erreur si un paramètre a un nom vide.</li>
<li> la redéfinition d'une macro génère un avertissement.</li>
- <li> des définitions de macros peuvent être nichées les unes dans les autres...</li>
+ <li> des définitions de macros peuvent être imbriquées les unes dans les autres... (mais dans quel but ?)</li>
<li> les paramètres inutilisés génèrent un avertissement.</li>
<li> les noms de paramètre en préfixe les uns des autres génèrent un avertissement.</li>
- <li> les noms de paramètre non préfixés par '<code>$%@</code>' génèrent un
+ <li> les noms de paramètre non préfixés par un des caractères '<code>$%@</code>' génèrent un
avertissement pour encourager cette bonne pratique.</li>
<li> les différents préfixes proposés permettent de gérer les interactions
avec d'autres directives comme <directive module="core">Define</directive>.</li>
<li> un conseil : il peut être utile d'ajouter des accolades autour du nom d'un
paramètre, par exemple <code>${foo}</code>, de manière à ce que le
- paramètre puisse être utilisée avec des caractères collés autour,
+ paramètre puisse être utilisé entouré de caractères,
par exemple <code>bla${foo}bla</code>.</li>
<li> génère un avertissement si le contenu de la macro est vide.</li>
<li> génère un avertissement si le système détecte que les sections à l'intérieur
- d'une macro ne sont pas correctement nichées.</li>
+ d'une macro ne sont pas correctement imbriquées.</li>
<li> la portée lexicale des paramètres d'une macro est restreinte au texte
de la macro elle-même... en particulier elle n'est pas propagée aux inclusions.</li>
<li> il n'y a pas de contrainte sur le contenu d'une macro.
<p>Cela signifie que vous pouvez mettre une section perl ou n'importe
- quoi d'autre dans une macro. Il n'y a pas d'autre hypothèse sur la
+ quoi d'autre dans une macro. Il n'y a pas d'autre contrainte sur la
structure lexicale et syntaxique de la macro (guillemets, espaces...)
que d'attendre une séquence de ligne avec éventuellement des
continuations.</p></li>
@@ -77,19 +78,19 @@ de configuration Apache.</description>
<p>Utilisation d'une macro:</p>
<ul>
- <li> le nombre d'argument doit être cohérent avec la définition.</li>
- <li> toutes les occurences des paramètres sont substitués par leur valeur.</li>
- <li> en cas de conflit, le nom le plus long est choisit.</li>
- <li> une récursion dans l'expansion d'une macro est détectée et arrêtée avec une erreur.</li>
- <li> les arguments vides génèrent un avertissement si ils sont utilisés.</li>
- <li> le système génère une description très précise de la localisation des erreurs.</li>
- <li> les valeurs des paramètres préfixés par <code>$</code> et <code>%</code> ne sont pas protégés.</li>
- <li> les valeurs des paramètres préfixés par <code>@</code> sont protégés par des guillemets.</li>
+ <li> le nombre d'arguments doit être cohérent avec la définition.</li>
+ <li> toutes les occurences des paramètres sont substituées par leur valeur.</li>
+ <li> en cas de conflit, le nom le plus long est choisi.</li>
+ <li> une récursion dans l'expansion d'une macro est détectée et interrompue avec envoi d'un message d'erreur.</li>
+ <li> si un argument vide est détecté, un avertissement est généré.</li>
+ <li> le système s'efforce de générer une description précise de la localisation des erreurs.</li>
+ <li> les valeurs des paramètres préfixées par <code>$</code> et <code>%</code> ne sont pas échappées.</li>
+ <li> les valeurs des paramètres préfixées par <code>@</code> sont échappées par des guillemets.</li>
</ul>
- <p>Effacement de la définition d'une macro :</p>
+ <p>Suppression de la définition d'une macro :</p>
<ul>
- <li> la macro effacée doit avoir été définie auparavant.</li>
+ <li> la macro supprimée doit avoir été définie auparavant.</li>
</ul>
<highlight language="config">
@@ -106,6 +107,41 @@ UndefMacro DirGroup
</highlight>
</section>
+<section id="examples"><title>Exemples</title>
+
+<p>Un exemple typique d'utilisation de <module>mod_macro</module> est la
+création dynamique de serveurs virtuels.</p>
+
+<highlight language="config">
+## Définition d'une macro VHost pour les configurations répétitives
+
+<Macro VHost $host $port $dir>
+ Listen $port
+ <VirtualHost *:$port>
+
+ ServerName $host
+ DocumentRoot $dir
+
+ <Directory $dir>
+ # directives propres au répertoire $dir ...
+ </Directory>
+
+ # restriction d'accès au sous-répertoire intranet.
+ <Directory $dir/intranet>
+ Require ip 10.0.0.0/8
+ </Directory>
+ </VirtualHost>
+</Macro>
+
+## Utilisation de la macro VHost avec différents arguments.
+
+Use VHost www.apache.org 80 /vhosts/apache/htdocs
+Use VHost example.org 8080 /vhosts/example/htdocs
+Use VHost www.example.fr 1234 /vhosts/example.fr/htdocs
+</highlight>
+
+</section>
+
<!-- Macro -->
<directivesynopsis type="section">
<name>Macro</name>
@@ -120,24 +156,21 @@ UndefMacro DirGroup
</contextlist>
<usage>
- <p>La diretive <directive>Macro</directive> permet de définir une macro
+ <p>La directive <directive>Macro</directive> permet de définir une macro
dans un fichier de configuration Apache. Le premier argument est le nom
- de la macro, et les arguments suivants sont les noms des paramètres. Il
+ de la macro, et les arguments suivants sont les paramètres. Il
est de bon aloi de préfixer les noms des paramètres d'une macro
- avec un caractère parmi '<code>$%@</code>'.
+ avec un caractère parmi '<code>$%@</code>', et d'éviter d'en faire
+ de même avec les noms de macros.
</p>
<highlight language="config">
<Macro LocalAccessPolicy>
- order deny,allow
- deny from all
- allow from 10.2.16.0/24
+ Require ip 10.2.16.0/24
</Macro>
<Macro RestrictedAccessPolicy $ipnumbers>
- order deny,allow
- deny from all
- allow from $ipnumbers
+ Require ip $ipnumbers
</Macro>
</highlight>
</usage>
@@ -146,7 +179,7 @@ UndefMacro DirGroup
<!-- Use -->
<directivesynopsis>
<name>Use</name>
-<description>Utilise une macro</description>
+<description>Utilisation d'une macro</description>
<syntax>Use <var>nom</var> [<var>valeur1</var> ... <var>valeurN</var>]
</syntax>
<contextlist>
@@ -157,9 +190,10 @@ UndefMacro DirGroup
<usage>
<p> La directive <directive>Use</directive> permet d'utiliser une macro.
- La macro est expansée. Elle doit avoir le même nombre d'argument que le
+ La macro considérée est expansée. Son nombre d'arguments doit être égal au
nombre de paramètres précisés dans sa définition. Les valeurs passées en
- argument sont substituées avant l'interprétation du texte de la macro.</p>
+ argument sont attribuées aux paramètres correspondants et
+ substituées avant l'interprétation du texte de la macro.</p>
<highlight language="config">
Use LocalAccessPolicy
@@ -167,16 +201,12 @@ Use LocalAccessPolicy
Use RestrictedAccessPolicy "192.54.172.0/24 192.54.148.0/24"
</highlight>
- <p>est équivalent, avec les macros définies au dessus, à :</p>
+ <p>est équivalent, avec les macros définies ci-dessus à :</p>
<highlight language="config">
-order deny,allow
-deny from all
-allow from 10.2.16.0/24
+Require ip 10.2.16.0/24
...
-order deny,allow
-deny from all
-allow from 192.54.172.0/24 192.54.148.0/24
+Require ip 192.54.172.0/24 192.54.148.0/24
</highlight>
</usage>
</directivesynopsis>
@@ -184,7 +214,7 @@ allow from 192.54.172.0/24 192.54.148.0/
<!-- UndefMacro -->
<directivesynopsis>
<name>undefMacro</name>
-<description>Efface une macro</description>
+<description>Supprime une macro</description>
<syntax>UndefMacro <var>nom</var></syntax>
<contextlist>
@@ -194,8 +224,8 @@ allow from 192.54.172.0/24 192.54.148.0/
</contextlist>
<usage>
- <p>La directive <directive>UndefMacro</directive> efface la définition
- d'une macro, qui doit avoir été définie auparavant.</p>
+ <p>La directive <directive>UndefMacro</directive> annule la définition
+ d'une macro qui doit avoir été définie auparavant.</p>
<highlight language="config">
UndefMacro LocalAccessPolicy