New french translation.

<?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: 1793934 -->

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

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

<!--

 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.

-->

<modulesynopsis metafile="mod_xml2enc.xml.meta">

<name>mod_xml2enc</name>

<description>Support avancé de l'internationalisation et des jeux de

caractères pour les modules de filtrage basés sur libxml2</description>

<status>Base</status>

<sourcefile>mod_xml2enc.c</sourcefile>

<identifier>xml2enc_module</identifier>

<compatibility>Disponible depuis la version 2.4 du serveur HTTP Apache.

Disponible en tant que module tiers dans les versions 2.2.x</compatibility>

<summary>

    <p>Ce module fournit un support avancé de l'internationalisation

    pour les modules de filtrage supportant les balises (markup-aware)

    comme <module>mod_proxy_html</module>. Il est capable de détecter

    automatiquement l'encodage des données en entrée et de s'assurer

    qu'elle sont traitées correctement par l'interpréteur <a

    href="http://xmlsoft.org/">libxml2</a>, y compris la conversion en

    Unicode (UTF-8) si nécessaire. Il peut aussi convertir les données

    dans l'encodage de votre choix après le traitement des balises, et

    s'assurera que le <var>jeu de caractères</var> approprié sera défini

    dans l'en-tête HTTP <var>Content-Type</var>.</p>

</summary>

<section id="usage"><title>Utilisation</title>

    <p>Il existe deux scénarios d'utilisation : le cas des modules

    programmés pour travailler avec mod_xml2enc ; et les autres :</p>

    <dl>

    <dt>Modules de filtrages programmés pour mod_xml2enc</dt><dd>

    <p>Les modules comme <module>mod_proxy_html</module> versions 3.1 et

    supérieures utilisent la fonction optionnelle

    <code>xml2enc_charset</code> pour déterminer la valeur de l'argument

    "jeu de caractères" à transmettre à l'interpréteur libxml2, et

    disposent de la fonction optionnelle <code>xml2enc_filter</code>

    pour effectuer un encodage ultérieur éventuel. L'utilisation de

    mod_xml2enc avec un module préprogrammé à cet effet ne nécessite

    aucune configuration : ce dernier configurera mod_xml2enc pour vous

    (sachant que vous pouvez tout de même le personnaliser via les

    directives de configuration ci-dessous).</p>

    </dd>

    <dt>Modules de filtrages non programmés pour mod_xml2enc</dt><dd>

    <p>Pour utiliser mod_xml2enc avec un module basé sur libxml2 qui n'a

    pas été explicitement programmé pour mod_xml2enc, vous devrez

    configurer la chaîne de filtrage vous-même. Ainsi, pour utiliser

    mod_xml2enc avec un filtre <strong>foo</strong> fourni par un module

    <strong>mod_foo</strong> et pour

    améliorer le support i18n de ce dernier avec HTML et XML, vous

    pouvez utiliser les directives suivantes :</p>

    <pre><code>

    FilterProvider iconv    xml2enc Content-Type $text/html

    FilterProvider iconv    xml2enc Content-Type $xml

    FilterProvider markup   foo Content-Type $text/html

    FilterProvider markup   foo Content-Type $xml

    FilterChain     iconv markup

    </code></pre>

    <p><strong>mod_foo</strong> supportera alors tout jeu de caractère supporté soit par

    libxml2, soit par apr_xlate/iconv, soit par les deux.</p>

    </dd></dl>

</section>

<section id="api"><title>API de programmation</title>

    <p>Les programmeurs de modules de filtrage basés sur libxml2 sont

    encouragés à les préprogrammer pour mod_xml2enc, afin de fournir un

    support i18n solide aux utilisateurs sans avoir à réinventer la

    roue. L'API de programmation est décrite dans

    <var>mod_xml2enc.h</var>, et <module>mod_proxy_html</module> est un

    exemple de son utilisation.</p>

</section>

