--- /dev/null
+<?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>mod_autoindex - 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>
+<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="<-" alt="<-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.3</a> > <a href="./">Modules</a></div>
+<div id="page-content">
+<div id="preamble"><h1>Module Apache mod_autoindex</h1>
+<div class="toplang">
+<p><span>Langues Disponibles: </span><a href="../en/mod/mod_autoindex.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/mod/mod_autoindex.html" title="Français"> fr </a> |
+<a href="../ja/mod/mod_autoindex.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
+<a href="../ko/mod/mod_autoindex.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
+<a href="../tr/mod/mod_autoindex.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
+</div>
+<table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>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></td></tr>
+<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur de Module:</a></th><td>autoindex_module</td></tr>
+<tr><th><a href="module-dict.html#SourceFile">Fichier Source:</a></th><td>mod_autoindex.c</td></tr></table>
+<h3>Sommaire</h3>
+
+ <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 <code class="directive"><a href="../mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>. C'est le module
+ <code class="module"><a href="../mod/mod_dir.html">mod_dir</a></code> 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 <code class="directive"><a href="#addicon">AddIcon</a></code>, <code class="directive"><a href="#addiconbyencoding">AddIconByEncoding</a></code> et <code class="directive"><a href="#addiconbytype">AddIconByType</a></code> 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
+ <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> 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 <code class="directive"><a href="../mod/core.html#options">Options</a></code> pour plus de détails.</p>
+
+ <p>Si la directive <code class="directive"><a href="#indexoptions">IndexOptions</a></code> 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 <code class="directive"><a href="#indexoptions">IndexOptions</a></code>.</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>
+</div>
+<div id="quickview"><h3 class="directives">Directives</h3>
+<ul id="toc">
+<li><img alt="" src="../images/down.gif" /> <a href="#addalt">AddAlt</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#addaltbyencoding">AddAltByEncoding</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#addaltbytype">AddAltByType</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#adddescription">AddDescription</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#addicon">AddIcon</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#addiconbyencoding">AddIconByEncoding</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#addiconbytype">AddIconByType</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#defaulticon">DefaultIcon</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#headername">HeaderName</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#indexheadinsert">IndexHeadInsert</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#indexignore">IndexIgnore</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#indexoptions">IndexOptions</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#indexorderdefault">IndexOrderDefault</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#indexstylesheet">IndexStyleSheet</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#readmename">ReadmeName</a></li>
+</ul>
+<h3>Sujets</h3>
+<ul id="topics">
+<li><img alt="" src="../images/down.gif" /> <a href="#query">Arguments de la requête d'autoindexation</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="query" id="query">Arguments de la requête d'autoindexation</a></h2>
+
+
+ <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 <code class="directive"><a href="#indexignore">IndexIgnore</a></code> 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 <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> 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>
+
+ <div class="example"><p><code>
+ <form action="" method="get"><br />
+ <span class="indent">
+ Montre moi une <select name="F"><br />
+ <span class="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 />
+ </span>
+ </select><br />
+ triée par <select name="C"><br />
+ <span class="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 />
+ </span>
+ </select><br />
+ <select name="O"><br />
+ <span class="indent">
+ <option value="A" selected="selected"> croissant</option><br />
+ <option value="D"> décroissant</option><br />
+ </span>
+ </select><br />
+ <select name="V"><br />
+ <span class="indent">
+ <option value="0" selected="selected"> dans l'ordre
+ normal</option><br />
+ <option value="1"> en fonction de la version</option><br />
+ </span>
+ </select><br />
+ correspondant à <input type="text" name="P" value="*" /><br />
+ <input type="submit" name="X" value="Go" /><br />
+ </span>
+ </form>
+ </code></p></div>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="AddAlt" id="AddAlt">AddAlt</a> <a name="addalt" id="addalt">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Texte optionnel à afficher à la place d'un icône pour un
+fichier en fonction de son nom</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddAlt <var>texte</var> <var>fichier</var> [<var>fichier</var>] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
+<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>Indexes</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr>
+</table>
+ <p>La directive <code class="directive">AddAlt</code> 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>
+
+ <div class="example"><h3>Exemples</h3><p><code>
+ AddAlt "Fichier PDF" *.pdf<br />
+ AddAlt Compressé *.gz *.zip *.Z
+ </code></p></div>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="AddAltByEncoding" id="AddAltByEncoding">AddAltByEncoding</a> <a name="addaltbyencoding" id="addaltbyencoding">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Texte optionnel à afficher à la place d'un icône pour un
+fichier en fonction de son codage MIME</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddAltByEncoding <var>texte</var> <var>codage MIME</var>
+[<var>codage MIME</var>] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
+<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>Indexes</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr>
+</table>
+ <p>La directive <code class="directive">AddAltByEncoding</code> 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>
+
+ <div class="example"><h3>Exemple</h3><p><code>
+ AddAltByEncoding gzip x-gzip
+ </code></p></div>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="AddAltByType" id="AddAltByType">AddAltByType</a> <a name="addaltbytype" id="addaltbytype">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Texte optionnel à afficher à la place d'un icône pour un
+fichier en fonction de son type MIME</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddAltByType <var>texte</var> <var>type MIME</var>
+[<var>type MIME</var>] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
+<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>Indexes</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr>
+</table>
+ <p>La directive <code class="directive">AddAltByType</code> 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>
+
+ <div class="example"><h3>Exemple</h3><p><code>
+ AddAltByType 'Fichier texte' text/plain
+ </code></p></div>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="AddDescription" id="AddDescription">AddDescription</a> <a name="adddescription" id="adddescription">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Afficher la description d'un fichier</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddDescription <var>texte</var> [<var>fichier</var>] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
+<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>Indexes</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr>
+</table>
+ <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>
+
+ <div class="example"><h3>Exemple</h3><p><code>
+ AddDescription "La planète Mars" /web/pics/mars.gif
+ </code></p></div>
+
+ <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 <code class="directive">module="mod_autoindex">IndexOptions</code> 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>
+
+ <div class="note"><h3>Avertissement</h3>
+ <p>Le texte descriptif défini par la directive
+ <code class="directive">AddDescription</code> 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>
+ </div>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="AddIcon" id="AddIcon">AddIcon</a> <a name="addicon" id="addicon">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Icône à afficher pour un fichier en fonction de son
+nom</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddIcon <var>icône</var> <var>nom</var> [<var>nom</var>]
+...</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
+<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>Indexes</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr>
+</table>
+ <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>
+
+ <div class="example"><h3>Exemples</h3><p><code>
+ AddIcon (IMG,/icons/image.xbm) .gif .jpg .xbm<br />
+ AddIcon /icons/dir.xbm ^^DIRECTORY^^<br />
+ AddIcon /icons/backup.xbm *~
+ </code></p></div>
+
+ <p>Lorsque c'est possible, il est préférable d'utiliser <code class="directive"><a href="#addiconbytype">AddIconByType</a></code> plutôt que
+ <code class="directive">AddIcon</code>.</p>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="AddIconByEncoding" id="AddIconByEncoding">AddIconByEncoding</a> <a name="addiconbyencoding" id="addiconbyencoding">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Icône à afficher à côté d'un fichier en fonction de son
+codage MIME</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddIconByEncoding <var>icône</var> <var>codage MIME</var>
+[<var>codage MIME</var>] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
+<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>Indexes</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr>
+</table>
+ <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>
+
+ <div class="example"><h3>Exemple</h3><p><code>
+ AddIconByEncoding /icons/compress.xbm x-compress
+ </code></p></div>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="AddIconByType" id="AddIconByType">AddIconByType</a> <a name="addiconbytype" id="addiconbytype">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Icône à afficher à côté d'un fichier en fonction de son
+type MIME</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddIconByType <var>icône</var> <var>type MIME</var>
+[<var>type MIME</var>] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
+<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>Indexes</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr>
+</table>
+ <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>
+
+ <div class="example"><h3>Exemple</h3><p><code>
+ AddIconByType (IMG,/icons/image.xbm) image/*
+ </code></p></div>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="DefaultIcon" id="DefaultIcon">DefaultIcon</a> <a name="defaulticon" id="defaulticon">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Icône à afficher par défaut lorsqu'aucun icône spécifique
+n'est précisé</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DefaultIcon <var>chemin URL</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
+<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>Indexes</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr>
+</table>
+ <p>La directive <code class="directive">DefaultIcon</code> 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>
+
+ <div class="example"><h3>Exemple</h3><p><code>
+ DefaultIcon /icon/inconnu.xbm
+ </code></p></div>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="HeaderName" id="HeaderName">HeaderName</a> <a name="headername" id="headername">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom du fichier qui sera inséré au début de la page
+contenant l'index</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>HeaderName <var>nom fichier</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
+<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>Indexes</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr>
+</table>
+ <p>La directive <code class="directive">HeaderName</code> 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>
+
+ <div class="example"><h3>Exemple</h3><p><code>
+ HeaderName HEADER.html
+ </code></p></div>
+
+ <div class="note">
+ <p>Les deux directives HeaderName et <code class="directive"><a href="#readmename">ReadmeName</a></code> 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
+ <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>.</p>
+
+ <div class="example"><h3>Exemple</h3><p><code>
+ HeaderName /include/HEADER.html
+ </code></p></div>
+
+ <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>
+
+ <div class="example"><p><code>
+ AddType text/html .cgi
+ </code></p></div>
+
+ <p>Une <a href="../content-negotiation.html">négociation de
+ contenu</a> sera effectuée si <code class="directive"><a href="../mod/core.html#options">Options</a></code> <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 <code class="directive"><a href="../mod/core.html#options">options</a></code>
+ <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
+ <code class="module"><a href="../mod/mod_include.html">mod_include</a></code>).</p>
+ </div>
+
+ <p>Si le fichier spécifié par la directive
+ <code class="directive">HeaderName</code> 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>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="IndexHeadInsert" id="IndexHeadInsert">IndexHeadInsert</a> <a name="indexheadinsert" id="indexheadinsert">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Insère du texte dans la section HEAD de la page
+d'index.</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>IndexHeadInsert <var>"marque ..."</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
+<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>Indexes</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr>
+</table>
+ <p>La directive <code class="directive">IndexHeadInsert</code> 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>
+ <div class="example"><h3>Exemple</h3><p><code>
+
+ IndexHeadInsert "<link rel=\"sitemap\" href=\"/sitemap.html\">"
+ </code></p></div>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="IndexIgnore" id="IndexIgnore">IndexIgnore</a> <a name="indexignore" id="indexignore">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajouts à la liste des fichiers à cacher lors de l'affichage
+de l'index d'un répertoire</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>IndexIgnore <var>fichier</var> [<var>fichier</var>] ...</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
+<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>Indexes</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr>
+</table>
+ <p>La directive <code class="directive">IndexIgnore</code> 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>
+
+ <div class="example"><p><code>
+ IndexIgnore README .htaccess *.bak *~
+ </code></p></div>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="IndexOptions" id="IndexOptions">IndexOptions</a> <a name="indexoptions" id="indexoptions">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Diverses options de configuration pour l'indexation d'un
+répertoire</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>IndexOptions [+|-]<var>option</var> [[+|-]<var>option</var>]
+...</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
+<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>Indexes</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr>
+</table>
+ <p>La directive <code class="directive">IndexOptions</code> 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.
+
+ <div class="example"><h3>Exemple :</h3><p><code>
+ IndexOptions Charset=UTF-8
+ </code></p></div>
+ </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>.
+
+ <div class="example"><h3>Exemple :</h3><p><code>
+ IndexOptions Type=text/plain
+ </code></p></div>
+ </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), <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> 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 <code class="directive"><a href="#adddescription">AddDescription</a></code> 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, <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> 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), <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> 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 <code class="directive"><a href="#adddescription">AddDescription</a></code>, 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 <code class="directive"><a href="#adddescription">AddDescription</a></code> 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 <code class="directive"><a href="#headername">HeaderName</a></code>, 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.
+
+ <div class="example"><h3>Exemple :</h3><p><code>
+ 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
+ </code></p></div>
+
+ <p>Si le nombre commence par le chiffre 0, il est considéré comme
+ la partie fractionnaire d'un nombre :</p>
+
+ <div class="example"><p><code>
+ foo-1.001<br />
+ foo-1.002<br />
+ foo-1.030<br />
+ foo-1.04
+ </code></p></div>
+ </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
+ <code class="module"><a href="../mod/mod_autoindex.html">mod_autoindex</a></code> de générer du code XHTML 1.0 au
+ lieu de HTML 3.2.</dd>
+ </dl>
+
+
+ <dl><dt>Options d'index incrémentales</dt>
+ <dd>
+ <p>Apache 1.3.3 a apporté d'importantes modifications dans la
+ gestion des directives <code class="directive">IndexOptions</code>. En
+ particulier :</p>
+
+ <ul>
+ <li>Plusieurs directives <code class="directive">IndexOptions</code>
+ apparaissant dans la même section directory sont maintenant
+ fusionnées. Le résultat de :
+
+ <div class="example"><p><code>
+ <Directory /foo>
+ <span class="indent">
+ IndexOptions HTMLTable<br />
+ IndexOptions SuppressColumnsorting
+ </span>
+ </Directory>
+ </code></p></div>
+
+ <p>est équivalent à</p>
+
+ <div class="example"><p><code>
+ IndexOptions HTMLTable SuppressColumnsorting
+ </code></p></div>
+ </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
+ <code class="directive">IndexOptions</code> 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>
+
+ <div class="example"><p><code>
+ IndexOptions +ScanHTMLTitles -IconsAreLinks FancyIndexing<br />
+ IndexOptions +SuppressSize
+ </code></p></div>
+
+ <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
+ <code class="directive">IndexOptions</code> 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>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="IndexOrderDefault" id="IndexOrderDefault">IndexOrderDefault</a> <a name="indexorderdefault" id="indexorderdefault">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Définit l'ordre d'affichage par défaut d'un index de
+répertoire</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>IndexOrderDefault Ascending|Descending
+Name|Date|Size|Description</code></td></tr>
+<tr><th><a href="directive-dict.html#Default">Défaut:</a></th><td><code>IndexOrderDefault Ascending Name</code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
+<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>Indexes</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr>
+</table>
+ <p>La directive <code class="directive">IndexOrderDefault</code> 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
+ <code class="directive">IndexOrderDefault</code> vous permet de modifier ce
+ comportement.</p>
+
+ <p>La directive <code class="directive">IndexOrderDefault</code> 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
+ <code class="directive">IndexOrderDefault</code> 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>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="IndexStyleSheet" id="IndexStyleSheet">IndexStyleSheet</a> <a name="indexstylesheet" id="indexstylesheet">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajoute une feuille de style CSS à l'index du
+répertoire</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>IndexStyleSheet <var>chemin-url</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
+<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>Indexes</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr>
+</table>
+ <p>La directive <code class="directive">IndexStyleSheet</code> permet de
+ définir le nom du fichier qui servira de feuille de style CSS pour
+ l'index.
+ </p>
+ <div class="example"><h3>Exemple</h3><p><code>
+
+ IndexStyleSheet "/css/style.css"
+ </code></p></div>
+
+</div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="directive-section"><h2><a name="ReadmeName" id="ReadmeName">ReadmeName</a> <a name="readmename" id="readmename">Directive</a></h2>
+<table class="directive">
+<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom du fichier dont le contenu sera inséré à la fin de
+l'index</td></tr>
+<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ReadmeName <var>nom-fichier</var></code></td></tr>
+<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, répertoire, .htaccess</td></tr>
+<tr><th><a href="directive-dict.html#Override">Annuler:</a></th><td>Indexes</td></tr>
+<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr>
+<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr>
+</table>
+ <p>La directive <code class="directive">ReadmeName</code> 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 <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code>.
+ </p>
+
+ <div class="example"><h3>Exemple</h3><p><code>
+ ReadmeName FOOTER.html
+ </code></p></div>
+
+ <div class="example"><h3>Exemple 2</h3><p><code>
+ ReadmeName /include/FOOTER.html
+ </code></p></div>
+
+ <p>Voir aussi la directive <code class="directive"><a href="#headername">HeaderName</a></code>, où cette fonctionnalité est décrite plus en
+ détails.</p>
+
+</div>
+</div>
+<div class="bottomlang">
+<p><span>Langues Disponibles: </span><a href="../en/mod/mod_autoindex.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../fr/mod/mod_autoindex.html" title="Français"> fr </a> |
+<a href="../ja/mod/mod_autoindex.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
+<a href="../ko/mod/mod_autoindex.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
+<a href="../tr/mod/mod_autoindex.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
+</div><div id="footer">
+<p class="apache">Copyright 2009 The Apache Software Foundation.<br />Autorisé 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
--- /dev/null
+<?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>
projects / apache / commitdiff