Commit d979725a authored by Lucien Gentis's avatar Lucien Gentis
Browse files

XML updates. 


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1742729 13f79535-47bb-0310-9956-ffa450edef68
parent c6127b61

docs/manual/custom-error.xml.fr

+69 −69
Original line number Diff line number Diff line 
<?xml version="1.0" encoding="ISO-8859-1" ?>

<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">

<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>

<!-- English Revision: 1361160:1741841 (outdated) -->

<!-- English Revision: 1741841 -->

<!-- French translation : Lucien GENTIS -->

<!-- Reviewed by : Vincent Deffontaines -->
@@ -24,46 +24,46 @@ 


<manualpage metafile="custom-error.xml.meta">



  <title>Messages d'erreur personnalis&eacute;s</title>

  <title>Messages d'erreur personnalisés</title>



  <summary>

    <p>Le serveur HTTP Apache fournit des messages d'erreur g&eacute;n&eacute;riques

    <p>Le serveur HTTP Apache fournit des messages d'erreur génériques

    pour les codes de statut 4xx ou 5xx ; ces messages sont cependant

    relativement aust&egrave;res, impr&eacute;cis, et peuvent s'av&eacute;rer intimidants

    relativement austères, imprécis, et peuvent s'avérer intimidants

    pour les visiteurs du site. Si vous le souhaitez, vous pouvez

    afficher des messages d'erreur plus conviviaux, dans un langage

    autre que l'anglais, ou m&ecirc;me sous une forme plus en ad&eacute;quation avec

    autre que l'anglais, ou même sous une forme plus en adéquation avec

    le style de votre site.</p>



    <p>Il est possible de d&eacute;finir des messages d'erreur personnalis&eacute;s

    pour chaque code de statut HTTP associ&eacute; &agrave; une condition d'erreur -

    c'est &agrave; dire tout code de statut 4xx ou 5xx.</p>

    <p>Il est possible de définir des messages d'erreur personnalisés

    pour chaque code de statut HTTP associé à une condition d'erreur -

    c'est à dire tout code de statut 4xx ou 5xx.</p>



    <p>De plus, il est possible de

    personnaliser le message d'erreur en fonction d'un jeu de valeurs

    fourni, en utilisant les <a href="howto/ssi.html">Inclusions C&ocirc;t&eacute;

    fourni, en utilisant les <a href="howto/ssi.html">Inclusions Côté

    Serveur (SSI)</a>. Un programme CGI ou un autre gestionnaire

    dynamique (PHP, mod_perl, etc...) peut aussi utiliser ces variables

    pour g&eacute;rer les conditions d'erreur.</p>

    pour gérer les conditions d'erreur.</p>





  </summary>



  <section id="configuration"><title>Configuration</title>



    <p>Les messages d'erreur personnalis&eacute;s sont configur&eacute;s via la

    <p>Les messages d'erreur personnalisés sont configurés via la

    directive <directive module="core">ErrorDocument</directive>, qui

    peut &ecirc;tre utilis&eacute;e dans un contexte global, serveur virtuel ou

    r&eacute;pertoire. On peut utiliser cette directive dans les fichiers

    peut être utilisée dans un contexte global, serveur virtuel ou

    répertoire. On peut utiliser cette directive dans les fichiers

    .htaccess si <directive module="core">AllowOverride</directive> est

    d&eacute;finie &agrave; FileInfo.</p>

    définie à FileInfo.</p>



    <highlight language="config">

ErrorDocument 500 "D&eacute;sol&eacute;, notre script s'est

crash&eacute; ; comme c'est dommage !"<br />

ErrorDocument 500 /cgi-bin/crash-recover<br />

ErrorDocument 500 http://error.example.com/server_error.html<br />

ErrorDocument 404 /errors/not_found.html <br />

ErrorDocument 500 "Désolé, notre script s'est

crashé ; comme c'est dommage !"

ErrorDocument 500 /cgi-bin/crash-recover

ErrorDocument 500 http://error.example.com/server_error.html

ErrorDocument 404 /errors/not_found.html 

ErrorDocument 401 /subscription/how_to_subscribe.html

    </highlight>
