httpd-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From jfcl...@apache.org
Subject svn commit: r566229 - in /httpd/httpd/trunk/docs/manual: handler.html.fr handler.xml.fr
Date Wed, 15 Aug 2007 15:45:41 GMT
Author: jfclere
Date: Wed Aug 15 08:45:40 2007
New Revision: 566229

URL: http://svn.apache.org/viewvc?view=rev&rev=566229
Log:
Translation submitted by Vincent Deffontaines.

Added:
    httpd/httpd/trunk/docs/manual/handler.html.fr
    httpd/httpd/trunk/docs/manual/handler.xml.fr

Added: httpd/httpd/trunk/docs/manual/handler.html.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/handler.html.fr?view=auto&rev=566229
==============================================================================
--- httpd/httpd/trunk/docs/manual/handler.html.fr (added)
+++ httpd/httpd/trunk/docs/manual/handler.html.fr Wed Aug 15 08:45:40 2007
@@ -0,0 +1,161 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!--
+        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+              This file is generated from xml source: DO NOT EDIT
+        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+      -->
+<title>Utilisation des gestionnaires d'Apache (handlers) - Serveur Apache HTTP</title>
+<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main
stylesheet" />
+<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all"
type="text/css" title="No Sidebar - Default font size" />
+<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css"
/>
+<link href="./images/favicon.ico" rel="shortcut icon" /></head>
+<body id="manual-page"><div id="page-header">
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a>
| <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossaire</a>
| <a href="./sitemap.html">Plan du site</a></p>
+<p class="apache">Serveur Apache HTTP Version 2.3</p>
+<img alt="" src="./images/feather.gif" /></div>
+<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif"
/></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur
HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a>
&gt; <a href="./">Version 2.3</a></div><div id="page-content"><div
id="preamble"><h1>Utilisation des gestionnaires d'Apache (handlers)</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="./en/handler.html" hreflang="en"
rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="./es/handler.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a>
|
+<a href="./fr/handler.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="./ja/handler.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a>
|
+<a href="./ko/handler.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
+</div>
+
+    <p>Ce document décrit l'utilisation des gestionnaires d'Apache (handlers).</p>
+  </div>
+<div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif"
/> <a href="#definition">Qu'est-ce qu'un gestionnaire ?</a></li>
+<li><img alt="" src="./images/down.gif" /> <a href="#examples">Exemples</a></li>
+<li><img alt="" src="./images/down.gif" /> <a href="#programmer">Note du
programmeur</a></li>
+</ul></div>
+<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"
/></a></div>
+<div class="section">
+<h2><a name="definition" id="definition">Qu'est-ce qu'un gestionnaire ?</a></h2>
+    
+    <table class="related"><tr><th>Modules Apparentés</th><th>Directives
Apparentées</th></tr><tr><td><ul><li><code class="module"><a
href="./mod/mod_actions.html">mod_actions</a></code></li><li><code
class="module"><a href="./mod/mod_asis.html">mod_asis</a></code></li><li><code
class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code></li><li><code
class="module"><a href="./mod/mod_imagemap.html">mod_imagemap</a></code></li><li><code
class="module"><a href="./mod/mod_info.html">mod_info</a></code></li><li><code
class="module"><a href="./mod/mod_mime.html">mod_mime</a></code></li><li><code
class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code></li><li><code
class="module"><a href="./mod/mod_status.html">mod_status</a></code></li></ul></td><td><ul><li><code
class="directive"><a href="./mod/mod_actions.html#action">Action</a></code></li><li><code
class="directive"><a href="./mod/mod_mime.html#addhandler">AddHandler</a></code></li><li><code
class=
 "directive"><a href="./mod/mod_mime.html#removehandler">RemoveHandler</a></code></li><li><code
