summaryrefslogtreecommitdiffstats
path: root/docs/manual
diff options
context:
space:
mode:
authorLucien Gentis <lgentis@apache.org>2012-04-28 17:38:31 +0200
committerLucien Gentis <lgentis@apache.org>2012-04-28 17:38:31 +0200
commit3f39775121c3d1741f1b2af148b32f64a757c1d4 (patch)
tree29c60ad4b77333daca474e829d3c13ea310d29d0 /docs/manual
parentFix a word jumble (diff)
downloadapache2-3f39775121c3d1741f1b2af148b32f64a757c1d4.tar.xz
apache2-3f39775121c3d1741f1b2af148b32f64a757c1d4.zip
Updates.
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1331786 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'docs/manual')
-rw-r--r--docs/manual/howto/auth.xml.fr170
-rw-r--r--docs/manual/howto/cgi.xml.fr62
-rw-r--r--docs/manual/howto/htaccess.xml.fr90
-rw-r--r--docs/manual/howto/public_html.xml.fr42
-rw-r--r--docs/manual/howto/ssi.xml.fr18
-rw-r--r--docs/manual/mod/mod_asis.xml.fr4
-rw-r--r--docs/manual/mod/mod_cache_disk.xml.fr22
-rw-r--r--docs/manual/mod/mod_lua.xml.fr64
-rw-r--r--docs/manual/mod/mod_setenvif.xml.fr79
9 files changed, 252 insertions, 299 deletions
diff --git a/docs/manual/howto/auth.xml.fr b/docs/manual/howto/auth.xml.fr
index 6fc4bc0b19..06b69724b9 100644
--- a/docs/manual/howto/auth.xml.fr
+++ b/docs/manual/howto/auth.xml.fr
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="ISO-8859-1" ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1328337:1331425 (outdated) -->
+<!-- English Revision : 1331425 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviwed by : Vincent Deffontaines -->
@@ -135,9 +135,7 @@ module de chaque groupe.</p>
d'une directive <directive module="core">AllowOverride</directive>
du style :</p>
- <example>
- AllowOverride AuthConfig
- </example>
+ <highlight language="config">AllowOverride AuthConfig</highlight>
<p>Si vous avez l'intention d'ajouter les directives directement
dans le fichier de configuration principal, vous devrez bien entendu
@@ -213,14 +211,14 @@ module de chaque groupe.</p>
fichier <code>httpd.conf</code> &agrave; l'int&eacute;rieur d'une section &lt;Directory
/usr/local/apache/htdocs/secret&gt; :</p>
- <example>
- AuthType Basic<br />
- AuthName "Fichiers r&eacute;serv&eacute;s"<br />
- # (La ligne suivante est facultative)<br />
- AuthBasicProvider file<br />
- AuthUserFile /usr/local/apache/passwd/passwords<br />
- Require user rbowen
- </example>
+ <highlight language="config">
+AuthType Basic
+AuthName "Restricted Files"
+# (Following line optional)
+AuthBasicProvider file
+AuthUserFile /usr/local/apache/passwd/passwords
+Require user rbowen
+ </highlight>
<p>Examinons ces directives une &agrave; une. La directive <directive
module="mod_authn_core">AuthType</directive> d&eacute;finit la m&eacute;thode
@@ -325,15 +323,15 @@ plusieurs personnes</title>
<p>Maintenant, vous devez modifier votre fichier
<code>.htaccess</code> comme suit :</p>
- <example>
- AuthType Basic<br />
- AuthName "By Invitation Only"<br />
- # Ligne facultative :<br />
- AuthBasicProvider file<br />
- AuthUserFile /usr/local/apache/passwd/passwords<br />
- AuthGroupFile /usr/local/apache/passwd/groups<br />
- Require group Nom-de-groupe
- </example>
+ <highlight language="config">
+AuthType Basic
+AuthName "By Invitation Only"
+# Optional line:
+AuthBasicProvider file
+AuthUserFile /usr/local/apache/passwd/passwords
+AuthGroupFile /usr/local/apache/passwd/groups
+Require group GroupName
+ </highlight>
<p>Maintenant, quiconque appartient au groupe
<code>Nom-de-groupe</code>, et poss&egrave;de une entr&eacute;e dans le fichier
@@ -344,9 +342,7 @@ plusieurs personnes</title>
l'acc&egrave;s &agrave; plusieurs personnes. Plut&ocirc;t que de cr&eacute;er un fichier de
groupes, il vous suffit d'ajouter la directive suivante :</p>
- <example>
- Require valid-user
- </example>
+ <highlight language="config">Require valid-user</highlight>
<p>Le remplacement de la ligne <code>Require user rbowen</code> par
la ligne <code>Require valid-user</code> autorisera l'acc&egrave;s &agrave;
@@ -399,17 +395,15 @@ passe</title>
<p>Par exemple, pour s&eacute;lectionner un fichier dbm &agrave; la place d'un
fichier texte :</p>
- <example>
- &lt;Directory /www/docs/private&gt;<br />
- <indent>
- AuthName "Private"<br />
- AuthType Basic<br />
- AuthBasicProvider dbm<br />
- AuthDBMUserFile /www/passwords/passwd.dbm<br />
- Require valid-user<br />
- </indent>
- &lt;/Directory&gt;
- </example>
+ <highlight language="config">
+&lt;Directory /www/docs/private&gt;
+ AuthName "Private"
+ AuthType Basic
+ AuthBasicProvider dbm
+ AuthDBMUserFile /www/passwords/passwd.dbm
+ Require valid-user
+&lt;/Directory&gt;
+ </highlight>
<p>D'autres options sont disponibles. Consultez la documentation de
<module>mod_authn_dbm</module> pour plus de d&eacute;tails.</p>
@@ -427,18 +421,16 @@ d'authentification</title>
conjointement les fournisseurs d'authentification
file et LDAP :</p>
- <example>
- &lt;Directory /www/docs/private&gt;<br />
- <indent>
- AuthName "Private"<br />
- AuthType Basic<br />
- AuthBasicProvider file ldap<br />
- AuthUserFile /usr/local/apache/passwd/passwords<br />
- AuthLDAPURL ldap://ldaphost/o=yourorg<br />
- Require valid-user<br />
- </indent>
- &lt;/Directory&gt;
- </example>
+ <highlight language="config">
+&lt;Directory /www/docs/private&gt;
+ AuthName "Private"
+ AuthType Basic
+ AuthBasicProvider file ldap
+ AuthUserFile /usr/local/apache/passwd/passwords
+ AuthLDAPURL ldap://ldaphost/o=yourorg
+ Require valid-user
+&lt;/Directory&gt;
+ </highlight>
<p>Dans cet exemple, le fournisseur file va tenter d'authentifier
l'utilisateur en premier. S'il n'y parvient pas, le fournisseur LDAP
@@ -456,20 +448,18 @@ d'authentification</title>
autorisation &agrave; base de fichier de groupes et une autorisation &agrave; base
de groupes LDAP.</p>
- <example>
- &lt;Directory /www/docs/private&gt;<br />
- <indent>
- AuthName "Private"<br />
- AuthType Basic<br />
- AuthBasicProvider file<br />
- AuthUserFile /usr/local/apache/passwd/passwords<br />
+ <highlight language="config">
+&lt;Directory /www/docs/private&gt;
+ AuthName "Private"
+ AuthType Basic
+ AuthBasicProvider file
+ AuthUserFile /usr/local/apache/passwd/passwords
AuthLDAPURL ldap://ldaphost/o=yourorg
- AuthGroupFile /usr/local/apache/passwd/groups<br />
- Require group GroupName<br />
- Require ldap-group cn=mygroup,o=yourorg<br />
- </indent>
- &lt;/Directory&gt;
- </example>
+ AuthGroupFile /usr/local/apache/passwd/groups
+ Require group GroupName
+ Require ldap-group cn=mygroup,o=yourorg
+&lt;/Directory&gt;
+ </highlight>
<p>Pour un sc&eacute;nario d'autorisation un peu plus avanc&eacute;, des
directives de conteneur d'autorisation comme <directive
@@ -562,16 +552,12 @@ autorisation</title>
seront appel&eacute;s dans le processus d'autorisation au cours du
traitement de la requ&ecirc;te. Par exemple :</p>
- <example>
- Require ip <var>adresse</var>
- </example>
+ <highlight language="config">Require ip <var>address</var></highlight>
<p>o&ugrave; <var>adresse</var> est une adresse IP (ou une adresse IP
partielle) ou :</p>
- <example>
- Require host <var>nom_domaine</var>
- </example>
+ <highlight language="config">Require host <var>domain_name</var></highlight>
<p>o&ugrave; <var>nom_domaine</var> est un nom de domaine enti&egrave;rement
qualif&eacute; (ou un nom de domaine partiel) ; vous pouvez indiquer
@@ -580,47 +566,39 @@ autorisation</title>
<p>Par exemple, si vous voulez rejeter les spams dont une
machine vous inonde, vous pouvez utiliser ceci :</p>
- <example>
- &lt;RequireAll&gt;
- <indent>
- Require all granted<br/>
- Require not ip 10.252.46.165
- </indent>
- &lt;/RequireAll&gt;
- </example>
+ <highlight language="config">
+&lt;RequireAll&gt;
+ Require all granted
+ Require not ip 10.252.46.165
+&lt;/RequireAll&gt;
+ </highlight>
<p>Ainsi, les visiteurs en provenance de cette adresse ne
pourront pas voir le contenu concern&eacute; par cette directive. Si,
par contre, vous connaissez le nom de la machine, vous pouvez
utiliser ceci :</p>
- <example>
- &lt;RequireAll&gt;
- <indent>
- Require all granted<br/>
- Require not host <var>serveur.example.com</var>
- </indent>
- &lt;/RequireAll&gt;
- </example>
+ <highlight language="config">
+&lt;RequireAll&gt;
+ Require all granted
+ Require not host host.example.com
+&lt;/RequireAll&gt;
+ </highlight>
<p>Et si vous voulez interdire l'acc&egrave;s &agrave; toutes les machines
d'un domaine, vous pouvez sp&eacute;cifier une partie seulement de
l'adresse ou du nom de domaine :</p>
- <example>
- &lt;RequireAll&gt;
- <indent>
- Require all granted<br/>
- &lt;RequireNone&gt;
- <indent>
- Require ip 192.168.205<br />
- Require host phishers.example.com autres-idiots.exemple<br />
- Require host ke
- </indent>
- &lt;/RequireNone&gt;
- </indent>
- &lt;/RequireAll&gt;
- </example>
+ <highlight language="config">
+&lt;RequireAll&gt;
+ Require all granted
+ &lt;RequireNone&gt;
+ Require ip 192.168.205
+ Require host phishers.example.com moreidiots.example
+ Require host ke
+ &lt;/RequireNone&gt;
+&lt;/RequireAll&gt;
+ </highlight>
<p>Dans l'exemple ci-dessus, on utilise la directive du
conteneur <directive module="mod_authz_core"
diff --git a/docs/manual/howto/cgi.xml.fr b/docs/manual/howto/cgi.xml.fr
index efa717f364..bb9a918e8c 100644
--- a/docs/manual/howto/cgi.xml.fr
+++ b/docs/manual/howto/cgi.xml.fr
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="ISO-8859-1" ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1174747:1331576 (outdated) -->
+<!-- English Revision : 1331576 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -67,9 +67,9 @@
comment&eacute;e dans votre <code>httpd.conf</code>. Une directive correcte
doit ressembler &agrave; ceci :
- <example>
+ <highlight language="config">
LoadModule cgi_module modules/mod_cgi.so
- </example></note>
+ </highlight></note>
<section id="scriptalias">
<title>ScriptAlias</title>
@@ -85,9 +85,9 @@
module="mod_alias">ScriptAlias</directive> se pr&eacute;sente comme suit
:</p>
- <example>
+ <highlight language="config">
ScriptAlias /cgi-bin/ /usr/local/apache2/cgi-bin/
- </example>
+ </highlight>
<p>Cet exemple est tir&eacute; de votre fichier de configuration
<code>httpd.conf</code> par d&eacute;faut, si vous avez install&eacute; Apache
@@ -158,13 +158,11 @@
l'ex&eacute;cution des programmes CGI est permise depuis un r&eacute;pertoire
particulier :</p>
- <example>
- &lt;Directory /usr/local/apache2/htdocs/un-repertoire&gt;<br />
- <indent>
- Options +ExecCGI<br />
- </indent>
- &lt;/Directory&gt;
- </example>
+ <highlight language="config">
+&lt;Directory /usr/local/apache2/htdocs/somedir&gt;
+ Options +ExecCGI
+&lt;/Directory&gt;
+ </highlight>
<p>La directive ci-dessus indique &agrave; Apache qu'il doit permettre
l'ex&eacute;cution des fichiers CGI. Vous devez aussi indiquer au serveur
@@ -174,9 +172,9 @@
extension <code>cgi</code> ou <code>pl</code> en tant que
programmes CGI :</p>
- <example>
+ <highlight language="config">
AddHandler cgi-script .cgi .pl
- </example>
+ </highlight>
</section>
<section id="htaccess">
@@ -196,27 +194,23 @@
r&eacute;pertoire utilisateur, vous pouvez utiliser la configuration
suivante :</p>
- <example>
- &lt;Directory /home/*/public_html&gt;<br/>
- <indent>
- Options +ExecCGI<br/>
- AddHandler cgi-script .cgi<br/>
- </indent>
- &lt;/Directory&gt;
- </example>
+ <highlight language="config">
+&lt;Directory /home/*/public_html&gt;
+ Options +ExecCGI
+ AddHandler cgi-script .cgi
+&lt;/Directory&gt;
+ </highlight>
<p>Pour indiquer un sous-r&eacute;pertoire <code>cgi-bin</code> d'un
r&eacute;pertoire utilisateur o&ugrave; tout fichier sera trait&eacute; en tant que
programme CGI, vous pouvez utiliser ceci :</p>
- <example>
- &lt;Directory /home/*/public_html/cgi-bin&gt;<br/>
- <indent>
- Options ExecCGI<br/>
- SetHandler cgi-script<br/>
- </indent>
- &lt;/Directory&gt;
- </example>
+ <highlight language="config">
+&lt;Directory /home/*/public_html/cgi-bin&gt;
+ Options ExecCGI
+ SetHandler cgi-script
+&lt;/Directory&gt;
+ </highlight>
</section>
@@ -258,7 +252,7 @@
<highlight language="perl">
#!/usr/bin/perl
print "Content-type: text/html\n\n";
-print "Bonjour tout le monde . . .";
+print "Hello, World.";
</highlight>
<p>M&ecirc;me si Perl ne vous est pas familier, vous devriez &ecirc;tre
@@ -374,9 +368,9 @@ print "Bonjour tout le monde . . .";
trouve &agrave; la premi&egrave;re ligne de votre programme CGI et qui va
ressembler &agrave; ceci :</p>
- <example>
+ <highlight language="perl">
#!/usr/bin/perl
- </example>
+ </highlight>
<p>Assurez-vous qu'il s'agit bien du chemin correct vers
l'interpr&eacute;teur.</p>
@@ -535,7 +529,7 @@ print "Bonjour tout le monde . . .";
#!/usr/bin/perl
print "Content-type: text/html\n\n";
foreach $key (keys %ENV) {
- print "$key --&gt; $ENV{$key}&lt;br&gt;";
+ print "$key --&gt; $ENV{$key}&lt;br&gt;";
}
</highlight>
</section>
diff --git a/docs/manual/howto/htaccess.xml.fr b/docs/manual/howto/htaccess.xml.fr
index c0959216fa..7a49d5f0e8 100644
--- a/docs/manual/howto/htaccess.xml.fr
+++ b/docs/manual/howto/htaccess.xml.fr
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="ISO-8859-1" ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1326216:1330277 (outdated) -->
+<!-- English Revision : 1330277 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -86,9 +86,9 @@ modifier la configuration du serveur au niveau de chaque r&eacute;pertoire.</p>
<code>.config</code>, vous pouvez mettre ceci dans le fichier de
configuration de votre serveur :</p>
- <example>
+ <highlight language="config">
AccessFileName .config
- </example>
+ </highlight>
</note>
<p>En g&eacute;n&eacute;ral, les fichiers <code>.htaccess</code> utilisent la m&ecirc;me
@@ -238,16 +238,16 @@ modifier la configuration du serveur au niveau de chaque r&eacute;pertoire.</p>
<example><title>Contenu du fichier .htaccess dans
<code>/www/htdocs/exemple</code></title>
- AddType text/exemple .exm
+ <highlight language="config">AddType text/example .exm</highlight>
</example>
<example><title>Section de votre fichier
<code>httpd.conf</code></title>
- &lt;Directory /www/htdocs/exemple&gt;<br />
- <indent>
- AddType text/exemple .exm<br />
- </indent>
- &lt;/Directory&gt;
+ <highlight language="config">
+&lt;Directory /www/htdocs/example&gt;<br />
+ AddType text/example .exm<br />
+&lt;/Directory&gt;
+ </highlight>
</example>
<p>Cependant, la perte de performances sera moindre si vous
@@ -260,9 +260,7 @@ modifier la configuration du serveur au niveau de chaque r&eacute;pertoire.</p>
enti&egrave;rement d&eacute;sactiv&eacute;e en d&eacute;finissant la directive <directive
module="core">AllowOverride</directive> &agrave; <code>none</code> :</p>
- <example>
- AllowOverride None
- </example>
+ <highlight language="config">AllowOverride None</highlight>
</section>
<section id="how"><title>Comment sont appliqu&eacute;es les directives ?</title>
@@ -287,9 +285,7 @@ modifier la configuration du serveur au niveau de chaque r&eacute;pertoire.</p>
<p>Dans le r&eacute;pertoire <code>/www/htdocs/exemple1</code> se trouve un
fichier <code>.htaccess</code> contenant ce qui suit :</p>
- <example>
- Options +ExecCGI
- </example>
+ <highlight language="config">Options +ExecCGI</highlight>
<p>Note : "<code>AllowOverride Options</code>" doit &ecirc;tre pr&eacute;sent
pour permettre l'utilisation de la directive "<directive
@@ -300,9 +296,7 @@ modifier la configuration du serveur au niveau de chaque r&eacute;pertoire.</p>
trouve un fichier <code>.htaccess</code> contenant ce qui suit
:</p>
- <example>
- Options Includes
- </example>
+ <highlight language="config">Options Includes</highlight>
<p>Ainsi, &agrave; cause de ce second fichier <code>.htaccess</code> du
r&eacute;pertoire <code>/www/htdocs/exemple1/exemple2</code>, l'ex&eacute;cution
@@ -327,19 +321,15 @@ modifier la configuration du serveur au niveau de chaque r&eacute;pertoire.</p>
d&eacute;finition de toute autre option dans les fichiers
<code>.htaccess</code>, vous pouvez utiliser :</p>
- <example>
-&lt;Directory /www/htdocs&gt;<br />
-<indent>
-Allowoverride All<br />
-</indent>
-&lt;/Directory&gt;<br />
-<br />
-&lt;Location /&gt;<br />
-<indent>
-Options +IncludesNoExec -ExecCGI<br />
-</indent>
+ <highlight language="config">
+&lt;Directory /www/htdocs&gt;
+ Allowoverride All
+&lt;/Directory&gt;
+
+&lt;Location /&gt;
+ Options +IncludesNoExec -ExecCGI<br />
&lt;/Location&gt;
- </example>
+ </highlight>
<note>Dans cet exemple, on consid&egrave;re que le chemin d&eacute;fini par la
directive <directive module="core">DocumentRoot</directive> est
@@ -370,13 +360,13 @@ Options +IncludesNoExec -ExecCGI<br />
<p>Contenu du fichier <code>.htaccess</code> :</p>
- <example>
- AuthType Basic<br />
- AuthName "Password Required"<br />
- AuthUserFile /www/passwords/password.file<br />
- AuthGroupFile /www/passwords/group.file<br />
- Require Group admins
- </example>
+ <highlight language="config">
+AuthType Basic
+AuthName "Password Required"
+AuthUserFile /www/passwords/password.file
+AuthGroupFile /www/passwords/group.file
+Require Group admins
+ </highlight>
<p>Notez que <code>AllowOverride AuthConfig</code> doit &ecirc;tre pr&eacute;sent
pour que ces directives produisent leur effet.</p>
@@ -395,11 +385,11 @@ Includes - SSI)</title>
plac&eacute;es dans un fichier <code>.htaccess</code> enregistr&eacute; dans le
r&eacute;pertoire consid&eacute;r&eacute; :</p>
- <example>
- Options +Includes<br />
- AddType text/html shtml<br />
- AddHandler server-parsed shtml
- </example>
+ <highlight language="config">
+Options +Includes
+AddType text/html shtml
+AddHandler server-parsed shtml
+ </highlight>
<p>Notez que <code>AllowOverride Options</code> et <code>AllowOverride
FileInfo</code> doivent &ecirc;tre tous les deux pr&eacute;sents pour que ces
@@ -416,19 +406,19 @@ Includes - SSI)</title>
dans un r&eacute;pertoire particulier. Pour y parvenir, vous pouvez
utiliser la configuration suivante :</p>
- <example>
- Options +ExecCGI<br />
- AddHandler cgi-script cgi pl
- </example>
+ <highlight language="config">
+Options +ExecCGI
+AddHandler cgi-script cgi pl
+ </highlight>
<p>Alternativement, si vous souhaitez que tous les fichiers d'un
r&eacute;pertoire donn&eacute; soient consid&eacute;r&eacute;s comme des programmes CGI, vous
pouvez utiliser la configuration suivante :</p>
- <example>
- Options +ExecCGI<br />
- SetHandler cgi-script
- </example>
+ <highlight language="config">
+Options +ExecCGI
+SetHandler cgi-script
+ </highlight>
<p>Notez que <code>AllowOverride Options</code> et <code>AllowOverride
FileInfo</code> doivent &ecirc;tre tous les deux pr&eacute;sents pour que ces
diff --git a/docs/manual/howto/public_html.xml.fr b/docs/manual/howto/public_html.xml.fr
index 88b3f33a15..c1735fee73 100644
--- a/docs/manual/howto/public_html.xml.fr
+++ b/docs/manual/howto/public_html.xml.fr
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="ISO-8859-1" ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1174747:1330277 (outdated) -->
+<!-- English Revision : 1330277 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -77,9 +77,7 @@ avec le syst&egrave;me de fichiers</a></seealso>
interpr&eacute;t&eacute; comme chemin relatif au r&eacute;pertoire home de l'utilisateur
consid&eacute;r&eacute;. Par exemple, avec cette configuration :</p>
- <example>
- UserDir public_html
- </example>
+ <highlight language="config">UserDir public_html</highlight>
<p>l'URL <code>http://example.com/~rbowen/fichier.html</code>
correspondra au chemin fichier
@@ -89,9 +87,7 @@ avec le syst&egrave;me de fichiers</a></seealso>
sera construit en utilisant ce chemin, suivi du nom de l'utilisateur
consid&eacute;r&eacute;. Par exemple, avec cette configuration :</p>
- <example>
- UserDir /var/html
- </example>
+ <highlight language="config">UserDir /var/html</highlight>
<p>l'URL <code>http://example.com/~rbowen/fichier.html</code>
correspondra au chemin fichier
@@ -101,9 +97,7 @@ avec le syst&egrave;me de fichiers</a></seealso>
remplac&eacute; par le nom de l'utilisateur dans le chemin du fichier
correspondant. Par exemple, avec cette configuration :</p>
- <example>
- UserDir /var/www/*/docs
- </example>
+ <highlight language="config">UserDir /var/www/*/docs</highlight>
<p>l'URL <code>http://example.com/~rbowen/fichier.html</code>
correspondra au chemin fichier
@@ -112,9 +106,7 @@ avec le syst&egrave;me de fichiers</a></seealso>
<p>On peut aussi d&eacute;finir plusieurs r&eacute;pertoires ou chemins de
r&eacute;pertoires.</p>
- <example>
- UserDir public_html /var/html
- </example>
+ <highlight language="config">UserDir public_html /var/html</highlight>
<p>Avec l'URL <code>http://example.com/~rbowen/fichier.html</code>,
Apache va rechercher <code>~rbowen</code>. S'il ne le trouve pas,
@@ -130,9 +122,7 @@ avec le syst&egrave;me de fichiers</a></seealso>
module="mod_userdir">UserDir</directive> pour rediriger les requ&ecirc;tes
relatives aux r&eacute;pertoires utilisateurs vers des URLs externes.</p>
- <example>
- UserDir http://exemple.org/users/*/
- </example>
+ <highlight language="config">UserDir http://example.org/users/*/</highlight>
<p>L'exemple ci-dessus va rediriger une requ&ecirc;te pour
<code>http://example.com/~bob/abc.html</code> vers
@@ -147,9 +137,7 @@ avec le syst&egrave;me de fichiers</a></seealso>
vous pouvez d&eacute;finir quels utilisateurs sont autoris&eacute;s &agrave; utiliser
cette fonctionnalit&eacute; :</p>
- <example>
- UserDir disabled root jro fish
- </example>
+ <highlight language="config">UserDir disabled root jro fish</highlight>
<p>La configuration ci-dessus va autoriser l'utilisation de la
fonctionnalit&eacute; pour tous les utilisateurs, &agrave; l'exception de ceux
@@ -158,10 +146,10 @@ avec le syst&egrave;me de fichiers</a></seealso>
utilisateurs sauf certains d'entre eux en utilisant une
configuration du style :</p>
- <example>
+ <highlight language="config">
UserDir disabled<br />
UserDir enabled rbowen krietz
- </example>
+ </highlight>
<p>Vous trouverez d'autres exemples dans la documentation de
<directive module="mod_userdir">UserDir</directive>.</p>
@@ -176,12 +164,12 @@ avec le syst&egrave;me de fichiers</a></seealso>
type="section">Directory</directive> pour activer CGI dans un
sous-r&eacute;pertoire particulier d'un r&eacute;pertoire home utilisateur.</p>
- <example>
- &lt;Directory /home/*/public_html/cgi-bin/&gt;<br />
- Options ExecCGI<br />
- SetHandler cgi-script<br />
- &lt;/Directory&gt;
- </example>
+ <highlight language="config">
+&lt;Directory /home/*/public_html/cgi-bin/&gt;
+ Options ExecCGI
+ SetHandler cgi-script
+&lt;/Directory&gt;
+ </highlight>
<p>Avec la configuration ci-dessus, et en supposant que
<code>UserDir</code> est d&eacute;fini &agrave; <code>public_html</code>, un
diff --git a/docs/manual/howto/ssi.xml.fr b/docs/manual/howto/ssi.xml.fr
index bea6907fa8..4a8ab8fed6 100644
--- a/docs/manual/howto/ssi.xml.fr
+++ b/docs/manual/howto/ssi.xml.fr
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="ISO-8859-1" ?>
<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1174747:1331486 (outdated) -->
+<!-- English Revision : 1331486 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -87,9 +87,9 @@ HTML pr&eacute;existants.</p>
devez ajouter la directive suivante dans votre fichier
<code>httpd.conf</code>, ou dans un fichier <code>.htaccess</code>
:</p>
-<example>
+<highlight language="config">
Options +Includes
-</example>
+</highlight>
<p>Cette directive indique &agrave; Apache que vous d&eacute;sirez permettre la
recherche de directives SSI lors de l'interpr&eacute;tation des fichiers.
@@ -104,10 +104,10 @@ HTML pr&eacute;existants.</p>
directives SSI. Vous devez indiquer &agrave; Apache quels fichiers seront
concern&eacute;s. Vous pouvez y parvenir en indiquant une extension, comme
<code>.shtml</code>, &agrave; l'aide des directives suivantes :</p>
-<example>
+<highlight language="config">
AddType text/html .shtml<br />
AddOutputFilter INCLUDES .shtml
-</example>
+</highlight>
<p>Un des d&eacute;savantages de cette approche r&eacute;side dans le fait que si
vous voulez ajouter des directives SSI &agrave; une page pr&eacute;existante, vous
@@ -118,9 +118,9 @@ HTML pr&eacute;existants.</p>
<p>Une autre m&eacute;thode consiste &agrave; utiliser la directive <directive
module="mod_include">XBitHack</directive> :</p>
-<example>
+<highlight language="config">
XBitHack on
-</example>
+</highlight>
<p>La directive <directive module="mod_include">XBitHack</directive>
indique &agrave; Apache qu'il doit rechercher des directivves SSI dans les
@@ -446,10 +446,10 @@ HTML pr&eacute;existants.</p>
<p>Vous pouvez ajouter les lignes suivantes dans votre fichier de
configuration :</p>
-<example>
+<highlight language="config">
BrowserMatchNoCase macintosh Mac<br />
BrowserMatchNoCase MSIE InternetExplorer
-</example>
+</highlight>
<p>Ces lignes d&eacute;finissent les variables d'environnement "Mac" et
"InternetExplorer" &agrave; true, si le client utilise InternetExplorer sur
diff --git a/docs/manual/mod/mod_asis.xml.fr b/docs/manual/mod/mod_asis.xml.fr
index b9df94bba5..c7763a839f 100644
--- a/docs/manual/mod/mod_asis.xml.fr
+++ b/docs/manual/mod/mod_asis.xml.fr
@@ -1,7 +1,7 @@
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1036315:1330911 (outdated) -->
+<!-- English Revision : 1330911 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -54,7 +54,7 @@ d'Apache httpd</a></seealso>
<p>Dans le fichier de configuration, associez les fichiers asis au
gestionnaire <code>send-as-is</code> comme ceci :</p>
- <example>AddHandler send-as-is asis</example>
+ <highlight language="config">AddHandler send-as-is asis</highlight>
<p>Le contenu de tout fichier poss&eacute;dant l'extension
<code>.asis</code> sera envoy&eacute; par Apache httpd au client pratiquement tel
diff --git a/docs/manual/mod/mod_cache_disk.xml.fr b/docs/manual/mod/mod_cache_disk.xml.fr
index 6c47a26e68..921aebfcac 100644
--- a/docs/manual/mod/mod_cache_disk.xml.fr
+++ b/docs/manual/mod/mod_cache_disk.xml.fr
@@ -1,7 +1,7 @@
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1305167:1330964 (outdated) -->
+<!-- English Revision: 1330964 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -97,9 +97,9 @@ seront stock&eacute;s</description>
d&eacute;finir la structure des sous-r&eacute;pertoires du r&eacute;pertoire racine
sp&eacute;cifi&eacute;.</p>
- <example>
+ <highlight language="config">
CacheRoot c:/cacheroot
- </example>
+ </highlight>
</usage>
</directivesynopsis>
@@ -179,9 +179,9 @@ sous-r&eacute;pertoires</description>
d&eacute;finir la taille minimale d'un document, en octets, pour que
celui-ci puisse faire l'objet d'un stockage dans le cache.</p>
- <example>
+ <highlight language="config">
CacheMinFileSize 64
- </example>
+ </highlight>
</usage>
</directivesynopsis>
@@ -200,9 +200,9 @@ sous-r&eacute;pertoires</description>
d&eacute;finir la taille maximale d'un document, en octets, pour que
celui-ci puisse faire l'objet d'un stockage dans le cache.</p>
- <example>
+ <highlight language="config">
CacheMaxFileSize 64000
- </example>
+ </highlight>
</usage>
</directivesynopsis>
<directivesynopsis>
@@ -232,9 +232,9 @@ mettre en cache avant de les envoyer au client</description>
enregistr&eacute;es dans le cache, et non lorsque les donn&eacute;es sont servies &agrave;
partir du cache.</p>
- <example>
+ <highlight language="config">
CacheReadSize 102400
- </example>
+ </highlight>
</usage>
</directivesynopsis>
@@ -268,9 +268,9 @@ avant d'envoyer les donn&eacute;es au client</description>
que le serveur n'effectue pas une mise en tampon excessive au cas
o&ugrave; les donn&eacute;es arriveraient plus vite que pr&eacute;vu.</p>
- <example>
+ <highlight language="config">
CacheReadTime 1000
- </example>
+ </highlight>
</usage>
</directivesynopsis>
diff --git a/docs/manual/mod/mod_lua.xml.fr b/docs/manual/mod/mod_lua.xml.fr
index ef1d99e75a..4db0a0d5e0 100644
--- a/docs/manual/mod/mod_lua.xml.fr
+++ b/docs/manual/mod/mod_lua.xml.fr
@@ -1,7 +1,7 @@
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1238738:1331691 (outdated) -->
+<!-- English Revision : 1331691 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -58,18 +58,18 @@ jour.</note>
<p>La directive de base pour le chargement du module est</p>
-<example>
+<highlight language="config">
LoadModule lua_module modules/mod_lua.so
-</example>
+</highlight>
<p>
<code>mod_lua</code> fournit un gestionnaire nomm&eacute;
<code>lua-script</code> qui peut &ecirc;tre utilis&eacute; avec une directive
<code>AddHandler</code> :</p>
-<example>
+<highlight language="config">
AddHandler lua-script .lua
-</example>
+</highlight>
<p>
Ceci aura pour effet de faire traiter les requ&ecirc;tes pour les fichiers
@@ -347,28 +347,26 @@ end
<p>La structure request_rec poss&egrave;de (au minimum) les m&eacute;thodes
suivantes :</p>
- <example>
+ <highlight language="lua">
r:addoutputfilter(name|function) -- ajoute un filtre en sortie
- </example>
+ </highlight>
- <example>
- r:parseargs() -- renvoie une table lua contenant les arguments
- de la cha&icirc;ne de param&egrave;tres de la requ&ecirc;te
- </example>
+ <highlight language="lua">
+ r:parseargs() -- returns a lua table containing the request's query string arguments
+ </highlight>
- <example>
- r:parsebody() -- interpr&egrave;te le corps de la requ&ecirc;te en tant que
- m&eacute;thode POST et renvoie une table lua
- </example>
+ <highlight language="lua">
+ r:parsebody() -- parse the request body as a POST and return a lua table
+ </highlight>
- <example>
+ <highlight language="lua">
r:puts("bonjour", " le monde", "!") -- affichage dans le corps de la r&eacute;ponse
- </example>
+ </highlight>
- <example>
+ <highlight language="lua">
r:write("une simple cha&icirc;ne") -- affichage dans le
corps de la r&eacute;ponse
- </example>
+ </highlight>
</dd>
</dl>
@@ -488,16 +486,18 @@ par d&eacute;faut est once</description>
Prenez garde aux probl&egrave;mes de s&eacute;curit&eacute; en &eacute;crivant vos expressions
rationnelles.</p>
<example><title>Exemples :</title>
- LuaMapHandler /(\w+)/(/w+) /scripts/$1.lua handle_$2
+ <highlight language="config">
+ LuaMapHandler /(\w+)/(\w+) /scripts/$1.lua handle_$2
+ </highlight>
</example>
<p>Cette directive va faire correspondre des uri comme
/photos/show?id=9 au fichier /scripts/photos.lua, et invoquera la
fonction de gestionnaire handle_show au niveau de la vm lua
apr&egrave;s chargement de ce fichier.</p>
-<example>
+<highlight language="config">
LuaMapHandler /bingo /scripts/wombat.lua
-</example>
+</highlight>
<p>Cette directive invoquera la fonction "handle" qui est la
valeur par d&eacute;faut si aucun nom de fonction sp&eacute;cifique n'est
sp&eacute;cifi&eacute;.</p>
@@ -517,8 +517,10 @@ par d&eacute;faut est once</description>
que lua. Ceci modifie le package.path dans les vms lua.</p>
<example><title>Exemples :</title>
- LuaPackagePath /scripts/lib/?.lua<br />
- LuaPackagePath /scripts/lib/?/init.lua
+ <highlight language="config">
+LuaPackagePath /scripts/lib/?.lua
+LuaPackagePath /scripts/lib/?/init.lua
+ </highlight>
</example>
</usage>
</directivesynopsis>
@@ -565,9 +567,11 @@ par d&eacute;faut est once</description>
en d&eacute;veloppement.</p>
<example><title>Exemples :</title>
- LuaCodeCache stat<br />
- LuaCodeCache forever<br />
- LuaCodeCache never<br />
+ <highlight language="config">
+LuaCodeCache stat
+LuaCodeCache forever
+LuaCodeCache never
+ </highlight>
</example>
</usage>
@@ -602,11 +606,11 @@ version 2.3.15 du serveur HTTP Apache.</compatibility>
<p>Exemple :</p>
-<example><pre>
+<highlight language="config">
# httpd.conf
LuaHookTranslateName /scripts/conf/hooks.lua silly_mapper
-</pre></example>
-
+</highlight>
+
<highlight language="lua">
-- /scripts/conf/hooks.lua --
require "apache2"
diff --git a/docs/manual/mod/mod_setenvif.xml.fr b/docs/manual/mod/mod_setenvif.xml.fr
index 945887af51..8a2797d3eb 100644
--- a/docs/manual/mod/mod_setenvif.xml.fr
+++ b/docs/manual/mod/mod_setenvif.xml.fr
@@ -1,7 +1,7 @@
<?xml version="1.0"?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision: 1180828:1331227 (outdated) -->
+<!-- English Revision : 1331227 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
@@ -47,10 +47,10 @@ de caract&eacute;ristiques de la requ&ecirc;te</description>
exemple qui d&eacute;finit netscape si le navigateur est Mozilla et non
MSIE.</p>
-<example>
- BrowserMatch ^Mozilla netscape<br />
- BrowserMatch MSIE !netscape<br />
-</example>
+<highlight language="config">
+BrowserMatch ^Mozilla netscape
+BrowserMatch MSIE !netscape
+</highlight>
</summary>
<seealso><a href="../env.html">Les variables d'environnement et le
@@ -74,17 +74,17 @@ contenu de l'en-t&ecirc;te HTTP User-Agent</description>
d'environnement en fonction du contenu de l'en-t&ecirc;te de requ&ecirc;te HTTP
<code>User-Agent</code>. Les deux lignes suivantes produisent le m&ecirc;me
effet :</p>
-<example>
- BrowserMatchNoCase Robot est_un_robot<br />
- SetEnvIfNoCase User-Agent Robot est_un_robot<br />
-</example>
+<highlight language="config">
+BrowserMatchNoCase Robot is_a_robot
+SetEnvIfNoCase User-Agent Robot is_a_robot
+</highlight>
<p>Quelques exemples suppl&eacute;mentaires :</p>
-<example>
- BrowserMatch ^Mozilla forms jpeg=yes browser=netscape<br />
- BrowserMatch "^Mozilla/[2-3]" tables agif frames javascript<br />
- BrowserMatch MSIE !javascript<br />
-</example>
+<highlight language="config">
+BrowserMatch ^Mozilla forms jpeg=yes browser=netscape
+BrowserMatch "^Mozilla/[2-3]" tables agif frames javascript
+BrowserMatch MSIE !javascript
+</highlight>
</usage>
</directivesynopsis>
@@ -106,20 +106,20 @@ casse</description>
identique sur le plan s&eacute;mantique &agrave; la directive <directive
module="mod_setenvif">BrowserMatch</directive>. Elle permet
cependant une comparaison insensible &agrave; la casse. Par exemple :</p>
-<example>
- BrowserMatchNoCase mac platform=macintosh<br />
- BrowserMatchNoCase win platform=windows<br />
-</example>
+<highlight language="config">
+BrowserMatchNoCase mac platform=macintosh
+BrowserMatchNoCase win platform=windows
+</highlight>
<p>Les directives <directive>BrowserMatch</directive> et
<directive>BrowserMatchNoCase</directive> sont des cas particuliers
des directives <directive module="mod_setenvif">SetEnvIf</directive>
et <directive module="mod_setenvif">SetEnvIfNoCase</directive>.
Ainsi, les deux lignes suivantes produisent le m&ecirc;me effet :</p>
-<example>
- BrowserMatchNoCase Robot est_un_robot<br />
- SetEnvIfNoCase User-Agent Robot est_un_robot<br />
-</example>
+<highlight language="config">
+BrowserMatchNoCase Robot is_a_robot
+SetEnvIfNoCase User-Agent Robot is_a_robot
+</highlight>
</usage>
</directivesynopsis>
@@ -222,18 +222,17 @@ peuvent se pr&eacute;senter sous les formes suivantes :</p>
sous-expressions entre parenth&egrave;ses correspondantes de
<var>regex</var>.</p>
-<example>
-<title>Example:</title>
- SetEnvIf Request_URI "\.gif$" objet_est_une_image=gif<br />
- SetEnvIf Request_URI "\.jpg$" objet_est_une_image=jpg<br />
- SetEnvIf Request_URI "\.xbm$" objet_est_une_image=xbm<br />
- :<br />
- SetEnvIf Referer www\.mon-domaine\.example\.com r&eacute;f&eacute;rant_intra_site<br />
- :<br />
- SetEnvIf objet_est_une_image xbm XBIT_PROCESSING=1<br />
- :<br />
- SetEnvIf ^TS ^[a-z] HAVE_TS<br />
-</example>
+<highlight language="config">
+SetEnvIf Request_URI "\.gif$" object_is_image=gif
+SetEnvIf Request_URI "\.jpg$" object_is_image=jpg
+SetEnvIf Request_URI "\.xbm$" object_is_image=xbm
+
+SetEnvIf Referer www\.mydomain\.example\.com intra_site_referral
+
+SetEnvIf object_is_image xbm XBIT_PROCESSING=1
+
+SetEnvIf ^TS ^[a-z] HAVE_TS
+</highlight>
<p>Les trois premi&egrave;res lignes d&eacute;finissent la variable
d'environnement <code>objet_est_une_image</code> si l'objet de la
@@ -273,9 +272,9 @@ serveur HTTP Apache</a> pour des exemples suppl&eacute;mentaires.
d'environnement <em>env-variable</em> de la m&ecirc;me mani&egrave;re que la
directive <directive>SetEnvIf</directive>.</p>
-<example>
+<highlight language="config">
SetEnvIfExpr "tolower(req('X-Sendfile')) == 'd:\images\very_big.iso')" iso_delivered
-</example>
+</highlight>
<p>Dans cet exemple, la variable d'environnement
<code>iso_delivered</code> est d&eacute;finie chaque fois que notre
@@ -285,9 +284,9 @@ serveur HTTP Apache</a> pour des exemples suppl&eacute;mentaires.
l'adresse IP distante est une adresse priv&eacute;e au sens de la RFC 1918
:</p>
-<example>
+<highlight language="config">
SetEnvIfExpr "-R '10.0.0.0/8' || -R '172.16.0.0/12' || -R '192.168.0.0/16'" rfc1918
-</example>
+</highlight>
</usage>
<seealso><a href="../expr.html">Les expressions dans le serveur HTTP
@@ -316,9 +315,9 @@ attributs de la requ&ecirc;te sans tenir compte de la casse</description>
module="mod_setenvif">SetEnvIf</directive>, et ne s'en distingue que
par le fait que la comparaison des expressions rationnelles est
effectu&eacute;e sans tenir compte de la casse. Par exemple :</p>
-<example>
+<highlight language="config">
SetEnvIfNoCase Host Example\.Org site=apache
-</example>
+</highlight>
<p>Cette ligne va d&eacute;finir la variable d'environnement
<code>site</code> avec la valeur "<code>example</code>" si le champ