You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by gr...@apache.org on 2009/10/04 13:48:30 UTC
svn commit: r821517 [2/2] - in /httpd/httpd/trunk/docs/manual/mod:
allmodules.xml.fr mod_autoindex.html mod_autoindex.html.en
mod_autoindex.html.fr mod_autoindex.xml.fr mod_autoindex.xml.meta
Added: httpd/httpd/trunk/docs/manual/mod/mod_autoindex.xml.fr
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_autoindex.xml.fr?rev=821517&view=auto
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_autoindex.xml.fr (added)
+++ httpd/httpd/trunk/docs/manual/mod/mod_autoindex.xml.fr Sun Oct 4 11:48:30 2009
@@ -0,0 +1,1074 @@
+<?xml version="1.0"?>
+<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
+<!-- English Revision : 807930 -->
+<!-- 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_autoindex.xml.meta">
+<name>mod_autoindex</name>
+
+<description>Génère automatiquement des index de répertoires d'une
+manière similaire à la commande Unix <code>ls</code>, ou à la commande
+shell Win32 <code>dir</code></description>
+<status>Base</status>
+<sourcefile>mod_autoindex.c</sourcefile>
+<identifier>autoindex_module</identifier>
+
+<summary>
+ <p>L'index d'un répertoire peut être généré de deux manières :</p>
+
+ <ul>
+ <li>Un fichier écrit par l'utilisateur, en général appelé
+ <code>index.html</code>, mais dont le nom peut être défini par la
+ directive <directive
+ module="mod_dir">DirectoryIndex</directive>. C'est le module
+ <module>mod_dir</module> qui traite alors cet index.</li>
+
+ <li>Un listing généré par le serveur, dont le format est contrôlé
+ par un certain nombre de directives. Les directives <directive
+ module="mod_autoindex">AddIcon</directive>, <directive
+ module="mod_autoindex">AddIconByEncoding</directive> et <directive
+ module="mod_autoindex">AddIconByType</directive> permettent de
+ définir une liste d'icônes à afficher en fonction des différents
+ types de fichiers ; pour chaque fichier listé, le premier icône
+ qui correspond au type du fichier est affiché. C'est le module
+ <module>mod_autoindex</module> qui traite alors cet index.</li>
+ </ul>
+ <p>Les deux fonctions sont séparées, si bien que vous pouvez
+ entièrement supprimer (ou remplacer) la génération automatique
+ d'index, si vous le souhaitez.</p>
+
+ <p>On active la génération automatique d'index en spécifiant
+ <code>Options +Indexes</code>. Voir la directive <directive
+ module="core">Options</directive> pour plus de détails.</p>
+
+ <p>Si la directive <directive
+ module="mod_autoindex">IndexOptions</directive> est spécifiée avec
+ l'option <code><a href="#indexoptions.fancyindexing"
+ >FancyIndexing</a></code>, les en-têtes de colonnes sont des liens
+ qui permettent de contrôler l'ordre de tri de l'affichage. Si vous
+ actionnez le lien d'un en-tête, le listing sera généré à nouveau,
+ trié en fonction des valeurs de la colonne concernée. Si l'on
+ actionne de manière répétitive le même en-tête, l'ordre de tri est
+ commuté entre les ordres croissant et décroissant. On peut supprimer
+ ces liens d'en-têtes de colonnes à l'aide de l'option
+ <code>SuppressColumnSorting</code> de la directive <directive
+ module="mod_autoindex">IndexOptions</directive>.</p>
+
+ <p>Notez que lorsque l'affichage est trié en fonction de la taille,
+ c'est la taille <em>réelle</em> qui est prise en compte, et non la
+ valeur affichée - ainsi, un fichier de 1010 octets sera toujours
+ affiché avant un fichier de 1011 octets (en ordre croissant), même
+ si la taille affichée des deux fichiers est "1K".</p>
+</summary>
+
+<section id="query">
+ <title>Arguments de la requête d'autoindexation</title>
+
+ <p>Apache 2.0.23 a réorganisé les arguments de requête pour le tri
+ des colonnes, et intoduit un groupe complet de nouvelles options de
+ requête. Pour interdire effectivement au client tout contrôle sur
+ l'affichage, l'option <code><a
+ href="#indexoptions.ignoreclient">IndexOptions
+ IgnoreClient</a></code> a été ajoutée.</p>
+
+ <p>Les en-têtes de tri des colonnes eux-mêmes sont des hyper-liens
+ auto-référant qui ajoutent les options de tri à la requête énumérées
+ ci-dessous qui peuvent être ajoutées à toute requête concernant la
+ ressource répertoire.</p>
+
+ <ul>
+ <li><code>C=N</code> trie l'affichage en fonction du nom de
+ fichier</li>
+
+ <li><code>C=M</code> trie l'affichage en fonction de la date de
+ dernière modification, puis du nom de fichier</li>
+
+ <li><code>C=S</code> trie l'affichage en fonction de la taille,
+ puis du nom de fichier</li>
+
+ <li class="separate"><code>C=D</code> trie l'affichage en fonction
+ de la description, puis du nom de fichier</li>
+
+ <li><code>O=A</code> trie l'affichage selon l'ordre croissant</li>
+
+ <li class="separate"><code>O=D</code> trie l'affichage selon
+ l'ordre décroissant</li>
+
+ <li><code>F=0</code> affiche le listing sous la forme d'une simple
+ liste (sans FancyIndex)</li>
+
+ <li><code>F=1</code> affiche le listing avec en-têtes de colonnes
+ sous forme de liens hyper-textes (FancyIndexed)</li>
+
+ <li class="separate"><code>F=2</code> affiche le listing sous
+ forme de table HTML avec en-têtes de colonnes contenant des liens
+ hyper-textes (FancyIndexed)</li>
+
+ <li><code>V=0</code> désactive le tri en fonction de la
+ version</li>
+
+ <li class="separate"><code>V=1</code> active le tri en fonction de
+ la version</li>
+
+ <li><code>P=<var>modèle</var></code> n'affiche que les fichiers
+ correspondant au <var>modèle</var> spécifié</li>
+ </ul>
+
+ <p>Notez que l'argument 'P' (pour Pattern) n'est testé
+ qu'<em>après</em> que les directives habituelles <directive
+ module="mod_autoindex">IndexIgnore</directive> ont été traitées,
+ et que tous les noms de fichiers sont encore assujettis aux mêmes
+ critères que pour tout autre listing auto-indexé. L'interpréteur
+ d'arguments de requête de <module>mod_autoindex</module> s'arrête
+ immédiatement s'il rencontre une option non reconnue. Les arguments
+ de requête doivent être bien formés, selon la table ci-dessus.</p>
+
+ <p>Les options de requêtes sont illustrées par l'exemple ci-dessous,
+ qui peut être copié et collé dans un fichier header.html. Notez que
+ l'argument inconnu "X", pour le bouton submit, est introduit en
+ dernier afin de s'assurer que tous les arguments ont été
+ interprétés avant que mod_autoindex ne rencontre l'entrée X=Go.</p>
+
+ <example>
+ <form action="" method="get"><br />
+ <indent>
+ Montre moi une <select name="F"><br />
+ <indent>
+ <option value="0"> liste simple</option><br />
+ <option value="1" selected="selected"> liste avec
+ en-têtes</option><br />
+ <option value="2"> liste avec en-tête sous forme de
+ table</option><br />
+ </indent>
+ </select><br />
+ triée par <select name="C"><br />
+ <indent>
+ <option value="N" selected="selected"> nom</option><br />
+ <option value="M"> date de modification</option><br />
+ <option value="S"> taille</option><br />
+ <option value="D"> description</option><br />
+ </indent>
+ </select><br />
+ <select name="O"><br />
+ <indent>
+ <option value="A" selected="selected"> croissant</option><br />
+ <option value="D"> décroissant</option><br />
+ </indent>
+ </select><br />
+ <select name="V"><br />
+ <indent>
+ <option value="0" selected="selected"> dans l'ordre
+ normal</option><br />
+ <option value="1"> en fonction de la version</option><br />
+ </indent>
+ </select><br />
+ correspondant à <input type="text" name="P" value="*" /><br />
+ <input type="submit" name="X" value="Go" /><br />
+ </indent>
+ </form>
+ </example>
+
+</section>
+
+<directivesynopsis>
+<name>AddAlt</name>
+<description>Texte optionnel à afficher à la place d'un icône pour un
+fichier en fonction de son nom</description>
+<syntax>AddAlt <var>texte</var> <var>fichier</var> [<var>fichier</var>] ...</syntax>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context>
+</contextlist>
+<override>Indexes</override>
+
+<usage>
+ <p>La directive <directive>AddAlt</directive> permet d'afficher un
+ texte optionnel pour un fichier, à la place d'un icône, dans le cas
+ d'un affichage <code><a
+ href="#indexoptions.fancyindexing">FancyIndexing</a></code>.
+ <var>fichier</var> est une extension de fichier, un nom de fichier
+ partiel, une expression avec caractères génériques ou un nom de
+ fichier complet permettant de caractériser le(s) fichier(s)
+ concerné(s). Si <var>texte</var> contient des espaces, vous devez
+ l'entourer de guillemets ou d'apostrophes (<code>"</code> ou
+ <code>'</code>). Ce texte optionnel sera affiché si le client ne
+ peut pas afficher d'images, si le chargement d'images est désactivé
+ ou si l'icône ne peut pas être trouvé.</p>
+
+ <example><title>Exemples</title>
+ AddAlt "Fichier PDF" *.pdf<br />
+ AddAlt Compressé *.gz *.zip *.Z
+ </example>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>AddAltByEncoding</name>
+<description>Texte optionnel à afficher à la place d'un icône pour un
+fichier en fonction de son codage MIME</description>
+<syntax>AddAltByEncoding <var>texte</var> <var>codage MIME</var>
+[<var>codage MIME</var>] ...</syntax>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context>
+</contextlist>
+<override>Indexes</override>
+
+<usage>
+ <p>La directive <directive>AddAltByEncoding</directive> permet
+ d'afficher un texte optionnel à la place d'un icône pour un fichier
+ dans le cas d'un affichage <code><a
+ href="#indexoptions.fancyindexing">FancyIndexing</a></code>.
+ <var>codage MIME</var> doit être un type valide, comme
+ <code>x-compress</code>. Si <var>texte</var> contient des espaces,
+ vous devez l'entourer de guillemets ou d'apostrophes (<code>"</code>
+ ou <code>'</code>). Ce texte optionnel sera affiché si le client ne
+ peut pas afficher d'images, si le chargement d'images est désactivé
+ ou si l'icône ne peut pas être trouvé.</p>
+
+ <example><title>Exemple</title>
+ AddAltByEncoding gzip x-gzip
+ </example>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>AddAltByType</name>
+<description>Texte optionnel à afficher à la place d'un icône pour un
+fichier en fonction de son type MIME</description>
+<syntax>AddAltByType <var>texte</var> <var>type MIME</var>
+[<var>type MIME</var>] ...</syntax>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context>
+</contextlist>
+<override>Indexes</override>
+
+<usage>
+ <p>La directive <directive>AddAltByType</directive> permet
+ d'afficher un texte optionnel à la place d'un icône pour un fichier
+ dans le cas d'un affichage <code><a
+ href="#indexoptions.fancyindexing">FancyIndexing</a></code>.
+ <var>type MIME</var> doit être un type MIME valide, comme
+ <code>text/html</code>. Si <var>texte</var> contient des espaces,
+ vous devez l'entourer de guillemets ou d'apostrophes (<code>"</code>
+ ou <code>'</code>). Ce texte optionnel sera affiché si le client ne
+ peut pas afficher d'images, si le chargement d'images est désactivé
+ ou si l'icône ne peut pas être trouvé.</p>
+
+ <example><title>Exemple</title>
+ AddAltByType 'Fichier texte' text/plain
+ </example>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>AddDescription</name>
+<description>Afficher la description d'un fichier</description>
+<syntax>AddDescription <var>texte</var> [<var>fichier</var>] ...</syntax>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context>
+</contextlist>
+<override>Indexes</override>
+
+<usage>
+ <p>Cette directive permet d'afficher une description pour un
+ fichier, dans le cas d'un affichage <code><a
+ href="#indexoptions.fancyindexing">FancyIndexing</a></code>.
+ <var>fichier</var> est une extension de fichier, un nom de fichier
+ partiel, une expression avec caractères génériques ou un nom de
+ fichier complet permettant de caractériser le fichier.
+ <var>texte</var> doit être entouré de guillemets
+ (<code>"</code>).</p>
+
+ <example><title>Exemple</title>
+ AddDescription "La planète Mars" /web/pics/mars.gif
+ </example>
+
+ <p>La taille par défaut, habituelle du champ de description est de
+ 23 octets. L'option <code><a href="#indexoptions.suppressicon"
+ >IndexOptions SuppressIcon</a></code> ajoute 6 octets, l'option
+ <code><a href="#indexoptions.suppresssize">IndexOptions
+ SuppressSize</a></code> en ajoute 7 et l'option <code><a
+ href="#indexoptions.suppresslastmodified">IndexOptions
+ SuppressLastModified</a></code> en ajoute 19. Ainsi, la plus grande
+ taille par défaut qui peut être assignée à la colonne description
+ est de 55 octets.</p>
+
+ <p>Voir le mot-clé <a href="#indexoptions.descriptionwidth"
+ >DescriptionWidth</a> de la directive <directive
+ >module="mod_autoindex">IndexOptions</directive> pour plus de
+ détails sur la manière d'augmenter la taille de cette colonne, ou
+ pour permettre des descriptions de taille illimitée.</p>
+
+ <note><title>Avertissement</title>
+ <p>Le texte descriptif défini par la directive
+ <directive>AddDescription</directive> peut contenir des marquages
+ HTML, comme des balises ou des entités caractères. Si la limite de
+ taille de la colonne description venait à tronquer une balise (par
+ exemple couper la fin d'une phrase en caractères gras), le
+ résultat pourrait en affecter toute la suite du listing du
+ répertoire.</p>
+ </note>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>AddIcon</name>
+<description>Icône à afficher pour un fichier en fonction de son
+nom</description>
+<syntax>AddIcon <var>icône</var> <var>nom</var> [<var>nom</var>]
+...</syntax>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context>
+</contextlist>
+<override>Indexes</override>
+
+<usage>
+ <p>Cette directive permet de déterminer l'icône à afficher à côté
+ d'un fichier dont le nom se termine par <var>nom</var>, dans le cas
+ d'un affichage <code><a href="#indexoptions.fancyindexing"
+ >FancyIndexing</a></code>. <var>icône</var> est soit une URL relative
+ (échappée par des caractères '%') vers l'icône, soit de la forme
+ <code>(<var>alttext</var>,<var>url</var>)</code>, où
+ <var>alttext</var> est le symbole texte correspondant à l'icône à
+ afficher dans les navigateurs en mode texte.</p>
+
+ <p><var>nom</var> correspond à <code>^^DIRECTORY^^</code> pour les
+ répertoires, <code>^^BLANKICON^^</code> pour les lignes vides
+ (pour personnaliser la présentation du listing), une extension de
+ fichier, une expression avec caractères génériques, un nom de
+ fichier partiel ou un nom de fichier complet.</p>
+
+ <example><title>Exemples</title>
+ AddIcon (IMG,/icons/image.xbm) .gif .jpg .xbm<br />
+ AddIcon /icons/dir.xbm ^^DIRECTORY^^<br />
+ AddIcon /icons/backup.xbm *~
+ </example>
+
+ <p>Lorsque c'est possible, il est préférable d'utiliser <directive
+ module="mod_autoindex">AddIconByType</directive> plutôt que
+ <directive>AddIcon</directive>.</p>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>AddIconByEncoding</name>
+<description>Icône à afficher à côté d'un fichier en fonction de son
+codage MIME</description>
+<syntax>AddIconByEncoding <var>icône</var> <var>codage MIME</var>
+[<var>codage MIME</var>] ...</syntax>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context>
+</contextlist>
+<override>Indexes</override>
+
+<usage>
+ <p>Cette directive permet de déterminer l'icône à afficher à côté
+ d'un fichier dans le cas d'un affichage <code><a
+ href="#indexoptions.fancyindexing">FancyIndexing</a></code>.
+ <var>icône</var> est soit une URL relative
+ (échappée par des caractères '%') vers l'icône, soit de la forme
+ <code>(<var>alttext</var>,<var>url</var>)</code>, où
+ <var>alttext</var> est le symbole texte correspondant à l'icône à
+ afficher dans les navigateurs en mode texte.</p>
+
+ <p><var>codage MIME</var> doit être un codage valide, comme
+ <code>x-compress</code>.</p>
+
+ <example><title>Exemple</title>
+ AddIconByEncoding /icons/compress.xbm x-compress
+ </example>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>AddIconByType</name>
+<description>Icône à afficher à côté d'un fichier en fonction de son
+type MIME</description>
+<syntax>AddIconByType <var>icône</var> <var>type MIME</var>
+[<var>type MIME</var>] ...</syntax>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context>
+</contextlist>
+<override>Indexes</override>
+
+<usage>
+ <p>Cette directive permet de déterminer l'icône à afficher à côté
+ d'un fichier de type MIME <var>type MIME</var> dans le cas d'un
+ affichage <code><a
+ href="#indexoptions.fancyindexing">FancyIndexing</a></code>.
+ <var>icône</var> est soit une URL relative
+ (échappée par des caractères '%') vers l'icône, soit de la forme
+ <code>(<var>alttext</var>,<var>url</var>)</code>, où
+ <var>alttext</var> est le symbole texte correspondant à l'icône à
+ afficher dans les navigateurs en mode texte.</p>
+
+ <p><var>type MIME</var> est une expression avec caractères
+ génériques représentant le type MIME.</p>
+
+ <example><title>Exemple</title>
+ AddIconByType (IMG,/icons/image.xbm) image/*
+ </example>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>DefaultIcon</name>
+<description>Icône à afficher par défaut lorsqu'aucun icône spécifique
+n'est précisé</description>
+<syntax>DefaultIcon <var>chemin URL</var></syntax>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context>
+</contextlist>
+<override>Indexes</override>
+
+<usage>
+ <p>La directive <directive>DefaultIcon</directive> permet de définir
+ l'icône à afficher à côté d'un fichier lorsqu'aucun icône spécifique
+ n'a été précisé, dans le cas d'un affichage <code><a
+ href="#indexoptions.fancyindexing">FancyIndexing</a></code>.
+ <var>chemin URL</var> est une URL relative (échappée par des
+ caractères '%') vers l'icône.</p>
+
+ <example><title>Exemple</title>
+ DefaultIcon /icon/inconnu.xbm
+ </example>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>HeaderName</name>
+<description>Nom du fichier qui sera inséré au début de la page
+contenant l'index</description>
+<syntax>HeaderName <var>nom fichier</var></syntax>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context>
+</contextlist>
+<override>Indexes</override>
+
+<usage>
+ <p>La directive <directive>HeaderName</directive> permet de définir
+ le nom du fichier qui sera inséré au début de la page contenant
+ l'index. <var>nom fichier</var> est le nom du fichier à inclure.</p>
+
+ <example><title>Exemple</title>
+ HeaderName HEADER.html
+ </example>
+
+ <note>
+ <p>Les deux directives HeaderName et <directive
+ module="mod_autoindex">ReadmeName</directive> traitent maintenant
+ <var>nom fichier</var> comme un chemin URI relatif au chemin
+ utilisé pour accéder au répertoire faisant l'objet de l'index. Si
+ <var>nom fichier</var> commence par un slash '/', il sera
+ considéré comme relatif au répertoire défini par la directive
+ <directive module="core">DocumentRoot</directive>.</p>
+
+ <example><title>Exemple</title>
+ HeaderName /include/HEADER.html
+ </example>
+
+ <p><var>nom fichier</var> doit correspondre à un document dont le
+ type MIME est du style <code>text/*</code> (<em>par exemple</em>
+ <code>text/html</code>, <code>text/plain</code>, etc...). Cela
+ signifie que <var>nom fichier</var> peut faire référence à un
+ script CGI si le véritable type MIME du script (et non celui de sa
+ sortie) est marqué comme <code>text/html</code> par exemple à
+ l'aide d'une directive comme :</p>
+
+ <example>
+ AddType text/html .cgi
+ </example>
+
+ <p>Une <a href="../content-negotiation.html">négociation de
+ contenu</a> sera effectuée si <directive
+ module="core">Options</directive> <code>MultiViews</code> a été
+ précisé. Si <var>nom fichier</var> correspond à un document
+ statique <code>text/html</code> (et non à un script CGI), et une
+ des deux <directive module="core">options</directive>
+ <code>Includes</code> ou <code>IncludesNOEXEC</code> est activée,
+ le fichier sera traité en tant qu'inclusion côté serveur (Server
+ Side Include) (voir la documentation de
+ <module>mod_include</module>).</p>
+ </note>
+
+ <p>Si le fichier spécifié par la directive
+ <directive>HeaderName</directive> contient les en-têtes d'un
+ document HTML ((<html>, <head>, etc...), vous serez
+ probablement amené à définir <a
+ href="#indexoptions.suppresshtmlpreamble"><code>IndexOptions
+ +SuppressHTMLPreamble</code></a>, de manière à ce que ces balises ne
+ soient pas répétées.</p>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>IndexIgnore</name>
+<description>Ajouts à la liste des fichiers à cacher lors de l'affichage
+de l'index d'un répertoire</description>
+<syntax>IndexIgnore <var>fichier</var> [<var>fichier</var>] ...</syntax>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context>
+</contextlist>
+<override>Indexes</override>
+
+<usage>
+ <p>La directive <directive>IndexIgnore</directive> permet
+ d'effectuer des ajouts à la liste des fichiers à cacher lors de
+ l'affichage de l'index d'un répertoire. <var>fichier</var> est une
+ expression avec caractères génériques de style shell ou un nom de
+ fichier complet. Plusieurs directives IndexIgnore effectuent des
+ ajouts à la liste, et ne remplacent pas la liste des fichiers à
+ ignorer. Par défaut, la liste contient <code>.</code> (le répertoire
+ courant).</p>
+
+ <example>
+ IndexIgnore README .htaccess *.bak *~
+ </example>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>IndexOptions</name>
+<description>Diverses options de configuration pour l'indexation d'un
+répertoire</description>
+<syntax>IndexOptions [+|-]<var>option</var> [[+|-]<var>option</var>]
+...</syntax>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context>
+</contextlist>
+<override>Indexes</override>
+
+<usage>
+ <p>La directive <directive>IndexOptions</directive> permet de
+ spécifier les options de configuration de l'indexation du
+ répertoire. <var>option</var> peut prendre l'une des valeurs
+ suivantes :</p>
+
+ <dl>
+ <dt><a name="indexoptions.charset"
+ id="indexoptions.charset"
+ >Charset=<var>jeu de caractères</var></a> (<em>Versions 2.0.61 et
+ supérieures d'Apache</em>)</dt>
+
+ <dd>Le mot-clé <code>Charset</code> vous permet de spécifier le
+ jeu de caractères de la page générée. La valeur par défaut est
+ soit <var>UTF-8</var>, <var>ISO-8859-1</var>, selon que le
+ système de fichiers sous-jacent est unicode ou non.
+
+ <example><title>Exemple :</title>
+ IndexOptions Charset=UTF-8
+ </example>
+ </dd>
+
+ <dt><a name="indexoptions.type"
+ id="indexoptions.type"
+ >Type=<var>type MIME</var></a> (<em>Versions 2.0.61 et
+ supérieures d'Apache</em>)</dt>
+
+ <dd>Le mot-clé <code>Type</code> vous permet de spécifier le type
+ MIME de la page générée. La valeur par défaut est
+ <var>text/html</var>.
+
+ <example><title>Exemple :</title>
+ IndexOptions Type=text/plain
+ </example>
+ </dd>
+
+ <dt><a name="indexoptions.descriptionwidth"
+ id="indexoptions.descriptionwidth"
+ >DescriptionWidth=[<var>n</var> | *]</a> (<em>Versions 2.0.23 et
+ supérieures d'Apache</em>)</dt>
+
+ <dd>Le mot-clé <code>DescriptionWidth</code> vous permet de
+ spécifier la taille en caractères de la colonne description.</dd>
+
+ <dd>Avec <code>-DescriptionWidth</code> (ou si l'option n'est pas
+ définie), <module>mod_autoindex</module> calcule la meilleure
+ taille.</dd>
+
+ <dd><code>DescriptionWidth=<var>n</var></code> fixe la taille de
+ la colonne à <var>n</var> octets.</dd>
+
+ <dd><code>DescriptionWidth=*</code> ajuste la taille de la colonne
+ à la plus longue chaîne de description.</dd>
+
+ <dd><strong>Voir la section concernant <directive
+ module="mod_autoindex">AddDescription</directive> pour les dangers
+ inhérants à la troncature des descriptions.</strong></dd>
+
+ <dt><a name="indexoptions.fancyindexing"
+ id="indexoptions.fancyindexing">FancyIndexing</a></dt>
+
+ <dd>Cette option active l'indexation "améliorée" des répertoires,
+ c'est à dire avec en-têtes de colonnes sous forme d'hyper-liens
+ auto-référants.</dd>
+
+ <dt><a name="indexoptions.foldersfirst"
+ id="indexoptions.foldersfirst">FoldersFirst</a> (<em>Versions 2.0.23 et
+ supérieures d'Apache</em>)</dt>
+
+ <dd>Lorsque cette option est activée, la liste des
+ sous-répertoires apparaîtra <em>toujours</em> en premier, suivie
+ de la liste des fichiers normaux du répertoire. Le listing
+ comporte principalement deux parties, les fichiers et les
+ sous-répertoires, chacun d'eux étant trié séparément et les
+ sous-répertoires affichés en premier. Par exemple, si l'ordre de
+ tri est décroissant par nom, et si <code>FoldersFirst</code> est
+ activé, le sous-répertoire <code>Zed</code> sera affiché avant le
+ sous-répertoire <code>Beta</code>, qui sera lui-même affiché avant
+ les fichiers normaux <code>Gamma</code> et <code>Alpha</code>.
+ <strong>Cette option n'a d'effet que si <a
+ href="#indexoptions.fancyindexing"><code>FancyIndexing</code></a>
+ est aussi activé.</strong></dd>
+
+ <dt><a name="indexoptions.htmltable"
+ id="indexoptions.htmltable">HTMLTable</a>
+ (<em>Expérimental, versions 2.0.23 et supérieures
+ d'Apache</em>)</dt>
+
+ <dd>Cette option expérimentale pour l'affichage
+ <code>FancyIndexing</code> permet de construire une table simple
+ pour l'affichage de l'index du répertoire. Notez que cela risque
+ de perturber les anciens navigateurs. Cette option s'avèrera
+ particulièrement nécessaire si les noms de fichiers ou les chaînes
+ de description alternent entre les ordres de lecture gauche à
+ droite et droite à gauche, comme cela peut arriver sous WinNT ou
+ d'autres plate-formes où utf-8 est activé.</dd>
+
+ <dt><a name="indexoptions.iconsarelinks"
+ id="indexoptions.iconsarelinks">IconsAreLinks</a></dt>
+
+ <dd>Configure la partie réservée aux icônes de l'ancrage pour le
+ nom de fichier, dans le cas d'un affichage "amélioré".</dd>
+
+ <dt><a name="indexoptions.iconheight"
+ id="indexoptions.iconheight">IconHeight[=<var
+ >pixels</var>]</a></dt>
+
+ <dd>Si cette option est présente, en combinaison avec
+ <code>IconWidth</code>, le serveur va inclure les attributs
+ <code>height</code> et <code>width</code> dans la balise
+ <code>img</code> qui référence le fichier de l'icône. Ceci va
+ permettre au navigateur de prévoir les caractéristiques de la page
+ sans devoir attendre que toutes les images aient été chargées. En
+ l'absence de cette option, c'est la hauteur standard définie par
+ le logiciel Apache qui est choisie comme valeur par défaut.</dd>
+
+ <dt><a name="indexoptions.iconwidth"
+ id="indexoptions.iconwidth">IconWidth[=<var
+ >pixels</var>]</a></dt>
+
+ <dd>Si cette option est présente, en combinaison avec
+ <code>IconHeight</code>, le serveur va inclure les attributs
+ <code>height</code> et <code>width</code> dans la balise
+ <code>img</code> qui référence le fichier de l'icône. Ceci va
+ permettre au navigateur de prévoir les caractéristiques de la page
+ sans devoir attendre que toutes les images aient été chargées. En
+ l'absence de cette option, c'est la largeur standard définie par
+ le logiciel Apache qui est choisie comme valeur par défaut.</dd>
+
+ <dt><a name="indexoptions.ignorecase"
+ id="indexoptions.ignorecase">IgnoreCase</a></dt>
+
+ <dd>Si cette option est activée, les noms sont triés sans tenir
+ compte de la casse. Par exemple, si le tri s'effectue sur les noms
+ dans l'ordre croissant, et si <code>IgnoreCase</code> est activé,
+ le fichier Zeta apparaîtra après le fichier alfa (Note : le
+ fichier GAMMA apparaîtra toujours avant le fichier gamma).
+ </dd>
+
+ <dt><a name="indexoptions.ignoreclient"
+ id="indexoptions.ignoreclient">IgnoreClient</a></dt>
+
+ <dd>Si cette option est activée, <module>mod_autoindex</module> va
+ ignorer toutes les variables de requête fournies par le client, y
+ compris les informations de tri (ce qui implique l'activation de
+ l'option <code><a href="#indexoptions.suppresscolumnsorting"
+ >SuppressColumnSorting</a></code>).</dd>
+
+ <dt><a name="indexoptions.namewidth"
+ id="indexoptions.namewidth">NameWidth=[<var>n</var>
+ | *]</a></dt>
+
+ <dd>Le mot-clé <code>NameWidth</code> vous permet de spécifier la
+ largeur en octets de la colonne correspondant au nom du
+ fichier.</dd>
+
+ <dd>Avec <code>-NameWidth</code> (ou si l'option n'est pas
+ définie), <module
+ >mod_autoindex</module> va calculer la meilleure largeur
+ possible.</dd>
+
+ <dd><code>NameWidth=<var>n</var></code> fixe la largeur de la
+ colonne à <var>n</var> octets.</dd>
+
+ <dd><code>NameWidth=*</code> définit la largeur de colonne à la
+ valeur nécessaire.</dd>
+
+ <dt><a name="indexoptions.scanhtmltitles"
+ id="indexoptions.scanhtmltitles">ScanHTMLTitles</a></dt>
+
+ <dd>L'activation de cette option permet d'extraire le titre des
+ documents HTML dans le cas d'un affichage "amélioré". Si le fichier
+ ne possède aucune description définie par la directive <directive
+ module="mod_autoindex">AddDescription</directive>, httpd va lire
+ le document pour tenter d'en extraire le <code>titre</code>. Ce
+ processus est coûteux en ressources disque et CPU.</dd>
+
+ <dt><a name="indexoptions.showforbidden"
+ id="indexoptions.showforbidden">ShowForbidden</a></dt>
+
+ <dd>Si cette option est activée, Apache affichera les fichiers
+ normalement cachés suite au retour des valeurs
+ <code>HTTP_UNAUTHORIZED</code> ou <code>HTTP_FORBIDDEN</code> par
+ la sous-requête.</dd>
+
+ <dt><a name="indexoptions.suppresscolumnsorting"
+ id="indexoptions.suppresscolumnsorting"
+ >SuppressColumnSorting</a></dt>
+
+ <dd>Si cette option est activée, Apache supprimera les liens
+ hyper-texte dans les en-têtes de colonnes dans le cas d'un
+ affichage "amélioré". Par défaut, ces en-têtes constituent des liens
+ hyper-texte, et la sélection de l'un d'entre eux va trier l'index
+ du répertoire en fonction des valeurs de la colonne
+ correspondante. <strong>Avant
+ Apache 2.0.23, cette option désactivait aussi l'interprétation des
+ informations de tri transmises via les arguments de la
+ requête.</strong> Depuis Apache 2.0.23, ce comportement est
+ contrôlé par <a
+ href="#indexoptions.ignoreclient"><code>IndexOptions
+ IgnoreClient</code></a>.</dd>
+
+ <dt><a name="indexoptions.suppressdescription"
+ id="indexoptions.suppressdescription"
+ >SuppressDescription</a></dt>
+
+ <dd>L'activation de cette option va supprimer la description des
+ fichiers dans le cas d'un affichage "amélioré". Par défaut aucune
+ description de fichier n'est définie, et par conséquent
+ l'utilisation de cette option va permettre de récupérer un espace
+ à l'écran de 23 caractères pouvant être utilisé pour autre chose.
+ Voir la directive <directive module="mod_autoindex"
+ >AddDescription</directive> pour plus d'informations à propos de
+ la définition des descriptions de fichiers. Voir aussi l'option
+ d'index <code><a
+ href="#indexoptions.descriptionwidth">DescriptionWidth</a></code>
+ pour limiter la taille de la colonne description.</dd>
+
+ <dt><a name="indexoptions.suppresshtmlpreamble"
+ id="indexoptions.suppresshtmlpreamble"
+ >SuppressHTMLPreamble</a></dt>
+
+ <dd>Si le répertoire contient effectivement le fichier spécifié
+ par la directive <directive
+ module="mod_autoindex">HeaderName</directive>, le module inclut
+ en général le contenu du fichier après avoir inséré un préambule
+ HTML standard (<code><html></code>,
+ <code><head></code>, <em>etc...</em>). L'activation de
+ l'option <code>SuppressHTMLPreamble</code> supprime l'insertion de
+ ce préambule, et le module va alors commencer l'affichage
+ directement par le contenu du fichier d'en-tête. Dans ce cas par
+ contre, le fichier d'en-tête doit contenir des instructions HTML
+ appropriées. S'il n'y a pas de fichier d'en-tête, le préambule est
+ généré comme dans le cas général.</dd>
+
+ <dt><a name="indexoptions.suppressicon"
+ id="indexoptions.suppressicon">SuppressIcon</a>
+ (<em>Versions 2.0.23 et supérieures d'Apache</em>)</dt>
+
+ <dd>L'activation de cette option supprime l'affichage des icônes
+ dans le cas d'un affichage "amélioré". La combinaison de
+ <code>SuppressIcon</code> et <code>SuppressRules</code> permet de
+ générer une sortie au format HTML 3.2 qui, selon les dernières
+ spécifications, interdit les éléments <code>img</code> et
+ <code>hr</code> dans les blocs <code>pre</code> (utilisés pour
+ formater les affichages "améliorés").</dd>
+
+ <dt><a name="indexoptions.suppresslastmodified"
+ id="indexoptions.suppresslastmodified"
+ >SuppressLastModified</a></dt>
+
+ <dd>L'activation de cette option supprime l'affichage de la date
+ de dernière modification dans le cas d'un affichage "amélioré".</dd>
+
+ <dt><a name="indexoptions.suppressrules"
+ id="indexoptions.suppressrules">SuppressRules</a>
+ (<em>Versions 2.0.23 et supérieures d'Apache</em>)</dt>
+
+ <dd>L'activation de cette option supprime l'affichage des lignes
+ horizontales (éléments <code>hr</code>) dans les index de
+ répertoires. La combinaison de
+ <code>SuppressIcon</code> et <code>SuppressRules</code> permet de
+ générer une sortie au format HTML 3.2 qui, selon les dernières
+ spécifications, interdit les éléments <code>img</code> et
+ <code>hr</code> dans les blocs <code>pre</code> (utilisés pour
+ formater les affichages "améliorés").</dd>
+
+ <dt><a name="indexoptions.suppresssize"
+ id="indexoptions.suppresssize">SuppressSize</a></dt>
+
+ <dd>L'activation de cette option supprime l'affichage de la taille
+ du fichier dans le cas d'un affichage "amélioré".</dd>
+
+ <dt><a name="indexoptions.trackmodified"
+ id="indexoptions.trackmodified">TrackModified</a>
+ (<em>Versions 2.0.23 et supérieures d'Apache</em>)</dt>
+
+ <dd>Cette option renvoie les valeurs <code>Last-Modified</code> et
+ <code>ETag</code> pour le répertoire indexé dans l'en-tête HTTP.
+ Elle n'est valide que si le système d'exploitation et le système
+ de fichiers renvoient des résultats appropriés pour la fonction
+ stat(). C'est le cas de certains systèmes Unix, ainsi que JFS sous
+ OS/2 ou
+ les volumes NTFS sous Win32. Ce n'est par contre pas le cas
+ des volumes FAT Win32 et OS/2. Lorsque cette option est activée, le
+ client ou le mandataire peuvent détecter les changements dans la
+ liste des fichiers lorsqu'ils effectuent une requête
+ <code>HEAD</code>. Notez que certains systèmes d'exploitation
+ détectent correctement les nouveaux fichiers et les fichiers
+ supprimés, mais ne détectent pas les modifications de tailles ou
+ de dates des fichiers du répertoire. <strong>Les modifications de
+ taille ou de date d'un fichier existant ne mettent pas à jour
+ l'en-tête <code>Last-Modified</code> sur toutes les plate-formes
+ Unix.</strong> Si c'est le cas, laissez cette option
+ désactivée.</dd>
+
+ <dt><a name="indexoptions.versionsort"
+ id="indexoptions.versionsort">VersionSort</a>
+ (<em>Apache 2.0a3 and later</em>)</dt>
+
+ <dd>Le mot-clé <code>VersionSort</code> permet de trier les
+ fichiers contenant des numéros de version d'une manière
+ spécifique. Les chaînes sont triées comme d'habitude, excepté les
+ sous-chaînes de chiffres du nom de fichier et de sa description
+ qui sont comparées en fonction de leur valeur numérique.
+
+ <example><title>Exemple :</title>
+ foo-1.7<br />
+ foo-1.7.2<br />
+ foo-1.7.12<br />
+ foo-1.8.2<br />
+ foo-1.8.2a<br />
+ foo-1.12
+ </example>
+
+ <p>Si le nombre commence par le chiffre 0, il est considéré comme
+ la partie fractionnaire d'un nombre :</p>
+
+ <example>
+ foo-1.001<br />
+ foo-1.002<br />
+ foo-1.030<br />
+ foo-1.04
+ </example>
+ </dd>
+
+ <dt><a name="indexoptions.xhtml"
+ id="indexoptions.xhtml">XHTML</a>
+ (<em>Versions 2.0.49 et supérieures d'Apache</em>)</dt>
+
+ <dd>Le mot-clé <code>XHTML</code> enjoint
+ <module>mod_autoindex</module> de générer du code XHTML 1.0 au
+ lieu de HTML 3.2.</dd>
+ </dl>
+
+ <!--
+ XXX: we should consider to allow sections inside <usage>
+ this would require some xslt changes...
+ -->
+ <dl><dt>Options d'index incrémentales</dt>
+ <dd>
+ <p>Apache 1.3.3 a apporté d'importantes modifications dans la
+ gestion des directives <directive>IndexOptions</directive>. En
+ particulier :</p>
+
+ <ul>
+ <li>Plusieurs directives <directive>IndexOptions</directive>
+ apparaissant dans la même section directory sont maintenant
+ fusionnées. Le résultat de :
+
+ <example>
+ <Directory /foo>
+ <indent>
+ IndexOptions HTMLTable<br />
+ IndexOptions SuppressColumnsorting
+ </indent>
+ </Directory>
+ </example>
+
+ <p>est équivalent à</p>
+
+ <example>
+ IndexOptions HTMLTable SuppressColumnsorting
+ </example>
+ </li>
+
+ <li>L'ajout de la syntaxe incrémentale (en préfixant les mots-clés
+ avec <code>+</code> ou <code>-</code>).</li>
+ </ul>
+
+ <p>Chaque fois qu'un mot-clé préfixé par '+' ou '-' est trouvé, il
+ est appliqué aux définitions des
+ <directive>IndexOptions</directive> courantes (qui ont été
+ éventuellement héritées d'un directory de niveau supérieur). Par
+ contre, si un mot-clé non préfixé est trouvé, il supprime toutes
+ les definitions héritées, ainsi que toute
+ définition incrémentale. Considérons l'exemple
+ suivant :</p>
+
+ <example>
+ IndexOptions +ScanHTMLTitles -IconsAreLinks FancyIndexing<br />
+ IndexOptions +SuppressSize
+ </example>
+
+ <p>L'effet global est équivalent à l'effet qu'aurait provoqué
+ <code>IndexOptions FancyIndexing +SuppressSize</code>, car l'option
+ non préfixée <code>FancyIndexing</code> annule les mots-clés
+ incrémentaux situés avant elle, mais leur permet ensuite de
+ s'incrémenter à nouveau.</p>
+
+ <p>Pour définir inconditionnellement les
+ <directive>IndexOptions</directive> pour un répertoire particulier,
+ tout en supprimant les définitions héritées, spécifiez les
+ mots-clés sans préfixe <code>+</code> ou <code>-</code></p>
+ </dd>
+ </dl>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>IndexOrderDefault</name>
+<description>Définit l'ordre d'affichage par défaut d'un index de
+répertoire</description>
+<syntax>IndexOrderDefault Ascending|Descending
+Name|Date|Size|Description</syntax>
+<default>IndexOrderDefault Ascending Name</default>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context>
+</contextlist>
+<override>Indexes</override>
+
+<usage>
+ <p>La directive <directive>IndexOrderDefault</directive> s'utilise
+ en combinaison avec l'option d'index <code><a
+ href="#indexoptions.fancyindexing">FancyIndexing</a></code>. Par
+ défaut, les index de répertoires "améliorés" sont affichés selon l'ordre
+ croissant des noms de fichiers ; la directive
+ <directive>IndexOrderDefault</directive> vous permet de modifier ce
+ comportement.</p>
+
+ <p>La directive <directive>IndexOrderDefault</directive> accepte
+ deux arguments. Le premier est soit <code>Ascending</code>, soit
+ <code>Descending</code>, et indique l'ordre de tri. Le second doit
+ prendre une des valeurs <code>Name</code>, <code>Date</code>,
+ <code>Size</code>, ou <code>Description</code>, et permet
+ d'identifier la clé primaire. La clé secondaire est
+ <em>toujours</em> le nom du fichier selon un ordre croissant.</p>
+
+ <p>Vous pouvez forcer l'affichage de l'index d'un répertoire selon
+ un certain ordre en utilisant la directive
+ <directive>IndexOrderDefault</directive> conjointement avec l'option
+ d'index <code><a href="#indexoptions.suppresscolumnsorting"
+ >SuppressColumnSorting</a></code> ; ceci aura pour effet d'ignorer
+ les demandes d'affichage de l'index du répertoire par le client
+ selon un ordre différent.</p>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>IndexStyleSheet</name>
+<description>Ajoute une feuille de style CSS à l'index du
+répertoire</description>
+<syntax>IndexStyleSheet <var>chemin-url</var></syntax>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context>
+</contextlist>
+<override>Indexes</override>
+
+<usage>
+ <p>La directive <directive>IndexStyleSheet</directive> permet de
+ définir le nom du fichier qui servira de feuille de style CSS pour
+ l'index.
+ </p>
+ <example>
+ <title>Exemple</title>
+ IndexStyleSheet "/css/style.css"
+ </example>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>IndexHeadInsert</name>
+<description>Insère du texte dans la section HEAD de la page
+d'index.</description>
+<syntax>IndexHeadInsert <var>"marque ..."</var></syntax>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context>
+</contextlist>
+<override>Indexes</override>
+
+<usage>
+ <p>La directive <directive>IndexHeadInsert</directive> permet de
+ spécifier une chaîne de caractères à insérer dans la section
+ <var><head></var> du code HTML généré pour la page
+ d'index.</p>
+ <example>
+ <title>Exemple</title>
+ IndexHeadInsert "<link rel=\"sitemap\" href=\"/sitemap.html\">"
+ </example>
+</usage>
+</directivesynopsis>
+
+<directivesynopsis>
+<name>ReadmeName</name>
+<description>Nom du fichier dont le contenu sera inséré à la fin de
+l'index</description>
+<syntax>ReadmeName <var>nom-fichier</var></syntax>
+<contextlist><context>server config</context><context>virtual host</context>
+<context>directory</context><context>.htaccess</context>
+</contextlist>
+<override>Indexes</override>
+
+<usage>
+ <p>La directive <directive>ReadmeName</directive> permet de définir
+ le nom du fichier dont le contenu sera ajouté à la fin de l'index.
+ <var>nom-fichier</var> est le nom du fichier à inclure, et est
+ considéré comme relatif au répertoire faisant l'objet de l'index. Si
+ <var>nom-fichier</var> commence par un slash '/', il sera considéré
+ comme relatif au répertoire défini par la directive <directive
+ module="core">DocumentRoot</directive>.
+ </p>
+
+ <example><title>Exemple</title>
+ ReadmeName FOOTER.html
+ </example>
+
+ <example><title>Exemple 2</title>
+ ReadmeName /include/FOOTER.html
+ </example>
+
+ <p>Voir aussi la directive <directive module="mod_autoindex"
+ >HeaderName</directive>, où cette fonctionnalité est décrite plus en
+ détails.</p>
+</usage>
+</directivesynopsis>
+
+</modulesynopsis>
Modified: httpd/httpd/trunk/docs/manual/mod/mod_autoindex.xml.meta
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_autoindex.xml.meta?rev=821517&r1=821516&r2=821517&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/mod_autoindex.xml.meta (original)
+++ httpd/httpd/trunk/docs/manual/mod/mod_autoindex.xml.meta Sun Oct 4 11:48:30 2009
@@ -8,6 +8,7 @@
<variants>
<variant>en</variant>
+ <variant>fr</variant>
<variant outdated="yes">ja</variant>
<variant outdated="yes">ko</variant>
<variant>tr</variant>