mod_autoindex.html.fr revision 48c64aeceef385e19025b384bd719b2a9789592d
<?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="&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.3</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>
<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>Le serveur HTTP Apache version 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>
&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">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>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>
<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 ((&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>
</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>&lt;head&gt;</var> du code HTML g�n�r� pour la page
d'index.</p>
<div class="example"><h3>Exemple</h3><p><code>
IndexHeadInsert "&lt;link rel=\"sitemap\" href=\"/sitemap.html\"&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="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.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
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.descriptionwidth" id="indexoptions.descriptionwidth">DescriptionWidth=[<var>n</var> | *]</a> (<em>Versions 2.0.23 et
sup�rieures du serveur HTTP 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 du serveur HTTP 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
du serveur HTTP 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 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. <strong>Avant la version 2.0.23 du serveur HTTP
Apache, cette option d�sactivait aussi l'interpr�tation des
informations de tri transmises via les arguments de la
requ�te.</strong> Depuis la version 2.0.23 du serveur HTTP Apache, 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>&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.</dd>
<dt><a name="indexoptions.suppressicon" id="indexoptions.suppressicon">SuppressIcon</a>
(<em>Versions 2.0.23 et sup�rieures du serveur
HTTP 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 du serveur HTTP 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 du serveur
HTTP 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.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>.
<div class="example"><h3>Exemple :</h3><p><code>
IndexOptions Type=text/plain
</code></p></div>
</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>Apache httpd 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>
&lt;Directory /foo&gt;
<span class="indent">
IndexOptions HTMLTable<br />
IndexOptions SuppressColumnsorting
</span>
&lt;/Directory&gt;
</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>
<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>
<tr><th>Classe</th><th>D�finition</th></tr>
<tr><td>tr.indexhead</td><td>Ligne d'en-t�te du listing</td></tr>
<tr><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><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><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><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">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">&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 id="footer">
<p class="apache">Copyright 2010 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>