<section id="sniffing"><title>Détection et encodage</title>

    <p>A la différence de <module>mod_charset_lite</module>, mod_xml2enc

    est conçu pour travailler avec des données dont l'encodage ne peut

    pas être connu, et donc configuré, à l'avance. Il utilise donc les

    techniques de 'reniflage' suivantes pour détecter le type d'encodage

    des données HTTP :</p>

    <ol>

        <li>Si l'en-tête HTTP <var>Content-Type</var> contient un

	paramètre <var>charset</var>, c'est ce dernier qui sera utilisé.</li>

        <li>Si les données commancent par une balise XML concernant

	l'ordre des octets (BOM) ou par une déclaration d'encodage XML,

	c'est celle-ci qui sera utilisée.</li>

        <li>Si un type d'encodage est déclaré dans un élément HTML

	<code>&lt;META&gt;</code>, c'est ce dernier qui sera utilisé.</li>

        <li>Si aucun des éléments précédents n'est trouvé, c'est la

	valeur par défaut définie par la directive

	<directive>xml2EncDefault</directive> qui sera utilisée.</li>

    </ol>

    <p>Les conditions sont testées dans cet ordre . Dès qu'une règle

    s'applique, elle est utilisée et la détection est terminée.</p>

</section>

<section id="output"><title>Codage en sortie</title>

<p><a href="http://xmlsoft.org/">libxml2</a> utilise toujours UTF-8

(Unicode) en interne, et les modules de filtrage basés sur libxml2

utiliseront cet encodage en sortie par défaut. mod_xml2enc peut modifier

l'encodage en sortie via l'API, mais il n'y a actuellement aucun moyen de le

configurer directement.</p>

<p>La modification de l'encodage en sortie ne devrait (du moins en théorie)

jamais être nécessaire, et est même déconseillée à cause de la charge de

traitement supplémentaire imposée au serveur par une conversion non

nécessaire.</p>

</section>

<section id="alias"><title>Codages non supportés</title>

<p>Si vous travaillez avec des encodages non supportés par aucune des

méthodes de conversion disponibles sur votre plateforme, vous pouvez

tout de même leur associer un alias vers un code supporté via la

directive <directive>xml2EncAlias</directive>.</p>

</section>

<directivesynopsis>

<name>xml2EncDefault</name>

<description>Définit un encodage par défaut à utiliser lorsqu'aucune

information ne peut être <a href="#sniffing">automatiquement détectée</a></description>

<syntax>xml2EncDefault <var>nom</var></syntax>

<contextlist><context>server config</context>

<context>virtual host</context><context>directory</context>

<context>.htaccess</context></contextlist>

<override>All</override>

<compatibility>Disponible depuis la version 2.4.0 du serveur HTTP Apache

; disponible depuis un module tiers dans les versions antérieures.</compatibility>

<usage>

    <p>Si vous traitez des données dont l'encodage est connu, mais ne

    contenant aucune information à propos de ce dernier, vous pouvez

    définir une valeur par défaut afin d'aider mod_xml2enc à traiter

    correctement les données. Par exemple, pour définir la valeur par

    défaut Latin1 (<var>iso-8859-1</var> specifiée dans HTTP/1.0),

    utilisez :</p>

    <highlight language="config">xml2EncDefault iso-8859-1</highlight>

</usage>

</directivesynopsis>

<directivesynopsis>

<name>xml2EncAlias</name>

<description>Définit des alias pour les valeurs d'encodage</description>

<syntax>xml2EncAlias <var>jeu-de-caractères alias [alias ...]</var></syntax>

<contextlist><context>server config</context></contextlist>

<usage>

    <p>Cette directive de niveau serveur permet de définir un ou

    plusieurs alias pour un encodage. Elle permet au support d'encodage de

    libxml2 de traiter en interne des encodages non reconnus par libxml2

    en utilisant la table de conversion pour un encodage reconnu. Elle

    permet d'atteindre deux objectifs : supporter des jeux (ou noms) de

    caractères non reconnus par libxml2 ou iconv, et éviter une

    conversion pour un encodage lorsque cela n'est pas nécessaire.</p>

</usage>

</directivesynopsis>

<directivesynopsis>