@@ -71,34 +71,34 @@ ErrorDocument 401 /subscription/how_to_subscribe.html 
      <highlight language="config">

      ErrorDocument &lt;code_3_chiffres&gt; &lt;action&gt;

    </highlight>

      <p>o&ugrave; action peut &ecirc;tre trait&eacute;e comme :</p>

      <p>où action peut être traitée comme :</p>

        <ol>

      <li>Une URL de redirection local (si l'action commence par un "/").</li>

      <li>Une URL de redirection externe (si action est une URL valide).</li>

      <li>Le texte &agrave; afficher (si l'action ne r&eacute;pond &agrave; aucune des

      deux conditions pr&eacute;c&eacute;dentes). Entourez le texte de guillemets (")

      <li>Le texte à afficher (si l'action ne répond à aucune des

      deux conditions précédentes). Entourez le texte de guillemets (")

      s'il contient plusieurs mots.</li>

        </ol>



    <p>Dans le cas d'une redirection vers une URL locale, des variables

    d'environnement suppl&eacute;mentaires sont d&eacute;finies de fa&ccedil;on &agrave; ce que la

    r&eacute;ponse puisse &ecirc;tre personnalis&eacute;e par la suite. Elles ne sont pas

    envoy&eacute;es aux URLs externes.</p>

    d'environnement supplémentaires sont définies de façon à ce que la

    réponse puisse être personnalisée par la suite. Elles ne sont pas

    envoyées aux URLs externes.</p>



  </section>



        <section id="variables"><title>Variables disponibles</title>



      <p>La redirection vers une autre URL peut &ecirc;tre utile, mais

      <p>La redirection vers une autre URL peut être utile, mais

      seulement s'il est possible de transmettre certaines informations

      qui pourront &ecirc;tre utilis&eacute;es pour expliquer ou journaliser

      la condition d'erreur ou le probl&egrave;me plus clairement.</p>

      qui pourront être utilisées pour expliquer ou journaliser

      la condition d'erreur ou le problème plus clairement.</p>



	<p>Pour y parvenir, lorsque la redirection d'erreur est envoy&eacute;e,

	des variables d'environnement suppl&eacute;mentaires sont d&eacute;finies &agrave;

	partir des en-t&ecirc;tes de la requ&ecirc;te originale en pr&eacute;fixant le nom

	d'origine de l'en-t&ecirc;te par 'REDIRECT_', ce qui permet de fournir au

	message d'erreur le contexte de la requ&ecirc;te originelle.</p>

	<p>Pour y parvenir, lorsque la redirection d'erreur est envoyée,

	des variables d'environnement supplémentaires sont définies à

	partir des en-têtes de la requête originale en préfixant le nom

	d'origine de l'en-tête par 'REDIRECT_', ce qui permet de fournir au

	message d'erreur le contexte de la requête originelle.</p>



      <p>Par exemple, en plus des variables d'environnement habituelles,

      vous pouvez recevoir ce qui suit :</p>
@@ -118,21 +118,21 @@ ErrorDocument 401 /subscription/how_to_subscribe.html 
      </example>



      <p>Les variables d'environnement <code>REDIRECT_</code> sont

      cr&eacute;&eacute;es &agrave; partir des variables d'environnement pr&eacute;existantes &agrave; la

      redirection qui sont pr&eacute;fix&eacute;es par la cha&icirc;ne <code>REDIRECT_</code> ;

      créées à partir des variables d'environnement préexistantes à la

      redirection qui sont préfixées par la chaîne <code>REDIRECT_</code> ;

      par exemple, <code>HTTP_USER_AGENT</code> devient

      <code>REDIRECT_HTTP_USER_AGENT</code>.</p>



      <p><code>REDIRECT_URL</code>, <code>REDIRECT_STATUS</code>, et

      <code>REDIRECT_QUERY_STRING</code> sont syst&eacute;matiquement d&eacute;finies,

      les autres variables n'&eacute;tant d&eacute;finies que si l'en-t&ecirc;te

      <code>REDIRECT_QUERY_STRING</code> sont systématiquement définies,

      les autres variables n'étant définies que si l'en-tête

      correspondant existait avant la condition d'erreur.</p>



      <p><strong>Aucune</strong> d'entre elles ne sera d&eacute;finie si votre

      <p><strong>Aucune</strong> d'entre elles ne sera définie si votre

      directive <directive module="core">ErrorDocument</directive>

      sp&eacute;cifie une redirection <em>externe</em> (toute URL commen&ccedil;ant

      par un protocole du style <code>http:</code>, m&ecirc;me si elle fait

      r&eacute;f&eacute;rence au m&ecirc;me h&ocirc;te que le serveur).</p>

      spécifie une redirection <em>externe</em> (toute URL commençant

      par un protocole du style <code>http:</code>, même si elle fait

      référence au même hôte que le serveur).</p>



  </section>
@@ -141,71 +141,71 @@ ErrorDocument 401 /subscription/how_to_subscribe.html 


	<p>Si vous faites pointer votre directive

	<code>ErrorDocument</code> vers certains gestionnaires

	dynamiques comme les inclusions c&ocirc;t&eacute; serveur, les scripts CGI ou

	dynamiques comme les inclusions côté serveur, les scripts CGI ou

	d'autres gestionnaires, vous pouvez utiliser les variables

	d'environnement suppl&eacute;mentaires disponibles pour personnaliser

	d'environnement supplémentaires disponibles pour personnaliser

	le message.</p>





      <p>Si la directive ErrorDname-basedocument sp&eacute;cifie une redirection locale

      vers un script CGI, ce dernier doit ajouter un en-t&ecirc;te

      <p>Si la directive ErrorDname-basedocument spécifie une redirection locale

      vers un script CGI, ce dernier doit ajouter un en-tête

      "<code>Status:</code>" dans sa sortie afin de s'assurer du bon

      acheminement jusqu'au client de la condition d'erreur qui a

      provoqu&eacute; cette redirection. Par exemple, un script Perl sp&eacute;cifi&eacute;

      provoqué cette redirection. Par exemple, un script Perl spécifié

      par une directive ErrorDocument pourrait contenir ce qui suit

      :</p>



      <highlight language="perl">

...

print  "Content-type: text/html\n"; <br />

printf "Status: %s Condition Intercepted\n", $ENV{"REDIRECT_STATUS"}; <br />

print  "Content-type: text/html\n"; 

printf "Status: %s Condition Intercepted\n", $ENV{"REDIRECT_STATUS"}; 

...

      </highlight>



      <p>Si un script est d&eacute;di&eacute; &agrave; la gestion d'une condition d'erreur

      sp&eacute;cifique, telle que <code>404&nbsp;Not&nbsp;Found</code>, il

      peut utiliser le code et le texte de l'erreur sp&eacute;cifiques &agrave; la

      <p>Si un script est dédié à la gestion d'une condition d'erreur

      spécifique, telle que <code>404&nbsp;Not&nbsp;Found</code>, il

      peut utiliser le code et le texte de l'erreur spécifiques à la

      place.</p>



      <p>Notez que si la r&eacute;ponse contient un en-t&ecirc;te

      <code>Location:</code> (afin d'initier une redirection c&ocirc;t&eacute;

      client), le script <em>doit</em> &eacute;mettre un en-t&ecirc;te appropri&eacute;

      <p>Notez que si la réponse contient un en-tête

      <code>Location:</code> (afin d'initier une redirection côté

      client), le script <em>doit</em> émettre un en-tête approprié

      (comme <code>302&nbsp;Found</code>). Dans le cas contraire,

      l'en-t&ecirc;te <code>Location:</code> ne produira aucun effet.</p>

      l'en-tête <code>Location:</code> ne produira aucun effet.</p>

  </section>



  <section id="multi-lang"><title>Messages d'erreur personnalis&eacute;s

  <section id="multi-lang"><title>Messages d'erreur personnalisés

  multilingues</title>



    <p>Vous trouverez dans la distribution du serveur HTTP Apache un

    r&eacute;pertoire contenant des messages d'erreur personnalis&eacute;s traduits en

    16 langues diff&eacute;rentes. Pour activer cette fonctionnalit&eacute;, vous

    répertoire contenant des messages d'erreur personnalisés traduits en

    16 langues différentes. Pour activer cette fonctionnalité, vous

    pouvez aussi inclure un fichier de configuration qui se trouve dans

    le r&eacute;pertoire de configuration <code>conf/extra</code>.</p>

    le répertoire de configuration <code>conf/extra</code>.</p>



    <p>Dans le fichier de configuration de votre serveur, vous trouverez

    un groupe de lignes du style :</p>



    <highlight language="config">

    # Multi-language error messages<br />

    # Multi-language error messages

    #Include conf/extra/httpd-multilang-errordoc.conf

    </highlight>



    <p>D&eacute;commentez la ligne <code>Include</code> pour activer cette

    fonctionnalit&eacute;, et pr&eacute;senter des messages d'erreur dont le langage

    sera n&eacute;goci&eacute; en fonction du langage pr&eacute;f&eacute;r&eacute; d&eacute;fini au niveau du

    <p>Décommentez la ligne <code>Include</code> pour activer cette

    fonctionnalité, et présenter des messages d'erreur dont le langage

    sera négocié en fonction du langage préféré défini au niveau du

    navigateur du client.</p>



    <p>De plus, ces documents contiennent diverses variables

    <code>REDIRECT_</code>, de fa&ccedil;on &agrave; ce que l'utilisateur final

    dispose d'informations suppl&eacute;mentaires &agrave; propos de ce qui a pu se

    <code>REDIRECT_</code>, de façon à ce que l'utilisateur final

    dispose d'informations supplémentaires à propos de ce qui a pu se

    produire, et de ce qu'il est susceptible de faire maintenant.</p>



    <p>Ces documents peuvent &ecirc;tre personnalis&eacute;s en fournissant autant

    d'informations utiles que vous le souhaitez aux utilisateurs &agrave;

    <p>Ces documents peuvent être personnalisés en fournissant autant

    d'informations utiles que vous le souhaitez aux utilisateurs à

    propos de votre site, et de ce qu'ils sont susceptibles d'y trouver.</p>



    <p>Pour pouvoir utiliser cette fonctionnalit&eacute;, vous devez activer

    <p>Pour pouvoir utiliser cette fonctionnalité, vous devez activer

    <module>mod_include</module> et <module>mod_negotiation</module>.</p>



 </section>

docs/manual/logs.xml.fr

+3 −3
Original line number Diff line number Diff line
@@ -3,7 +3,7 @@ 
<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>

<!-- French translation : Lucien GENTIS -->

<!-- Reviewed by : Vincent Deffontaines -->

<!-- English Revision: 1739105:1741841 (outdated) -->

<!-- English Revision: 1741841 -->



<!--

 Licensed to the Apache Software Foundation (ASF) under one or more
@@ -496,8 +496,8 @@ CustomLog logs/access_log common env=!dontlog 
      utilisateurs dans un autre journal.</p>



      <highlight language="config">

        SetEnvIf Accept-Language "en" english<br />

        CustomLog logs/english_log common env=english<br />

        SetEnvIf Accept-Language "en" english

        CustomLog logs/english_log common env=english

        CustomLog logs/non_english_log common env=!english

      </highlight>

docs/manual/mod/event.xml.fr

+1 −1
Original line number Diff line number Diff line 
<?xml version="1.0" encoding="UTF-8"?>

<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">

<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>

<!-- English Revision: 1741733 -->

<!-- English Revision: 1742031 -->

<!-- French translation : Lucien GENTIS -->

<!-- Reviewed by : Vincent Deffontaines -->

docs/manual/mod/mod_autoindex.xml.fr

+381 −381

File changed.

Preview size limit exceeded, changes collapsed.

docs/manual/mod/mod_include.xml.fr

+3 −3
Original line number Diff line number Diff line 
<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">

<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>

<!-- English Revision: 1735963:1741841 (outdated) -->

<!-- English Revision: 1741841 -->

<!-- French translation : Lucien GENTIS -->

<!-- Reviewed by : Vincent Deffontaines -->
@@ -970,7 +970,7 @@ include</description> 
    éventuellement à des moments différents).</p>



    <highlight language="config">

      SSIStartTag "&lt;%"<br />

SSIStartTag "&lt;%"

SSIEndTag   "%&gt;"      

    </highlight>