<?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>
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
<!--
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>mod_autoindex - Serveur Apache HTTP Version 2.5</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 rel="stylesheet" type="text/css" href="/style/css/prettify.css" />
<script src="/style/scripts/prettify.min.js" type="text/javascript">
</script>
<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/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/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.5</p>
<img alt="" src="/images/feather.gif" /></div>
<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="/images/left.gif" /></a></div>
<div id="path">
<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">Serveur HTTP</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="../">Version 2.5</a> &gt; <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">&nbsp;en&nbsp;</a> |
<a href="/fr/mod/mod_autoindex.html" title="Fran�ais">&nbsp;fr&nbsp;</a> |
<a href="/ja/mod/mod_autoindex.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="/ko/mod/mod_autoindex.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
<a href="/tr/mod/mod_autoindex.html" hreflang="tr" rel="alternate" title="T�rk�e">&nbsp;tr&nbsp;</a></p>
</div>
<div class="outofdate">Cette traduction peut �tre p�rim�e. V�rifiez la version
anglaise pour les changements r�cents.</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 situ� dans ce r�pertoire, en g�n�ral appel�
<code>index.html</code>, mais dont le nom de ce ou ces fichiers 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><a href="#indexoptions.suppresscolumnsorting">SuppressColumnSorting</a></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>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><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="#indexignorereset">IndexIgnoreReset</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>
<ul class="seealso"><li><a href="#comments_section">Commentaires</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>La cha�ne de param�tres de la requ�te peut contenir de nombreux
arguments permettant dans une certaine mesure au client de contr�ler
l'ordre de l'index du r�pertoire, ainsi que la liste des fichiers �
afficher. Si vous souhaitez d�sactiver cette fonctionnalit�,
utilisez l'option <code><a href="#indexoptions.ignoreclient">IndexOptions
IgnoreClient</a></code>.</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>
&lt;form action="" method="get"&gt;<br />
<span class="indent">
Montre moi une &lt;select name="F"&gt;<br />
<span class="indent">
&lt;option value="0"&gt; liste simple&lt;/option&gt;<br />
&lt;option value="1" selected="selected"&gt; liste avec
en-t�tes&lt;/option&gt;<br />
&lt;option value="2"&gt; liste avec en-t�te sous forme de
table&lt;/option&gt;<br />
</span>
&lt;/select&gt;<br />
tri�e par &lt;select name="C"&gt;<br />
<span class="indent">
&lt;option value="N" selected="selected"&gt; nom&lt;/option&gt;<br />
&lt;option value="M"&gt; date de modification&lt;/option&gt;<br />
&lt;option value="S"&gt; taille&lt;/option&gt;<br />
&lt;option value="D"&gt; description&lt;/option&gt;<br />
</span>
&lt;/select&gt;<br />
&lt;select name="O"&gt;<br />
<span class="indent">
&lt;option value="A" selected="selected"&gt; croissant&lt;/option&gt;<br />
&lt;option value="D"&gt; d�croissant&lt;/option&gt;<br />
</span>
&lt;/select&gt;<br />
&lt;select name="V"&gt;<br />
<span class="indent">
&lt;option value="0" selected="selected"&gt; dans l'ordre
normal&lt;/option&gt;<br />
&lt;option value="1"&gt; en fonction de la version&lt;/option&gt;<br />
</span>
&lt;/select&gt;<br />
correspondant � &lt;input type="text" name="P" value="*" /&gt;<br />
&lt;input type="submit" name="X" value="Go" /&gt;<br />
</span>
&lt;/form&gt;
</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">Directive</a> <a name="AddAlt" id="AddAlt">AddAlt</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">AllowOverride:</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>
<pre class="prettyprint lang-config">AddAlt "PDF file" *.pdf
AddAlt Compressed *.gz *.zip *.Z</pre>
</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">Directive</a> <a name="AddAltByEncoding" id="AddAltByEncoding">AddAltByEncoding</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">AllowOverride:</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>
<pre class="prettyprint lang-config">AddAltByEncoding gzip x-gzip</pre>
</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">Directive</a> <a name="AddAltByType" id="AddAltByType">AddAltByType</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">AllowOverride:</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>
<pre class="prettyprint lang-config">AddAltByType 'Fichier texte' text/plain</pre>
</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">Directive</a> <a name="AddDescription" id="AddDescription">AddDescription</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">AllowOverride:</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>
<pre class="prettyprint lang-config">AddDescription "The planet Mars" mars.gif
AddDescription "My friend Marshall" friends/mars.gif</pre>
<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>Comme l'argument <var>fichier</var> peut �tre un nom de fichier
partiel, vous devez garder � l'esprit qu'un nom de fichier partiel
trop court pourra correspondre � des fichiers non voulus. Par
exemple, <code>le.html</code> correspondra au fichier
<code>le.html</code>, mais aussi au fichier
<code>example.html</code>. En cas d'ambigu�t�, utilisez un nom de
fichier aussi complet que possible, et ordonnez votre liste de
directives <code>AddDescription</code> en cons�quence.</p>
<p>Voir le mot-cl� <a href="#indexoptions.descriptionwidth">DescriptionWidth</a> de la directive <code class="directive">module="mod_autoindex"&gt;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 class="note"><h3>Arguments avec chemins</h3>
<p>Les chemins absolus ne sont actuellement pas support�s et ne
peuvent correspondre � aucun chemin r�el � l'ex�cution. Les
arguments contenant des chemins relatifs, qui ne devraient �tre
normalement utilis�s que dans les fichiers htaccess, sont
implicitement pr�fix�s par '*/' afin d'�viter toute association
avec des noms de r�pertoires partiels.</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">Directive</a> <a name="AddIcon" id="AddIcon">AddIcon</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">AllowOverride:</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 une URL relative
(�chapp�e par des caract�res '%') vers
l'ic�ne, une URL distante pleinement qualifi�e, ou 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>
<p><code>^^BLANKICON^^</code> n'est utilis� que pour le formatage,
et n'est donc pas n�cessaire si vous utilisez <code>IndexOptions
HTMLTable</code>.</p>
<pre class="prettyprint lang-config">#Examples
AddIcon (IMG,/icons/image.png) .gif .jpg .png
AddIcon /icons/dir.png ^^DIRECTORY^^
AddIcon /icons/backup.png *~</pre>
<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">Directive</a> <a name="AddIconByEncoding" id="AddIconByEncoding">AddIconByEncoding</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">AllowOverride:</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 une URL relative
(�chapp�e par des caract�res '%') vers
l'ic�ne, une URL pleinement qualifi�e, ou 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>
<pre class="prettyprint lang-config">AddIconByEncoding /icons/compress.png x-compress</pre>
</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">Directive</a> <a name="AddIconByType" id="AddIconByType">AddIconByType</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">AllowOverride:</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 une URL relative
(�chapp�e par des caract�res '%') vers
l'ic�ne, une URL pleinement qualifi�e, ou 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>
<pre class="prettyprint lang-config">AddIconByType (IMG,/icons/image.png) image/*</pre>
</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">Directive</a> <a name="DefaultIcon" id="DefaultIcon">DefaultIcon</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">AllowOverride:</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 ou une URL pleinement qualifi�e.</p>
<pre class="prettyprint lang-config">DefaultIcon /icon/unknown.png</pre>
</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">Directive</a> <a name="HeaderName" id="HeaderName">HeaderName</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">AllowOverride:</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>
<pre class="prettyprint lang-config">HeaderName HEADER.html</pre>
<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>
<pre class="prettyprint lang-config">HeaderName /include/HEADER.html</pre>
<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>
<pre class="prettyprint lang-config">AddType text/html .cgi</pre>
<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 ((&lt;html&gt;, &lt;head&gt;, 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>
<h3>Voir aussi</h3>
<ul>
<li><code class="directive"><a href="#readmename">ReadmeName</a></code></li>
</ul>
</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">Directive</a> <a name="IndexHeadInsert" id="IndexHeadInsert">IndexHeadInsert</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">AllowOverride:</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>&lt;head&gt;</var> du code HTML g�n�r� pour la page
d'index.</p>
<pre class="prettyprint lang-config">IndexHeadInsert "&lt;link rel=\"sitemap\" href=\"/sitemap.html\"&gt;"</pre>
</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">Directive</a> <a name="IndexIgnore" id="IndexIgnore">IndexIgnore</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#Default">D�faut:</a></th><td><code>IndexIgnore "."</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">AllowOverride:</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>
<pre class="prettyprint lang-config">IndexIgnore .??* *~ *# HEADER* README* RCS CVS *,v *,t</pre>
<div class="note"><h3>Expressions rationnelles</h3>
<p>Cette directive est actuellement incompatible avec les sections
de configuration qui comportent des arguments avec expressions
rationnelles comme <code class="directive"><a href="/mod/core.html#directorymatch">&lt;DirectoryMatch&gt;</a></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="indexignorereset" id="indexignorereset">Directive</a> <a name="IndexIgnoreReset" id="IndexIgnoreReset">IndexIgnoreReset</a></h2>
<table class="directive">
<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Vide la liste des fichiers � cacher lors de l'affichage du
contenu d'un r�pertoire</td></tr>
<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>IndexIgnoreReset ON|OFF</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">AllowOverride:</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>
<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Versions 2.3.10 et sup�rieures</td></tr>
</table>
<p>La directive <code class="directive">IndexIgnoreReset</code> supprime
toute liste de fichiers d�finie par la directive
<code class="directive">IndexIgnore</code> et h�rit�e par ailleurs d'autres
sections de configuration.</p>
<pre class="prettyprint lang-config">&lt;Directory /var/www&gt;
IndexIgnore *.bak .??* *~ *# HEADER* README* RCS CVS *,v *,t
&lt;/Directory&gt;
&lt;Directory /var/www/backups&gt;
IndexIgnoreReset ON
IndexIgnore .??* *# HEADER* README* RCS CVS *,v *,t
&lt;/Directory&gt;</pre>
<div class="warning"><p>Revoyez la configuration par d�faut pour une
liste de mod�les que vous voulez ignorer explicitement apr�s usage
de cette directive.</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">Directive</a> <a name="IndexOptions" id="IndexOptions">IndexOptions</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#Default">D�faut:</a></th><td><code>Par d�faut, aucune option n'est activ�e.</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">AllowOverride:</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.addaltclass" id="indexoptions.addaltclass">AddAltClass</a></dt>
<dd>Ajoute une d�claration de classe CSS suppl�mentaire � chaque
enregistrement de la table du listing du r�pertoire dans le cas o�
<code>IndexOptions HTMLTable</code> est activ� et o� un
<code>IndexStyleSheet</code> a �t� d�fini. Plut�t que d'appliquer
� chaque enregistrement de la table les classes standards
<code>even</code> et <code>odd</code>, c'est ici une classe
<code>even-<em>ALT</em></code> ou <code>odd-<em>ALT</em></code>
qui sera appliqu�e, o� <em>ALT</em> sera soit le texte alternatif
standard associ� au style du fichier (par exemple <em>snd</em>,
<em>txt</em>, <em>img</em>, etc...), soit le texte alternatif
d�fini par une des diff�rentes directives <code>AddAlt*</code>.
</dd>
<dt><a name="indexoptions.charset" id="indexoptions.charset">Charset=<var>jeu de caract�res</var></a> (<em>Versions 2.0.61 et
sup�rieures du serveur HTTP 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
<var>UTF-8</var> sous Windows et MAC OS X, et
<var>ISO-8859-1</var> dans les autres cas (en fait selon que le
syst�me de fichiers sous-jacent utilise les noms de fichiers en
Unicode ou non).
<pre class="prettyprint lang-config">IndexOptions Charset=UTF-8</pre>
</dd>
<dt><a name="indexoptions.descriptionwidth" id="indexoptions.descriptionwidth">DescriptionWidth=[<var>n</var> | *]</a></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></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></dt>
<dd>Cette option pour l'affichage
<code>FancyIndexing</code> permet de construire une table simple
pour l'affichage de l'index du r�pertoire. Cette option s'av�rera
particuli�rement n�cessaire pour les plates-formes o� utf-8 est
activ� et dans le cas o� les noms de fichiers ou les cha�nes
de description alternent entre les ordres de lecture gauche �
droite et droite � gauche.</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 httpd 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 httpd 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, mais jusqu'� une largeur maximale de 20 octets.</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 httpd 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 httpd 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. Cependant, les arguments de la cha�ne de
param�tres de la requ�te ajout�s � l'URL seront toujours ignor�s.
Ce comportement est contr�l� par l'option <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>&lt;html&gt;</code>,
<code>&lt;head&gt;</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. Si vous sp�cifiez aussi une
directive <code class="directive"><a href="#readmename">ReadmeName</a></code>, et si ce
fichier existe, les balises de fermeture closing
&lt;/body&gt;&lt;/html&gt; seront aussi omises dans la sortie, en
supposant que vous ayez plac� ces balises de fermeture dans ce
fichier.</dd>
<dt><a name="indexoptions.suppressicon" id="indexoptions.suppressicon">SuppressIcon</a></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>
</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></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.type" id="indexoptions.type">Type=<var>type MIME</var></a> (<em>Versions 2.0.61 et
sup�rieures du serveur HTTP 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>.
<pre class="prettyprint lang-config">IndexOptions Type=text/plain</pre>
</dd>
<dt><a name="indexoptions.versionsort" id="indexoptions.versionsort">VersionSort</a>
(<em>Versions 2.0a3 et sup�rieures du serveur HTTP Apache</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 du serveur HTTP 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>Vous devez porter une attention particuli�re � la mani�re dont
les <code class="directive">IndexOptions</code> multiples sont trait�es.</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 :
<pre class="prettyprint lang-config">&lt;Directory /foo&gt;
IndexOptions HTMLTable
IndexOptions SuppressColumnsorting
&lt;/Directory&gt;</pre>
<p>est �quivalent �</p>
<pre class="prettyprint lang-config">IndexOptions HTMLTable SuppressColumnsorting</pre>
</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>
<pre class="prettyprint lang-config">IndexOptions +ScanHTMLTitles -IconsAreLinks FancyIndexing<br />
IndexOptions +SuppressSize</pre>
<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">Directive</a> <a name="IndexOrderDefault" id="IndexOrderDefault">IndexOrderDefault</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">AllowOverride:</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>Si vous le d�sirez, vous pouvez emp�cher le client de modifier
l'ordre de tri de la liste en ajoutant l'option d'index <code><a href="#indexoptions.suppresscolumnsorting">SuppressColumnSorting</a></code>
qui supprime le lien de d�finition du tri de l'en-t�te de la
colonne, ainsi que l'option <code><a href="#indexoptions.ignoreclient">IgnoreClient</a></code> qui
emp�che ce m�me client de passer outre vos pr�f�rences de tri en
ajoutant manuellement des options de tri � la cha�ne de param�tres
de la requ�te.</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">Directive</a> <a name="IndexStyleSheet" id="IndexStyleSheet">IndexStyleSheet</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">AllowOverride:</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>
<pre class="prettyprint lang-config">IndexStyleSheet "/css/style.css"</pre>
<p>L'utilisation de cette directive en conjonction avec <code>IndexOptions
HTMLTable</code> ajoute plusieurs classes CSS au document HTML
r�sultant. Un identifiant CSS <code>indexlist</code> est attribu� �
l'ensemble de la table et les classes suivantes sont associ�es aux
diff�rentes parties du listing :</p>
<table class="bordered"><tr class="header"><th>Classe</th><th>D�finition</th></tr>
<tr><td>tr.indexhead</td><td>Ligne d'en-t�te du listing</td></tr>
<tr class="odd"><td>th.indexcolicon and td.indexcolicon</td> <td>Colonne de
l'ic�ne</td></tr>
<tr><td>th.indexcolname and td.indexcolname</td> <td>Colonne du nom
du fichier</td></tr>
<tr class="odd"><td>th.indexcollastmod and td.indexcollastmod</td> <td>Colonne
de la date de derni�re modification</td></tr>
<tr><td>th.indexcolsize and td.indexcolsize</td> <td>Colonne de la
taille du fichier</td></tr>
<tr class="odd"><td>th.indexcoldesc and td.indexcoldesc</td> <td>Colonne de la
description</td></tr>
<tr><td>tr.breakrow</td> <td>Pied de page</td></tr>
<tr class="odd"><td>tr.odd and tr.even</td> <td>Alternance des lignes paires et
impaires</td></tr>
</table>
</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">Directive</a> <a name="ReadmeName" id="ReadmeName">ReadmeName</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">AllowOverride:</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 '/', comme dans
l'exemple 2, 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>
<pre class="prettyprint lang-config"># Example 1
ReadmeName FOOTER.html</pre>
<pre class="prettyprint lang-config"># Example 2
ReadmeName /include/FOOTER.html</pre>
<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">&nbsp;en&nbsp;</a> |
<a href="/fr/mod/mod_autoindex.html" title="Fran�ais">&nbsp;fr&nbsp;</a> |
<a href="/ja/mod/mod_autoindex.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
<a href="/ko/mod/mod_autoindex.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
<a href="/tr/mod/mod_autoindex.html" hreflang="tr" rel="alternate" title="T�rk�e">&nbsp;tr&nbsp;</a></p>
</div><div class="top"><a href="#page-header"><img src="/images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Commentaires</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&amp;A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
<script type="text/javascript"><!--//--><![CDATA[//><!--
var comments_shortname = 'httpd';
var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mod_autoindex.html';
(function(w, d) {
if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
d.write('<div id="comments_thread"><\/div>');
var s = d.createElement('script');
s.type = 'text/javascript';
s.async = true;
s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
(d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
}
else {
d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
}
})(window, document);
//--><!]]></script></div><div id="footer">
<p class="apache">Copyright 2015 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/quickreference.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossaire</a> | <a href="/sitemap.html">Plan du site</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
if (typeof(prettyPrint) !== 'undefined') {
prettyPrint();
}
//--><!]]></script>
</body></html>