class="directive"><a href="./mod/core.html#sethandler">SetHandler</a></code></li></ul></td></tr></table>
+
+
+    <p>Un "gestionnaire" est une représentation interne à Apache de l'action
+    qui doit être entreprise quand un fichier est appelé. En général, les
+    fichiers ont des gestionnaires implicites, basés sur le type du fichier.
+    Normalement, tous les fichiers sont traités simplement par le serveur,
+    mais certains types de fichiers sont "gérés" séparément.</p>
+
+    <p>Les gestionnaires peuvent aussi être configurés explicitement,
+    soit en fonction des extensions des noms de fichier, soit en fonction
+    du chemin du fichier,
+    sans faire référence au type de fichier. Ceci a le double avantage d'être
+    une solution plus élégante, et aussi d'autoriser à associer à la fois
+    un type <strong>et</strong> un gestionnaire avec un fichier. (Voir aussi
<a href="mod/mod_mime.html#multipleext">Fichiers avec extensions
+    multiples</a>.)</p>
+
+    <p>Les gestionnaires peuvent être soit partie intégrante
+    du serveur ou inclus dans un module, soit ajoutés à l'aide de la directive
+    <code class="directive"><a href="./mod/mod_actions.html#action">Action</a></code>.
Les gestionnaires
+    intégrés dans la distribution standard se présentent comme suit :</p>
+
+    <ul>
+      <li><strong>default-handler</strong>: envoie le fichier en utilisant
+      le <code>default_handler()</code>, qui est le gestionnaire utilisé par
+      défaut pour traiter les contenus statiques. (core)</li>
+
+      <li><strong>send-as-is</strong>: envoie les fichiers avec en-têtes
HTTP
+      tels quels. (<code class="module"><a href="./mod/mod_asis.html">mod_asis</a></code>)</li>
+
+      <li><strong>cgi-script</strong>: traite le fichier comme un
+      script CGI. (<code class="module"><a href="./mod/mod_cgi.html">mod_cgi</a></code>)</li>
+
+      <li><strong>imap-file</strong>: Traite le fichier comme un ensemble
+      de règles de descriptions d'images (imagemap).
+      (<code class="module"><a href="./mod/mod_imagemap.html">mod_imagemap</a></code>)</li>
+
+      <li><strong>server-info</strong>: Extrait des informations sur la
+      configuration du serveur. (<code class="module"><a href="./mod/mod_info.html">mod_info</a></code>)</li>
+
+      <li><strong>server-status</strong>: Rédige un rapport sur le statut
+      du serveur. (<code class="module"><a href="./mod/mod_status.html">mod_status</a></code>)</li>
+
+      <li><strong>type-map</strong>: Traite le fichier comme une description
+      de type pour la négociation du contenu.
+      (<code class="module"><a href="./mod/mod_negotiation.html">mod_negotiation</a></code>)</li>
+    </ul>
+  </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"
/></a></div>
+<div class="section">
+<h2><a name="examples" id="examples">Exemples</a></h2>
+    
+
+    <h3><a name="example1" id="example1">Modification d'un contenu statique à
l'aide d'un script CGI</a></h3>
+      
+
+      <p>Les directives suivantes vont faire en sorte que les requêtes pour
+      des fichiers possédant une extension <code>html</code> déclenchent
+      l'exécution du script CGI <code>footer.pl</code>.</p>
+
+      <div class="example"><p><code>
+        Action add-footer /cgi-bin/footer.pl<br />
+        AddHandler add-footer .html
+      </code></p></div>
+
+      <p>À ce moment-là, le script CGI se charge d'envoyer le document
+      initialement demandé (référencé par la variable d'environnement
+      <code>PATH_TRANSLATED</code>) et d'effectuer tous ajout ou modification
+      voulus.</p>
+
+    
+    <h3><a name="example2" id="example2">Fichiers avec en-têtes HTTP</a></h3>
+      
+
+      <p>Les directives suivantes vont activer le gestionnaire
+      <code>send-as-is</code>, qui est utilisé pour les fichiers qui possèdent
+      leurs propres en-têtes HTTP. Tous les fichiers situés dans le répertoire
+      <code>/web/htdocs/asis/</code> seront traités par le gestionnaire
+      <code>send-as-is</code>, sans tenir compte de l'extension
+      de leur nom de fichier.</p>
+
+      <div class="example"><p><code>
+        &lt;Directory /web/htdocs/asis&gt;<br />
+        SetHandler send-as-is<br />
+        &lt;/Directory&gt;
+      </code></p></div>
+
+    
+  </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"
/></a></div>
+<div class="section">
+<h2><a name="programmer" id="programmer">Note du programmeur</a></h2>
+    
+
+    <p>Pour implémenter la fonctionnalité des gestionnaires, l'
+    <a href="developer/API.html">API Apache</a> a fait l'objet d'un ajout
+    que vous pourriez être amené à utiliser.
+
+    Plus précisément, un nouvel enregistrement a été ajouté à la structure
+    <code>request_rec</code> :</p>
+
+    <div class="example"><p><code>
+      char *handler
+    </code></p></div>
+
+    <p>Si vous voulez que votre module déclenche l'utilisation d'un
+    gestionnaire, il vous suffit de définir <code>r-&gt;handler</code> avec
+    le nom du gestionnaire à n'importe quel moment avant l'étape
+    <code>invoke_handler</code>
+    de la requête. Les gestionnaires sont implémentés comme auparavant,
+    quoique l'on utilise le nom du gestionnaire à la place d'un type
+    de contenu. Bien que ce ne soit pas obligatoire, la convention de nommage
+    des gestionnaires stipule l'utilisation d'un mot composé séparé par des
+    tirets, sans slashes, afin de ne pas interférer avec l'espace de nommage
+    des types de média.</p>
+  </div></div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="./en/handler.html" hreflang="en"
rel="alternate" title="English">&nbsp;en&nbsp;</a> |
+<a href="./es/handler.html" hreflang="es" rel="alternate" title="Español">&nbsp;es&nbsp;</a>
|
+<a href="./fr/handler.html" title="Français">&nbsp;fr&nbsp;</a> |
+<a href="./ja/handler.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a>
|
+<a href="./ko/handler.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a></p>
+</div><div id="footer">
+<p class="apache">Copyright 2006 The Apache Software Foundation.<br />Authorisé
sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
+<p class="menu"><a href="./mod/">Modules</a> | <a href="./mod/directives.html">Directives</a>
| <a href="./faq/">FAQ</a> | <a href="./glossary.html">Glossaire</a>
| <a href="./sitemap.html">Plan du site</a></p></div>
+</body></html>
\ No newline at end of file