<name>xml2StartParse</name>

<description>Indique à l'interpréteur à partir de quelle balise il doit

commencer son traitement.</description>

<syntax>xml2StartParse <var>élément [élément ...]</var></syntax>

<contextlist><context>server config</context><context>virtual host</context>

<context>directory</context><context>.htaccess</context></contextlist>

<override>All</override>

<usage>

    <p>Cette directive permet de spécifier à partir de quelle balise,

    parmi les éléments spécifiés, l'interpréteur de balise doit

    commencer son traitement. Ccei permet de contourner le problème des

    serveurs d'arrière-plan qui insèrent des éléments non conformes en

    début de données, ce qui a pour effet de perturber l'interpréteur (<a

    href="http://bahumbug.wordpress.com/2006/10/12/mod_proxy_html-revisited/"

    >voir un exemple ici</a>).</p>

    <p>Elle ne doit être utilisée ni pour les documents XML, ni pour les

    documents HTML correctement formatés.</p>

</usage>

</directivesynopsis>

</modulesynopsis>

<?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 : 1329361 -->

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

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

<!--

 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="index.xml.meta">

  <parentdocument href="../"/>

  <title>Notes spécifiques aux différentes plateformes.</title>

  <section id="win">

    <title>Microsoft Windows</title>

    <dl>

      <dt>Utilisation d'Apache</dt>

      <dd>

        <p>Ce document explique comment installer, configurer et

	exécuter Apache 2.4 sous Microsoft Windows.</p>

        <p>Voir : <a href="windows.html">Utilisation d'Apache avec Microsoft Windows</a></p>

      </dd>

    </dl>

    <dl>

      <dt>Compilation d'Apache</dt>

      <dd>

        <p>Il y a de nombreux points importants à connaître avant de se

	lancer dans la compilation d'Apache. Ce document en donne la

	description.</p>

        <p>Voir : <a href="win_compiling.html"

        >Compilation d'Apache pour Microsoft Windows</a></p>

      </dd>

    </dl>

  </section>

  <section id="unix">

    <title>Systèmes de type Unix</title>

    <dl>

      <dt>Systèmes à base de paquets RPM (Redhat / CentOS / Fedora)</dt>

      <dd>

        <p>Ce document explique comment installer, configurer et

	exécuter Apache 2.4 sur des systèmes qui supportent le format de

	paquet RPM.</p>

        <p>Voir : <a href="rpm.html">Utilisation d'Apache avec les

	systèmes à base de paquets RPM</a></p>

      </dd>

    </dl>

  </section>

  <section id="other">

    <title>Autres plateformes</title>

    <dl>

      <dt>Novell NetWare</dt>

      <dd>

        <p>Ce document explique comment installer, configurer et

	exécuter Apache 2.4 sous Novell NetWare versions 5.1 et

	supérieures.</p>

        <p>Voir : <a href="netware.html">Utilisation d'Apache avec Novell NetWare</a></p>

      </dd>

    </dl>    

  </section>

</manualpage>

<?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 : 805049 -->

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

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

<!--

 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="perf-hp.xml.meta">

  <parentdocument href="./">Notes spécifiques aux

  plates-formes</parentdocument>

  <title>Mise en oeuvre d'un serveur Web hautes performances sous

  HPUX</title>

  <summary>

<pre>

Date: Wed, 05 Nov 1997 16:59:34 -0800

From: Rick Jones &lt;<a

href="mailto:raj@cup.hp.com">raj@cup.hp.com</a>&gt;

Reply-To: <a href="mailto:raj@cup.hp.com"

>raj@cup.hp.com</a>

Organization: Network Performance

Subject: HP-UX tuning tips

