]> granicus.if.org Git - apache/blob - docs/manual/mod/mod_proxy_html.xml.fr
Documentation rebuild
[apache] / docs / manual / mod / mod_proxy_html.xml.fr
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
3 <?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
4 <!-- English Revision: 1813997:1825757 (outdated) -->
5 <!-- French translation : Lucien GENTIS -->
6
7 <!--
8  Licensed to the Apache Software Foundation (ASF) under one or more
9  contributor license agreements.  See the NOTICE file distributed with
10  this work for additional information regarding copyright ownership.
11  The ASF licenses this file to You under the Apache License, Version 2.0
12  (the "License"); you may not use this file except in compliance with
13  the License.  You may obtain a copy of the License at
14
15      http://www.apache.org/licenses/LICENSE-2.0
16
17  Unless required by applicable law or agreed to in writing, software
18  distributed under the License is distributed on an "AS IS" BASIS,
19  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
20  See the License for the specific language governing permissions and
21  limitations under the License.
22 -->
23
24 <modulesynopsis metafile="mod_proxy_html.xml.meta">
25
26 <name>mod_proxy_html</name>
27 <description>Réécrit les liens HTML afin de s'assurer qu'ils soient bien
28 adressables depuis les réseaux des clients dans un contexte de
29 mandataire.</description>
30 <status>Base</status>
31 <sourcefile>mod_proxy_html.c</sourcefile>
32 <identifier>proxy_html_module</identifier>
33 <compatibility>Disponible depuis la version 2.4 du serveur HTTP Apache.
34 Disponible en tant que module tiers dans les versions 2.x antérieures</compatibility>
35
36 <summary>
37     <p>Ce module fournit un filtre en sortie permettant de réécrire les
38     liens HTML dans un contexte de mandataire, afin de s'assurer que ces
39     liens fonctionnent pour les utilisateurs en dehors du mandataire. Il
40     accomplit la même tâche que la directive ProxyPassReverse d'Apache
41     accomplit pour les en-têtes HTTP, et fait partie des composants
42     essentiels d'un mandataire inverse.</p>
43
44 <p>Par exemple, si une entreprise possède un serveur d'applications
45 nommé appserver.example.com qui n'est visible que depuis son réseau
46 interne, et un serveur web public <code>www.example.com</code>, il peut
47 être souhaitable de fournir une passerelle vers le serveur d'application
48 à l'adresse <code>http://www.example.com/appserver/</code>. Lorsque le
49 serveur d'applications présente un lien vers lui-même, ce lien doit être
50 réécrit pour fonctionner à travers la passerelle. A cet effet,
51 mod_proxy_html permet de réécrire <code>&lt;a
52 href="http://appserver.example.com/foo/bar.html"&gt;foobar&lt;/a&gt;</code>
53 en <code>&lt;a
54 href="http://www.example.com/appserver/foo/bar.html"&gt;foobar&lt;/a&gt;</code>,
55 ce qui permet de rendre le serveur d'applications accessible depuis
56 l'extérieur.</p>
57
58 <p>mod_proxy_html a été développé à l'origine à Web&#222;ing, dont la <a
59 href="http://apache.webthing.com/mod_proxy_html/">documentation</a>
60 détaillée pourra s'avérer utile aux utilisateurs.</p>
61 </summary>
62
63 <directivesynopsis>
64 <name>ProxyHTMLMeta</name>
65 <description>Active ou désactive une préinterprétation supplémentaire
66 des métadonnées dans les sections HTML <code>&lt;head&gt;</code>.</description>
67 <syntax>ProxyHTMLMeta On|Off</syntax>
68 <default>ProxyHTMLMeta Off</default>
69 <contextlist><context>server config</context>
70 <context>virtual host</context><context>directory</context>
71 </contextlist>
72 <compatibility>Disponible à partir de la version 2.4 du serveur HTTP
73 Apache ; proposé en tant que module tiers dans les versions 2.x
74 précédentes.</compatibility>
75
76 <usage>
77     <p>Cette directive permet d'activer ou désactiver une
78     préinterprétation supplémentaire des métadonnées dans les sections
79     HTML <code>&lt;head&gt;</code>. Si cette préinterprétation n'est pas
80     requise, définissez ProxyHTMLMeta à Off et les performances
81     seront légèrement améliorées. Cependant, elle s'avère parfois
82     nécessaire pour assurer un fonctionnement correct de l'internationalisation.</p>
83     <p>La directive <directive>ProxyHTMLMeta</directive> a deux effets. Le premier et le plus
84     important est la détection des codages de caractères déclarés sous
85     la forme</p>
86     <pre>&lt;meta http-equiv="Content-Type" content="text/html;charset=<var>foo</var>"&gt;</pre>
87     <p>ou, dans le cas d'un document XHTML, sous la forme d'une
88     déclaration XML. Elle n'est pas nécessaire si le jeu de caractères
89     est déclaré explicitement dans un en-tête HTTP (ce qui est
90     préférable) en provenance du serveur d'arrière-plan, ou si le
91     document est en <var>utf-8</var> (unicode) ou un de ses
92     sous-ensembles comme ASCII. Vous pourrez aussi vous en passer
93     lorsque le document utilise une valeur par défaut déclarée via la
94     directive <directive
95     module="mod_xml2enc">xml2EncDefault</directive>, avec le risque de
96     propager une déclaration incorrecte. Une directive
97     <directive module="mod_proxy_html">ProxyHTMLCharsetOut</directive> permettra d'annuler ce
98     risque, mais pourra induire une surcharge de traitement supérieure à
99     celle de ProxyHTMLMeta.</p>
100     <p>Le deuxième effet est l'interprétation de toutes les déclarations
101     <code>&lt;meta http-equiv=...&gt;</code> et leur conversion en
102     en-têtes HTTP, afin de conserver le but original de cette forme
103     de métaélément HTML.</p>
104
105     <note type="warning"><title>Avertissement</title> Compte tenu du fait que la
106     directive ProxyHTMLMeta promeut <strong>tous</strong> les éléments
107     <code>http-equiv</code> au rang d'en-têtes HTTP, il est conseillé de ne
108     l'activer que si vous faites autant confiance au contenu HTML qu'à votre
109     serveur mandataire. Avec cette directive en effet, si ce contenu est géré
110     par des gens malintentionnés, ces derniers seront en mesure d'injecter des
111     en-têtes HTTP arbitraires et peut-être malveillants dans les réponses de
112     votre serveur.  
113     </note>
114 </usage>
115 </directivesynopsis>
116
117 <directivesynopsis>
118 <name>ProxyHTMLEnable</name>
119 <description>Permet d'activer/désactiver le filtre proxy_html.</description>
120 <syntax>ProxyHTMLEnable On|Off</syntax>
121 <default>ProxyHTMLEnable Off</default>
122 <contextlist><context>server config</context>
123 <context>virtual host</context><context>directory</context>
124 </contextlist>
125 <compatibility>Disponible depuis la version 2.4 du serveur HTTP Apache.
126 Disponible en tant que module tiers dans les versions 2.x antérieures.</compatibility>
127
128 <usage>
129     <p>Cette directive est un simple commutateur permettant
130     d'activer/désactiver le filtre proxy_html. Si
131     <module>mod_xml2enc</module> est chargé, elle va aussi activer
132     automatiquement le support de l'internationalisation.</p>
133     <p>Notez que le filtre proxy_html s'agira que si les données sont de
134     type HTML (Content-Type text/html ou application/xhtml+xml), et si
135     elles passent par un mandataire. Vous pouvez passer outre ces
136     contraintes (à vos risques et périls) en définissant la variable
137     d'environnement <var>PROXY_HTML_FORCE</var>.</p>
138 </usage>
139 </directivesynopsis>
140
141 <directivesynopsis>
142 <name>ProxyHTMLURLMap</name>
143 <description>Définit une règle de réécriture des liens HTML</description>
144 <syntax>ProxyHTMLURLMap <var>modèle-source modèle-cible [drapeaux] [cond]</var></syntax>
145 <contextlist><context>server config</context>
146 <context>virtual host</context><context>directory</context>
147 </contextlist>
148 <compatibility>Disponible depuis la version 2.4 du serveur HTTP Apache.
149 Disponible en tant que module tiers dans les versions 2.x antérieures.</compatibility>
150
151 <usage>
152 <p>Il s'agit de la directive la plus importante pour la réécriture des
153 liens HTML. Lors de l'interprétation d'un document, chaque fois qu'un
154 lien correspond à <var>modèle-source</var>, la partie du lien concernée
155 sera réécrite en <var>modèle-cible</var>, en tenant compte des
156 modifications induites par les drapeaux éventuellement spécifiés et par
157 la directive <directive module="mod_proxy_html">ProxyHTMLExtended</directive>.
158 Ne seront considérés comme des liens HTML que les éléments spécifiés via la
159 directive <directive module="mod_proxy_html">ProxyHTMLLinks</directive>.</p>
160
161 <p>Le troisième argument optionnel permet de définir un des drapeaux
162 suivants (les drapeaux sont sensibles à la casse) :</p>
163 <dl>
164 <dt>h</dt>
165 <dd><p>Ignore les liens HTML (les traverse sans les modifier)</p></dd>
166 <dt>e</dt>
167 <dd><p>Ignore les évènements de scripting (les traverse sans les
168 modifier)</p></dd>
169 <dt>c</dt>
170 <dd><p>Traverse les sections de type style ou script sans les modifier.</p></dd>
171
172 <dt>L</dt>
173 <dd><p>Last-match. Si cette règle s'applique, aucune autre règle ne sera
174 prise en compte (notez qu'il s'agit du comportement automatique pour les
175 liens HTML).</p></dd>
176 <dt>l</dt>
177 <dd><p>L'opposé de L. Passe outre le comportement par défaut du
178 changement unique pour les liens HTML.</p></dd>
179 <dt>R</dt>
180 <dd><p>Utilise des expressions rationnelles pour les modèles.
181 <code>modèle-source</code> est une expression rationnelle, et
182 <code>modèle-cible</code> une chaîne de remplacement qui peut être basée
183 elle aussi sur une expression rationnelle. La mémorisation dans les
184 expressions rationnelles est supportée : vous pouvez utiliser des
185 parenthèses () dans le <code>modèle-source</code>, et récupérer la
186 correspondance de leur contenu via les variables $1 à $9 dans le
187 <code>modèle-cible</code>.</p>
188
189 <p>Si le drapeau R n'est pas fourni, la directive utilisera des chaînes
190 littérales pour les différents modèles de recherche/remplacement. La
191 logique de recherche est <em>"commence par"</em> dans les liens HTML, et
192 <em>"contient"</em> dans les évènements de scripting et les sections de
193 type style ou script.
194 </p>
195 </dd>
196 <dt>x</dt>
197 <dd><p>Utilise les expressions rationnelles étendues POSIX. Ne
198 s'applique qu'avec R.</p></dd>
199 <dt>i</dt>
200 <dd><p>Recherche de correspondance sensible à la casse. Ne
201 s'applique qu'avec R.</p></dd>
202
203 <dt>n</dt>
204 <dd><p>Désactive la mémorisation dans les expressions rationnelles (pour
205 améliorer les performances). Ne s'applique qu'avec R.</p></dd>
206 <dt>s</dt>
207 <dd><p>Recherche de correspondance dans les expressions rationnelles
208 basée sur la ligne. Ne s'applique qu'avec R.</p></dd>
209 <dt>^</dt>
210 <dd><p>Recherche de correspondance au début seulement. Ne concerne que
211 les recherches de correspondance par rapport à des chaînes, et ne
212 s'applique pas aux liens HTML.</p></dd>
213 <dt>$</dt>
214 <dd><p>Recherche de correspondance à la fin seulement. Ne concerne que
215 les recherches de correspondance par rapport à des chaînes, et ne
216 s'applique pas aux liens HTML.</p></dd>
217 <dt>V</dt>
218 <dd><p>Insère des variables d'environnement dans le
219 <code>modèle-cible</code>. Un <code>modèle-cible</code> de la forme
220 <code>${varname|default}</code> sera remplacé par la valeur de la
221 variable d'environnement <code>varname</code>. Si cette dernière n'est
222 pas définie, <code>modèle-cible</code> sera remplacé par
223 <code>default</code>. La spécification de <code>|default</code> est
224 facultative.</p>
225 <p>NOTE: l'insertion de variables d'environnement n'est possible que si
226 la directive <directive module="mod_proxy_html">ProxyHTMLInterp</directive> a été définie à
227 <var>On</var>.</p>
228 </dd>
229
230 <dt>v</dt>
231 <dd><p>Insère des variables d'environnement dans le
232 <code>modèle-source</code>. La syntaxe du modèle est identique à la
233 syntaxe précédente.</p>
234 <p>NOTE: l'insertion de variables d'environnement n'est possible que si
235 la directive <directive module="mod_proxy_html">ProxyHTMLInterp</directive> a été définie à
236 <var>On</var>.</p>
237 </dd>
238 </dl>
239
240 <p>Le quatrième argument optionnel <strong>cond</strong> définit une
241 condition qui sera évaluée pour chaque requête, sous réserve que la
242 directive <directive module="mod_proxy_html">ProxyHTMLInterp</directive> ait été définie à
243 <var>On</var>. Si la condition est évaluée à FALSE, la règle ne sera pas
244 appliquée à la requête. Si elle est évaluée à TRUE, ou si aucune
245 condition n'est définie, la règle s'applique.</p>
246 <p>La <strong>condition</strong> est évaluée par l'<a
247 href="../expr.html">interpréteur d'expression</a>. La syntaxe simple des
248 conditions dans mod_proxy_html 3.x pour HTTPD 2.0 et 2.2 est aussi
249 supportée.</p>
250 </usage>
251 </directivesynopsis>
252
253 <directivesynopsis>
254 <name>ProxyHTMLInterp</name>
255 <description>Active la réinterprétation des règles
256 <directive>ProxyHTMLURLMap</directive> pour chaque requête.</description>
257 <syntax>ProxyHTMLInterp On|Off</syntax>
258 <default>ProxyHTMLInterp Off</default>
259 <contextlist><context>server config</context>
260 <context>virtual host</context><context>directory</context>
261 </contextlist>
262 <compatibility>Disponible depuis la version 2.4 du serveur HTTP Apache.
263 Disponible en tant que module tiers dans les versions 2.x antérieures.</compatibility>
264
265 <usage>
266     <p>Cette directive permet d'activer le réinterprétation pour chaque
267     requête des modèles source et cible de la directive
268     <directive module="mod_proxy_html">ProxyHTMLURLMap</directive>.</p>
269     <p>Si la réinterprétation n'est pas activée, toutes les règles sont
270     précompilées au démarrage du serveur. Si elle est activée, les
271     règles doivent être recompilées pour chaque requête, ce qui induit
272     une charge de traitement supplémentaire. Elle ne doit donc être activée que si
273     cela s'avère nécessaire.</p>
274 </usage>
275 </directivesynopsis>
276
277 <directivesynopsis>
278 <name>ProxyHTMLDocType</name>
279 <description>Définit une déclaration de type de document HTML ou XHTML.</description>
280 <syntax>ProxyHTMLDocType HTML|XHTML [Legacy]<br/><strong>OR</strong>
281 <br/>ProxyHTMLDocType <var>fpi</var> [SGML|XML]<br/><strong>OR</strong>
282 <br/>ProxyHTMLDocType html5<br/><strong>OR</strong>
283 <br/>ProxyHTMLDocType auto</syntax>
284 <default>ProxyHTMLDocType auto (2.5/trunk versions); no FPI (2.4.x)</default>
285 <contextlist><context>server config</context>
286 <context>virtual host</context><context>directory</context>
287 </contextlist>
288 <compatibility>Disponible depuis la version 2.4 du serveur HTTP Apache.
289 Disponible en tant que module tiers dans les versions 2.x antérieures.</compatibility>
290
291 <usage>
292 <p>Avec la première syntaxe, les documents seront déclarés de type HTML
293 4.01 ou XHTML 1.0 selon l'option spécifiée. Cette option détermine aussi
294 si la syntaxe utilisée en sortie est HTML ou XHTML. Notez que le format
295 des documents en provenance du serveur d'arrière-plan n'est pas
296 important, car l'interpréteur le détectera automatiquement. Si le
297 second argument optionnel est défini à "Legacy", les documents seront
298 déclarés de type "Transitional" ; cette option peut être nécessaire si
299 vous mandatez du contenu datant d'avant 1998, ou si vous travaillez avec
300 des outils de création/publication déficients.</p>
301 <p>Avec la deuxième syntaxe, cette directive vous permet d'insérer votre
302 propre FPI (Formal Public Identifier). Le second argument optionnel
303 détermine si la syntaxe utilisée sera SGML/HTML ou XML/XHTML.</p>
304 <p>La troisième syntaxe attribue le type HTML 5 aux documents.</p>
305 <p>La quatrième syntaxe est nouvelle dans la branche trunk de HTTPD et
306 n'est pas encore disponible dans les versions stables ; elle utilise
307 l'interpréteur HTML de libxml2 pour déterminer le type de document.</p>
308 <p>Avec la première syntaxe, mod_proxy_html va aussi mettre le code HTML
309 en conformité avec le standard spécifié. Il ne pourra pas corriger
310 toutes les erreurs, mais il va supprimer les éléments et attributs non
311 conformes. Il peut aussi journaliser les autres erreurs si la directive
312 <directive module="core">LogLevel</directive> est définie à
313 Debug.</p>
314 </usage>
315 </directivesynopsis>
316
317 <directivesynopsis>
318 <name>ProxyHTMLFixups</name>
319 <description>Corrige les erreurs HTML simples.</description>
320 <syntax>ProxyHTMLFixups [lowercase] [dospath] [reset]</syntax>
321 <contextlist><context>server config</context>
322 <context>virtual host</context><context>directory</context>
323 </contextlist>
324 <compatibility>Disponible depuis la version 2.4 du serveur HTTP Apache.
325 Disponible en tant que module tiers dans les versions 2.x antérieures.</compatibility>
326 <usage>
327 <p>Cette directive accepte un à trois arguments parmi les suivants :</p>
328 <ul>
329 <li><code>lowercase</code>Les Urls sont réécrites en minuscules</li>
330 <li><code>dospath</code>Les slashes inversés dans les URLs sont
331 remplacés par des slashes directs.</li>
332 <li><code>reset</code>Annule toute option définie à un niveau supérieur
333 dans la configuration</li>
334 </ul>
335 <p>Cette directive doit être utilisée avec prudence. Elle peut corriger
336 certaines erreurs de création, mais risque aussi de modifier par erreur
337 des liens corrects. Ne l'utilisez que si vous êtes sûr que le serveur
338 d'arrière-plan est déficient.</p> 
339 </usage>
340 </directivesynopsis>
341
342 <directivesynopsis>
343 <name>ProxyHTMLExtended</name>
344 <description>Détermine si l'on doit corriger les liens dans les scripts
345 en ligne, les feuilles de style et les évènements de type scripting.</description>
346 <syntax>ProxyHTMLExtended On|Off</syntax>
347 <default>ProxyHTMLExtended Off</default>
348 <contextlist><context>server config</context>
349 <context>virtual host</context><context>directory</context>
350 </contextlist>
351 <compatibility>Disponible depuis la version 2.4 du serveur HTTP Apache.
352 Disponible en tant que module tiers dans les versions 2.x antérieures.</compatibility>
353 <usage>
354 <p>Si cette directive est définie à <code>Off</code>, les liens HTML
355 sont réécrits en fonction des directives
356 <directive module="mod_proxy_html">ProxyHTMLURLMap</directive>, mais les liens qui apparaissent
357 dans le code Javascript et les feuilles de style restent inchangés.</p>
358 <p>Si elle est définie à <code>On</code>, tous les évènements de type
359 scripting (définis par la directive
360 <directive module="mod_proxy_html">ProxyHTMLEvents</directive>) et les scripts inclus ou les
361 feuilles de style sont aussi
362 traités par les règles <directive module="mod_proxy_html">ProxyHTMLURLMap</directive>, en
363 fonction des drapeaux définis pour chacune d'entre elles. Ne définissez
364 cette directive à <code>On</code> qu'en cas de nécessité absolue, car la
365 charge supplémentaire induite impacte les performances.</p>
366 <p>Vous devez aussi prêter attention aux modèles de comparaison, car
367 l'interpréteur n'a aucune notion de la forme que pourrait prendre une URL dans un
368 script embarqué ou une feuille de style. En particulier, la comparaison
369 étendus du caractère <code>/</code> a de fortes chances d'induire des
370 correspondances erronées.</p>
371 </usage>
372 </directivesynopsis>
373
374 <directivesynopsis>
375 <name>ProxyHTMLStripComments</name>
376 <description>Détermine si les commentaires HTML doivent être supprimés.</description>
377 <syntax>ProxyHTMLStripComments On|Off</syntax>
378 <default>ProxyHTMLStripComments Off</default>
379 <contextlist><context>server config</context>
380 <context>virtual host</context><context>directory</context>
381 </contextlist>
382 <compatibility>Disponible depuis la version 2.4 du serveur HTTP Apache.
383 Disponible en tant que module tiers dans les versions 2.x antérieures.</compatibility>
384 <usage>
385 <p>Si cette directive est définie à <code>On</code>, mod_proxy_html
386 supprimera les commentaires HTML. Notez que cela supprimera aussi tout
387 script ou style inclus dans les commentaires (une monstruosité
388 introduite en 1995/1996 avec Netscape 2 pour les navigateurs plus
389 anciens, et encore utilisée de nos jours). Cette directive peut aussi
390 interférer avec des processeurs basés sur les commentaires comme SSI ou
391 ESI : assurez-vous d'exécuter ces derniers <em>avant</em> mod_proxy_html
392 dans la chaîne de filtrage si vous supprimez les commentaires !</p>
393 </usage>
394 </directivesynopsis>
395
396 <directivesynopsis>
397 <name>ProxyHTMLBufSize</name>
398 <description>Définit l'incrément de la taille du tampon, ainsi que sa
399 taille initiale, pour la mise en
400 tampon des scripts en ligne et des feuilles de style.</description>
401 <syntax>ProxyHTMLBufSize <var>nb-octets</var></syntax>
402 <contextlist><context>server config</context>
403 <context>virtual host</context><context>directory</context>
404 </contextlist>
405 <compatibility>Disponible depuis la version 2.4 du serveur HTTP Apache.
406 Disponible en tant que module tiers dans les versions 2.x antérieures.</compatibility>
407 <usage>
408 <p>Pour pouvoir interpréter du contenu non HTML (feuilles de style et
409 scripts) embarqué dans des documents HTML, mod_proxy_html doit le lire
410 et le mémoriser en entier dans un
411 tampon. Ce tampon devra être étendu autant que nécessaire afin de
412 pouvoir accueillir le plus grand script ou la plus grande feuille de
413 style de la page, selon un incrément de <var>nb-octets</var> que cette
414 directive permet de définir.</p>
415 <p>La valeur par défaut est 8192 et sera suffisante pour la plupart des
416 pages. Cependant, si vous savez que vous allez mandater des
417 pages contenant des feuilles de style et/ou scripts plus grands que 8k
418 (cette taille s'entend pour chaque script ou feuilles de style, non pour
419 leur ensemble), il sera plus efficace de définir une taille de
420 tampon initiale plus grande afin d'éviter d'avoir à le redimensionner
421 dynamiquement au cours du traitement d'une requête.
422 </p>
423 </usage>
424 </directivesynopsis>
425
426 <directivesynopsis>
427 <name>ProxyHTMLEvents</name>
428 <description>Spécifie les attributs à traiter comme des évènements de
429 type scripting.</description>
430 <syntax>ProxyHTMLEvents <var>attribut [attribut ...]</var></syntax>
431 <contextlist><context>server config</context>
432 <context>virtual host</context><context>directory</context>
433 </contextlist>
434 <compatibility>Disponible depuis la version 2.4 du serveur HTTP Apache.
435 Disponible en tant que module tiers dans les versions 2.x antérieures.</compatibility>
436 <usage>
437 <p>Cette directive permet de spécifier un ou plusieurs attributs à
438 traiter comme
439 des évènements de type scripting et de leur appliquer les règles
440 <directive module="mod_proxy_html">ProxyHTMLURLMap</directive> lorsqu'elles ont été définies. Vous
441 pouvez spécifier un nombre quelconque d'attributs dans une ou plusieurs
442 directives <directive>ProxyHTMLEvents</directive>.</p>
443 <p>Normalement, cette directive est définie globalement. Si vous
444 définissez <directive>ProxyHTMLEvents</directive> à plusieurs niveaux, certains niveaux
445 l'emportant sur d'autres, vous devrez spécifier un jeu complet
446 d'évènements pour chaque niveau.</p>
447 <p>Le fichier <var>proxy-html.conf</var> fournit une configuration par
448 défaut et définit les évènements selon les standards
449 HTML 4 et XHTML 1.</p>
450 </usage>
451 </directivesynopsis>
452
453 <directivesynopsis>
454 <name>ProxyHTMLLinks</name>
455 <description>Spécifie les éléments HTML dont les attributs d'URL doivent
456 être réécrits.</description>
457 <syntax>ProxyHTMLLinks <var>élément attribut [attribut2 ...]</var></syntax>
458 <contextlist><context>server config</context>
459 <context>virtual host</context><context>directory</context>
460 </contextlist>
461 <compatibility>Disponible depuis la version 2.4 du serveur HTTP Apache.
462 Disponible en tant que module tiers dans les versions 2.x antérieures.</compatibility>
463 <usage>
464 <p>Cette directive permet de spécifier les éléments dont les attributs d'URL
465 doivent être réécrits en utilisant les règles standards <directive
466 module="mod_proxy_html">ProxyHTMLURLMap</directive>. Vous devez définir une
467 directive <directive>ProxyHTMLLinks</directive> pour chaque élément, mais chacune d'entre elles peut
468 spécifier un nombre quelconque d'attributs</p> <p>Normalement, cette directive
469 est définie globalement. Si vous définissez <directive>ProxyHTMLLinks</directive> à plusieurs niveaux,
470 certains niveaux l'emportant sur d'autres, vous devrez spécifier un jeu complet
471 de liens pour chaque niveau.</p> <p>Le fichier <var>proxy-html.conf</var>
472 fournit une configuration par défaut et définit les liens HTML selon les
473 standards HTML 4 et XHTML 1.</p>
474 <example>
475 <title>Exemples issus de proxy-html.conf</title>
476 <highlight language="config">
477 ProxyHTMLLinks  a          href
478 ProxyHTMLLinks  area       href
479 ProxyHTMLLinks  link       href
480 ProxyHTMLLinks  img        src longdesc usemap
481 ProxyHTMLLinks  object     classid codebase data usemap
482 ProxyHTMLLinks  q          cite
483 ProxyHTMLLinks  blockquote cite
484 ProxyHTMLLinks  ins        cite
485 ProxyHTMLLinks  del        cite
486 ProxyHTMLLinks  form       action
487 ProxyHTMLLinks  input      src usemap
488 ProxyHTMLLinks  head       profile
489 ProxyHTMLLinks  base       href
490 ProxyHTMLLinks  script     src for
491 </highlight>
492 </example>
493 </usage>
494 </directivesynopsis>
495
496 <directivesynopsis>
497 <name>ProxyHTMLCharsetOut</name>
498 <description>Spécifie un jeu de caractères pour la sortie de
499 mod_proxy_html.</description>
500 <syntax>ProxyHTMLCharsetOut <var>jeu-de-caractères | *</var></syntax>
501 <contextlist><context>server config</context>
502 <context>virtual host</context><context>directory</context>
503 </contextlist>
504 <compatibility>Disponible depuis la version 2.4 du serveur HTTP Apache.
505 Disponible en tant que module tiers dans les versions 2.x antérieures.</compatibility>
506 <usage>
507 <p>Cette directive permet de spécifier un jeu de caractères pour la
508 sortie de mod_proxy_html. Elle ne devrait jamais être utilisée, car tout
509 changement par rapport à la valeur par défaut <code>UTF-8</code> (Unicode -
510 utilisé en interne par libxml2) induit une charge supplémentaire de
511 traitement. La définition spéciale <code>ProxyHTMLCharsetOut *</code>
512 permet de générer une sortie qui utilisera le même encodage que
513 l'entrée.</p>
514 <p>Notez que tout ceci ne fonctionne que si le module
515 <module>mod_xml2enc</module> est chargé.</p>
516 </usage>
517 </directivesynopsis>
518
519
520
521 </modulesynopsis>
522