Added: httpd/httpd/trunk/docs/manual/handler.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/handler.xml.fr?view=auto&rev=566229
==============================================================================
--- httpd/httpd/trunk/docs/manual/handler.xml.fr (added)
+++ httpd/httpd/trunk/docs/manual/handler.xml.fr Wed Aug 15 08:45:40 2007
@@ -0,0 +1,167 @@
+<?xml version="1.0" encoding="ISO-8859-1" ?>
+<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
+
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements.  See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License.  You may obtain a copy of the License at
+
+     http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<manualpage metafile="handler.xml.meta">
+
+  <title>Utilisation des gestionnaires d'Apache (handlers)</title>
+
+  <summary>
+    <p>Ce document d&eacute;crit l'utilisation des gestionnaires d'Apache (handlers).</p>
+  </summary>
+
+  <section id="definition">
+    <title>Qu'est-ce qu'un gestionnaire ?</title>
+    <related>
+      <modulelist>
+        <module>mod_actions</module>
+        <module>mod_asis</module>
+        <module>mod_cgi</module>
+        <module>mod_imagemap</module>
+        <module>mod_info</module>
+        <module>mod_mime</module>
+        <module>mod_negotiation</module>
+        <module>mod_status</module>
+     </modulelist>
+      <directivelist>
+        <directive module="mod_actions">Action</directive>
+        <directive module="mod_mime">AddHandler</directive>
+        <directive module="mod_mime">RemoveHandler</directive>
+        <directive module="core">SetHandler</directive>
+      </directivelist>
+    </related>
+
+
+    <p>Un "gestionnaire" est une repr&eacute;sentation interne &agrave; Apache
de l'action
+    qui doit &ecirc;tre entreprise quand un fichier est appel&eacute;. En g&eacute;n&eacute;ral,
les
+    fichiers ont des gestionnaires implicites, bas&eacute;s sur le type du fichier.
+    Normalement, tous les fichiers sont trait&eacute;s simplement par le serveur,
+    mais certains types de fichiers sont "g&eacute;r&eacute;s" s&eacute;par&eacute;ment.</p>
+
+    <p>Les gestionnaires peuvent aussi &ecirc;tre configur&eacute;s explicitement,
+    soit en fonction des extensions des noms de fichier, soit en fonction
+    du chemin du fichier,
+    sans faire r&eacute;f&eacute;rence au type de fichier. Ceci a le double avantage
d'&ecirc;tre
+    une solution plus &eacute;l&eacute;gante, et aussi d'autoriser &agrave; associer
&agrave; la fois
+    un type <strong>et</strong> un gestionnaire avec un fichier. (Voir aussi
<a
+    href="mod/mod_mime.html#multipleext">Fichiers avec extensions
+    multiples</a>.)</p>
+
+    <p>Les gestionnaires peuvent &ecirc;tre soit partie int&eacute;grante
+    du serveur ou inclus dans un module, soit ajout&eacute;s &agrave; l'aide de la
directive
+    <directive module="mod_actions">Action</directive>. Les gestionnaires
+    int&eacute;gr&eacute;s dans la distribution standard se pr&eacute;sentent
comme suit :</p>
+
+    <ul>
+      <li><strong>default-handler</strong>: envoie le fichier en utilisant
+      le <code>default_handler()</code>, qui est le gestionnaire utilis&eacute;
par
+      d&eacute;faut pour traiter les contenus statiques. (core)</li>
+
+      <li><strong>send-as-is</strong>: envoie les fichiers avec en-t&ecirc;tes
HTTP
+      tels quels. (<module>mod_asis</module>)</li>
+
+      <li><strong>cgi-script</strong>: traite le fichier comme un
+      script CGI. (<module>mod_cgi</module>)</li>
+
+      <li><strong>imap-file</strong>: Traite le fichier comme un ensemble
+      de r&egrave;gles de descriptions d'images (imagemap).
+      (<module>mod_imagemap</module>)</li>
+
+      <li><strong>server-info</strong>: Extrait des informations sur la
+      configuration du serveur. (<module>mod_info</module>)</li>
+
+      <li><strong>server-status</strong>: R&eacute;dige un rapport
sur le statut
+      du serveur. (<module>mod_status</module>)</li>
+
+      <li><strong>type-map</strong>: Traite le fichier comme une description
+      de type pour la n&eacute;gociation du contenu.
+      (<module>mod_negotiation</module>)</li>
+    </ul>
+  </section>
+  <section id="examples">
+    <title>Exemples</title>
+
+    <section id="example1">
+      <title>Modification d'un contenu statique &agrave; l'aide d'un script CGI</title>
+
+      <p>Les directives suivantes vont faire en sorte que les requ&ecirc;tes pour
+      des fichiers poss&eacute;dant une extension <code>html</code> d&eacute;clenchent
+      l'ex&eacute;cution du script CGI <code>footer.pl</code>.</p>
+
+      <example>
+        Action add-footer /cgi-bin/footer.pl<br/>
+        AddHandler add-footer .html
+      </example>
+
+      <p>&Agrave; ce moment-l&agrave;, le script CGI se charge d'envoyer le
document
+      initialement demand&eacute; (r&eacute;f&eacute;renc&eacute; par la
variable d'environnement
+      <code>PATH_TRANSLATED</code>) et d'effectuer tous ajout ou modification
+      voulus.</p>
+
+    </section>
+    <section id="example2">
+      <title>Fichiers avec en-t&ecirc;tes HTTP</title>
+
+      <p>Les directives suivantes vont activer le gestionnaire
+      <code>send-as-is</code>, qui est utilis&eacute; pour les fichiers qui
poss&egrave;dent
+      leurs propres en-t&ecirc;tes HTTP. Tous les fichiers situ&eacute;s dans le
r&eacute;pertoire
+      <code>/web/htdocs/asis/</code> seront trait&eacute;s par le gestionnaire
+      <code>send-as-is</code>, sans tenir compte de l'extension
+      de leur nom de fichier.</p>
+
+      <example>
+        &lt;Directory /web/htdocs/asis&gt;<br/>
+        SetHandler send-as-is<br/>
+        &lt;/Directory&gt;
+      </example>
+
+    </section>
+  </section>
+  <section id="programmer">
+    <title>Note du programmeur</title>
+
+    <p>Pour impl&eacute;menter la fonctionnalit&eacute; des gestionnaires,
l'
+    <a href="developer/API.html">API Apache</a> a fait l'objet d'un ajout
+    que vous pourriez &ecirc;tre amen&eacute; &agrave; utiliser.
+
+    Plus pr&eacute;cis&eacute;ment, un nouvel enregistrement a &eacute;t&eacute;
ajout&eacute; &agrave; la structure
+    <code>request_rec</code> :</p>
+
+    <example>
+      char *handler
+    </example>
+
+    <p>Si vous voulez que votre module d&eacute;clenche l'utilisation d'un
+    gestionnaire, il vous suffit de d&eacute;finir <code>r-&gt;handler</code>
avec
+    le nom du gestionnaire &agrave; n'importe quel moment avant l'&eacute;tape
+    <code>invoke_handler</code>
+    de la requ&ecirc;te. Les gestionnaires sont impl&eacute;ment&eacute;s comme
auparavant,
+    quoique l'on utilise le nom du gestionnaire &agrave; la place d'un type
+    de contenu. Bien que ce ne soit pas obligatoire, la convention de nommage
+    des gestionnaires stipule l'utilisation d'un mot compos&eacute; s&eacute;par&eacute;
par des
+    tirets, sans slashes, afin de ne pas interf&eacute;rer avec l'espace de nommage
+    des types de m&eacute;dia.</p>
+  </section>
+</manualpage>
+
+
+
+
+



Mime
View raw message