</pre>

    <p>Traduction du corps du message cité ci-dessus :</p>

    <p>Voici quelques conseils de personnalisation pour HPUX à ajouter à

    la page de personnalisation.</p>

    <p>Pour HP-UX 9.X: mettre à jour vers la version 10.20<br />

    Pour HP-UX 10.[00|01|10]: mettre à jour vers la version 10.20</p>

    <p>Pour HP-UX 10.20:</p>

    <p>Installez le dernier patch cumulatif à propos du transport ARPA.

    Ceci va vous permettre de configurer la taille de la table de

    hashage de recherche de connexion TCP. La valeur par défaut est 256

    conteneurs et doit être une puissance de deux. À cet effet, utilisez

    adb pour modifier l'image *disque* du noyau. Le nom de la variable

    est <code>tcp_hash_size</code>. Notez qu'il est impératif d'utiliser

    "<code>W</code>" pour spécifier une quantité sur 32 bits, et non

    "<code>w</code>" qui indique une valeur sur 16 bits, lors de la

    modification de l'image disque car la variable

    <code>tcp_hash_size</code> est une quantité sur 32 bits.</p>

    <p>Comment déterminer cette valeur ? Examinez la sortie de <a

    href="ftp://ftp.cup.hp.com/dist/networking/tools/connhist"

    >ftp://ftp.cup.hp.com/dist/networking/tools/connhist</a>, et

    comptez le nombre total de connexions TCP existant sur le système.

    Il est en général souhaitable que ce nombre divisé par la taille de

    la table de hashage soit raisonnablement petit, disons inférieur à

    10. Les administrateurs peuvent consulter le document SPECweb96 de

    HP pour quelques réglages courants. On peut les trouver à <a

    href="http://www.specbench.org/">http://www.specbench.org/</a>. Si

    un système HP-UX traite 1000 connexions SPECweb96 par seconde, une

    valeur de temps <code>TIME_WAIT</code> de 60 secondes permettrait le

    suivi de 60000 connexions TCP.</p>

    <p>Les administrateurs peuvent tester la profondeur de leur file

    d'attente d'écoute avec <a

    href="ftp://ftp.cup.hp.com/dist/networking/misc/listenq"

    >ftp://ftp.cup.hp.com/dist/networking/misc/listenq</a>.</p>

    <p>Si Apache s'exécute sur un système à base de PA-8000, il est

    conseillé de modifier l'exécutable Apache avec la commande chatr

    afin d'utiliser une page de grande taille. La commande sera du style

    "<code>chatr +pi L &lt;BINARY&gt;</code>". Le GID de l'exécutable en

    cours de fonctionnement doit posséder le privilège

    <code>MLOCK</code>. Pour assigner ce privilège <code>MLOCK</code>,

    consultez <code>Setprivgrp(1m)</code>. La modification peut être

    validée en exécutant Glance et en examinant les portions de mémoire

    du/des serveur(s) afin de s'assurer qu'elles montrent une fraction

    non triviale du segment de texte verrouillé.</p>

    <p>Si Apache s'exécute sur un système MP (multi-processeurs), il est

    conseillé d'écrire un petit programme qui utilise

    <code>mpctl()</code> et permettant d'associer les processus aux

    processeurs. Un simple algorithme <code>pid % numcpu</code> suffira

    probablement. Cette modification peut aussi être ajoutée dans le

    code source.</p>

    <p>Si l'administrateur s'intéresse au nombre de connexions

    <code>FIN_WAIT_2</code>, il peut utiliser nettune pour diminuer la

    valeur de <code>tcp_keepstart</code>. Il devra cependant être

    prudent - surtout ne pas diminuer cette valeur en dessous de, disons

    deux à quatre minutes. Si <code>tcp_hash_size</code> a été défini,

    il est probablement approprié de laisser les connexions

    <code>FIN_WAIT_2</code> prendre plus de temps à expirer (peut-être

    même la valeur par défaut de deux heures) - elles n'auront en

    général pas un grand impact sur les performances.</p>

    <p>On peut ajouter d'autres choses au code de base, mais elles

    feront peut-être l'objet d'un autre email. N'hésitez pas à m'envoyer

    un message si vous êtes intéressé.</p>

    <p>sincèrement ,</p>

    <p>rick jones</p>

    <p><a href="http://www.netperf.org/netperf/"

    >http://www.netperf.org/netperf/</a></p>

  </summary>

</manualpage>