1<?xml version="1.0" encoding="ISO-8859-1"?> 2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> 3<html xmlns="http://www.w3.org/1999/xhtml" lang="fr" xml:lang="fr"><head><!-- 4 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 5 This file is generated from xml source: DO NOT EDIT 6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 7 --> 8<title>mod_autoindex - Serveur Apache HTTP</title> 9<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> 10<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> 11<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" /> 12<script src="/style/scripts/prettify.js" type="text/javascript"> 13</script> 14 15<link href="/images/favicon.ico" rel="shortcut icon" /></head> 16<body> 17<div id="page-header"> 18<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.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> 19<p class="apache">Serveur Apache HTTP Version 2.2</p> 20<img alt="" src="/images/feather.gif" /></div> 21<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div> 22<div id="path"> 23<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Serveur HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentation</a> > <a href="../">Version 2.2</a> > <a href="./">Modules</a></div> 24<div id="page-content"> 25<div id="preamble"><h1>Module Apache mod_autoindex</h1> 26<div class="toplang"> 27<p><span>Langues Disponibles: </span><a href="/en/mod/mod_autoindex.html" hreflang="en" rel="alternate" title="English"> en </a> | 28<a href="/fr/mod/mod_autoindex.html" title="Fran�ais"> fr </a> | 29<a href="/ja/mod/mod_autoindex.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | 30<a href="/ko/mod/mod_autoindex.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | 31<a href="/tr/mod/mod_autoindex.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p> 32</div> 33<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 34mani�re similaire � la commande Unix <code>ls</code>, ou � la commande 35shell Win32 <code>dir</code></td></tr> 36<tr><th><a href="module-dict.html#Status">Statut:</a></th><td>Base</td></tr> 37<tr><th><a href="module-dict.html#ModuleIdentifier">Identificateur�de�Module:</a></th><td>autoindex_module</td></tr> 38<tr><th><a href="module-dict.html#SourceFile">Fichier�Source:</a></th><td>mod_autoindex.c</td></tr></table> 39<h3>Sommaire</h3> 40 41 <p>L'index d'un r�pertoire peut �tre g�n�r� de deux mani�res :</p> 42 43 <ul> 44 <li>Un fichier �crit par l'utilisateur, en g�n�ral appel� 45 <code>index.html</code>, mais dont le nom peut �tre d�fini par la 46 directive <code class="directive"><a href="/mod/mod_dir.html#directoryindex">DirectoryIndex</a></code>. C'est le module 47 <code class="module"><a href="/mod/mod_dir.html">mod_dir</a></code> qui traite alors cet index.</li> 48 49 <li>Un listing g�n�r� par le serveur, dont le format est contr�l� 50 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 51 d�finir une liste d'ic�nes � afficher en fonction des diff�rents 52 types de fichiers ; pour chaque fichier list�, le premier ic�ne 53 qui correspond au type du fichier est affich�. C'est le module 54 <code class="module"><a href="/mod/mod_autoindex.html">mod_autoindex</a></code> qui traite alors cet index.</li> 55 </ul> 56 <p>Les deux fonctions sont s�par�es, si bien que vous pouvez 57 enti�rement supprimer (ou remplacer) la g�n�ration automatique 58 d'index, si vous le souhaitez.</p> 59 60 <p>On active la g�n�ration automatique d'index en sp�cifiant 61 <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> 62 63 <p>Si la directive <code class="directive"><a href="#indexoptions">IndexOptions</a></code> est sp�cifi�e avec 64 l'option <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>, les en-t�tes de colonnes sont des liens 65 qui permettent de contr�ler l'ordre de tri de l'affichage. Si vous 66 actionnez le lien d'un en-t�te, le listing sera g�n�r� � nouveau, 67 tri� en fonction des valeurs de la colonne concern�e. Si l'on 68 actionne de mani�re r�p�titive le m�me en-t�te, l'ordre de tri est 69 commut� entre les ordres croissant et d�croissant. On peut supprimer 70 ces liens d'en-t�tes de colonnes � l'aide de l'option 71 <code>SuppressColumnSorting</code> de la directive <code class="directive"><a href="#indexoptions">IndexOptions</a></code>.</p> 72 73 <p>Notez que lorsque l'affichage est tri� en fonction de la taille, 74 c'est la taille <em>r�elle</em> qui est prise en compte, et non la 75 valeur affich�e - ainsi, un fichier de 1010 octets sera toujours 76 affich� avant un fichier de 1011 octets (en ordre croissant), m�me 77 si la taille affich�e des deux fichiers est "1K".</p> 78</div> 79<div id="quickview"><h3 class="directives">Directives</h3> 80<ul id="toc"> 81<li><img alt="" src="/images/down.gif" /> <a href="#addalt">AddAlt</a></li> 82<li><img alt="" src="/images/down.gif" /> <a href="#addaltbyencoding">AddAltByEncoding</a></li> 83<li><img alt="" src="/images/down.gif" /> <a href="#addaltbytype">AddAltByType</a></li> 84<li><img alt="" src="/images/down.gif" /> <a href="#adddescription">AddDescription</a></li> 85<li><img alt="" src="/images/down.gif" /> <a href="#addicon">AddIcon</a></li> 86<li><img alt="" src="/images/down.gif" /> <a href="#addiconbyencoding">AddIconByEncoding</a></li> 87<li><img alt="" src="/images/down.gif" /> <a href="#addiconbytype">AddIconByType</a></li> 88<li><img alt="" src="/images/down.gif" /> <a href="#defaulticon">DefaultIcon</a></li> 89<li><img alt="" src="/images/down.gif" /> <a href="#headername">HeaderName</a></li> 90<li><img alt="" src="/images/down.gif" /> <a href="#indexheadinsert">IndexHeadInsert</a></li> 91<li><img alt="" src="/images/down.gif" /> <a href="#indexignore">IndexIgnore</a></li> 92<li><img alt="" src="/images/down.gif" /> <a href="#indexoptions">IndexOptions</a></li> 93<li><img alt="" src="/images/down.gif" /> <a href="#indexorderdefault">IndexOrderDefault</a></li> 94<li><img alt="" src="/images/down.gif" /> <a href="#indexstylesheet">IndexStyleSheet</a></li> 95<li><img alt="" src="/images/down.gif" /> <a href="#readmename">ReadmeName</a></li> 96</ul> 97<h3>Sujets</h3> 98<ul id="topics"> 99<li><img alt="" src="/images/down.gif" /> <a href="#query">Arguments de la requ�te d'autoindexation</a></li> 100</ul><ul class="seealso"><li><a href="#comments_section">Commentaires</a></li></ul></div> 101<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 102<div class="section"> 103<h2><a name="query" id="query">Arguments de la requ�te d'autoindexation</a></h2> 104 105 106 <p>Apache 2.0.23 a r�organis� les arguments de requ�te pour le tri 107 des colonnes, et intoduit un groupe complet de nouvelles options de 108 requ�te. Pour interdire effectivement au client tout contr�le sur 109 l'affichage, l'option <code><a href="#indexoptions.ignoreclient">IndexOptions 110 IgnoreClient</a></code> a �t� ajout�e.</p> 111 112 <p>Les en-t�tes de tri des colonnes eux-m�mes sont des hyper-liens 113 auto-r�f�rant qui ajoutent les options de tri � la requ�te �num�r�es 114 ci-dessous qui peuvent �tre ajout�es � toute requ�te concernant la 115 ressource r�pertoire.</p> 116 117 <ul> 118 <li><code>C=N</code> trie l'affichage en fonction du nom de 119 fichier</li> 120 121 <li><code>C=M</code> trie l'affichage en fonction de la date de 122 derni�re modification, puis du nom de fichier</li> 123 124 <li><code>C=S</code> trie l'affichage en fonction de la taille, 125 puis du nom de fichier</li> 126 127 <li class="separate"><code>C=D</code> trie l'affichage en fonction 128 de la description, puis du nom de fichier</li> 129 130 <li><code>O=A</code> trie l'affichage selon l'ordre croissant</li> 131 132 <li class="separate"><code>O=D</code> trie l'affichage selon 133 l'ordre d�croissant</li> 134 135 <li><code>F=0</code> affiche le listing sous la forme d'une simple 136 liste (not FancyIndexed)</li> 137 138 <li><code>F=1</code> affiche le listing avec en-t�tes de colonnes 139 sous forme de liens hyper-textes (FancyIndexed)</li> 140 141 <li class="separate"><code>F=2</code> affiche le listing sous 142 forme de table HTML avec en-t�tes de colonnes contenant des liens 143 hyper-textes (FancyIndexed)</li> 144 145 <li><code>V=0</code> d�sactive le tri en fonction de la 146 version</li> 147 148 <li class="separate"><code>V=1</code> active le tri en fonction de 149 la version</li> 150 151 <li><code>P=<var>mod�le</var></code> n'affiche que les fichiers 152 correspondant au <var>mod�le</var> sp�cifi�</li> 153 </ul> 154 155 <p>Notez que l'argument 'P' (pour Pattern) n'est test� 156 qu'<em>apr�s</em> que les directives habituelles <code class="directive"><a href="#indexignore">IndexIgnore</a></code> n'aient �t� trait�es, 157 et que tous les noms de fichiers sont encore assujettis aux m�mes 158 crit�res que pour tout autre listing auto-index�. L'interpr�teur 159 d'arguments de requ�te de <code class="module"><a href="/mod/mod_autoindex.html">mod_autoindex</a></code> s'arr�te 160 imm�diatement s'il rencontre une option non reconnue. Les arguments 161 de requ�te doivent �tre bien form�s, selon la table ci-dessus.</p> 162 163 <p>Les options de requ�tes sont illustr�es par l'exemple ci-dessous, 164 qui peut �tre copi� et coll� dans un fichier header.html. Notez que 165 l'argument inconnu "X", pour le bouton submit, est introduit en 166 dernier afin de s'assurer que tous les arguments aient �t� 167 interpr�t�s avant que mod_autoindex ne rencontre l'entr�e X=Go.</p> 168 169 <div class="example"><p><code> 170 <form action="" method="get"><br /> 171 <span class="indent"> 172 Montre moi une <select name="F"><br /> 173 <span class="indent"> 174 <option value="0"> simple liste</option><br /> 175 <option value="1" selected="selected"> liste avec 176 en-t�tes</option><br /> 177 <option value="2"> liste avec en-t�te sous forme de 178 table</option><br /> 179 </span> 180 </select><br /> 181 tri�e par <select name="C"><br /> 182 <span class="indent"> 183 <option value="N" selected="selected"> nom</option><br /> 184 <option value="M"> date de modification</option><br /> 185 <option value="S"> taille</option><br /> 186 <option value="D"> description</option><br /> 187 </span> 188 </select><br /> 189 <select name="O"><br /> 190 <span class="indent"> 191 <option value="A" selected="selected"> croissant</option><br /> 192 <option value="D"> d�croissant</option><br /> 193 </span> 194 </select><br /> 195 <select name="V"><br /> 196 <span class="indent"> 197 <option value="0" selected="selected"> dans l'ordre 198 normal</option><br /> 199 <option value="1"> en fonction de la version</option><br /> 200 </span> 201 </select><br /> 202 correspondant � <input type="text" name="P" value="*" /><br /> 203 <input type="submit" name="X" value="Go" /><br /> 204 </span> 205 </form> 206 </code></p></div> 207 208</div> 209<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 210<div class="directive-section"><h2><a name="AddAlt" id="AddAlt">AddAlt</a> <a name="addalt" id="addalt">Directive</a></h2> 211<table class="directive"> 212<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Texte optionnel � afficher � la place d'un ic�ne pour un 213fichier en fonction de son nom</td></tr> 214<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> 215<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 216<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Indexes</td></tr> 217<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 218<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr> 219</table> 220 <p>La directive <code class="directive">AddAlt</code> permet d'afficher un 221 texte optionnel pour un fichier, � la place d'un ic�ne, dans le cas 222 d'un affichage <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>. 223 <var>fichier</var> est une extension de fichier, un nom de fichier 224 partiel, une expression avec caract�res g�n�riques o� un nom de 225 fichier complet permettant de caract�riser le(s) fichier(s) 226 concern�(s). Si <var>texte</var> contient des espaces, vous devez 227 l'entourer de guillemets ou d'apostrophes (<code>"</code> ou 228 <code>'</code>). Ce texte optionnel sera affich� si le client ne 229 peut pas afficher d'images, si le chargement d'images est d�sactiv� 230 ou si l'ic�ne ne peut pas �tre trouv�.</p> 231 232 <div class="example"><h3>Exemples</h3><p><code> 233 AddAlt "Fichier PDF" *.pdf<br /> 234 AddAlt Compress� *.gz *.zip *.Z 235 </code></p></div> 236 237</div> 238<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 239<div class="directive-section"><h2><a name="AddAltByEncoding" id="AddAltByEncoding">AddAltByEncoding</a> <a name="addaltbyencoding" id="addaltbyencoding">Directive</a></h2> 240<table class="directive"> 241<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Texte optionnel � afficher � la place d'un ic�ne pour un 242fichier en fonction de son codage MIME</td></tr> 243<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddAltByEncoding <var>texte</var> <var>codage MIME</var> 244[<var>codage MIME</var>] ...</code></td></tr> 245<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 246<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Indexes</td></tr> 247<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 248<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr> 249</table> 250 <p>La directive <code class="directive">AddAltByEncoding</code> permet 251 d'afficher un texte optionnel � la place d'un ic�ne pour un fichier 252 dans le cas d'un affichage <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>. 253 <var>codage MIME</var> doit �tre un type valide, comme 254 <code>x-compress</code>. Si <var>texte</var> contient des espaces, 255 vous devez l'entourer de guillemets ou d'apostrophes (<code>"</code> 256 ou <code>'</code>). Ce texte optionnel sera affich� si le client ne 257 peut pas afficher d'images, si le chargement d'images est d�sactiv� 258 ou si l'ic�ne ne peut pas �tre trouv�.</p> 259 260 <div class="example"><h3>Exemple</h3><p><code> 261 AddAltByEncoding gzip x-gzip 262 </code></p></div> 263 264</div> 265<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 266<div class="directive-section"><h2><a name="AddAltByType" id="AddAltByType">AddAltByType</a> <a name="addaltbytype" id="addaltbytype">Directive</a></h2> 267<table class="directive"> 268<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Texte optionnel � afficher � la place d'un ic�ne pour un 269fichier en fonction de son type MIME</td></tr> 270<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddAltByType <var>texte</var> <var>type MIME</var> 271[<var>type MIME</var>] ...</code></td></tr> 272<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 273<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Indexes</td></tr> 274<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 275<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr> 276</table> 277 <p>La directive <code class="directive">AddAltByType</code> permet 278 d'afficher un texte optionnel � la place d'un ic�ne pour un fichier 279 dans le cas d'un affichage <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>. 280 <var>type MIME</var> doit �tre un type MIME valide, comme 281 <code>text/html</code>. Si <var>texte</var> contient des espaces, 282 vous devez l'entourer de guillemets ou d'apostrophes (<code>"</code> 283 ou <code>'</code>). Ce texte optionnel sera affich� si le client ne 284 peut pas afficher d'images, si le chargement d'images est d�sactiv� 285 ou si l'ic�ne ne peut pas �tre trouv�.</p> 286 287 <div class="example"><h3>Exemple</h3><p><code> 288 AddAltByType 'Fichier texte' text/plain 289 </code></p></div> 290 291</div> 292<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 293<div class="directive-section"><h2><a name="AddDescription" id="AddDescription">AddDescription</a> <a name="adddescription" id="adddescription">Directive</a></h2> 294<table class="directive"> 295<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Afficher la description d'un fichier</td></tr> 296<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddDescription <var>texte</var> [<var>fichier</var>] ...</code></td></tr> 297<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 298<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Indexes</td></tr> 299<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 300<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr> 301</table> 302 <p>Cette directive permet d'afficher une description pour un 303 fichier, dans le cas d'un affichage <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>. 304 <var>fichier</var> est une extension de fichier, un nom de fichier 305 partiel, une expression avec caract�res g�n�riques ou un nom de 306 fichier complet permettant de caract�riser le fichier. 307 <var>texte</var> doit �tre entour� de guillemets 308 (<code>"</code>).</p> 309 310 <div class="example"><h3>Exemple</h3><p><code> 311 AddDescription "La plan�te Mars" mars.gif 312 </code></p></div> 313 314 <p>La taille par d�faut, habituelle du champ de description est de 315 23 octets. L'option <code><a href="#indexoptions.suppressicon">IndexOptions SuppressIcon</a></code> ajoute 6 octets, l'option 316 <code><a href="#indexoptions.suppresssize">IndexOptions 317 SuppressSize</a></code> en ajoute 7 et l'option <code><a href="#indexoptions.suppresslastmodified">IndexOptions 318 SuppressLastModified</a></code> en ajoute 19. Ainsi, la plus grande 319 taille par d�faut qui peut �tre assign�e � la colonne description 320 est de 55 octets.</p> 321 322 <p>Voir le mot-cl� <a href="#indexoptions.descriptionwidth">DescriptionWidth</a> de la directive <code class="directive">module="mod_autoindex">IndexOptions</code> pour plus de 323 d�tails sur la mani�re d'augmenter la taille de cette colonne, ou 324 pour permettre des descriptions de taille illimit�e.</p> 325 326 <div class="note"><h3>Avertissement</h3> 327 <p>Le texte descriptif d�fini par la directive 328 <code class="directive">AddDescription</code> peut contenir des marquages 329 HTML, comme des balises ou des entit�s caract�res. Si la limite de 330 taille de la colonne description venait � tronquer une balise (par 331 exemple couper la fin d'une phrase en caract�res gras), le 332 r�sultat pourrait en affecter toute la suite du listing du 333 r�pertoire.</p> 334 </div> 335 336 <div class="note"><h3>Arguments avec chemins</h3> 337 <p>Les chemins absolus ne sont actuellement pas support�s et ne 338 peuvent correspondre � aucun chemin r�el � l'ex�cution. Les 339 arguments contenant des chemins relatifs, qui ne devraient �tre 340 normalement utilis�s que dans les fichiers htaccess, sont 341 implicitement pr�fix�s par '*/' afin d'�viter toute association 342 avec des noms de r�pertoires partiels.</p> 343 </div> 344 345</div> 346<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 347<div class="directive-section"><h2><a name="AddIcon" id="AddIcon">AddIcon</a> <a name="addicon" id="addicon">Directive</a></h2> 348<table class="directive"> 349<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ic�ne � afficher pour un fichier en fonction de son 350nom</td></tr> 351<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddIcon <var>ic�ne</var> <var>nom</var> [<var>nom</var>] 352...</code></td></tr> 353<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 354<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Indexes</td></tr> 355<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 356<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr> 357</table> 358 <p>Cette directive permet de d�terminer l'ic�ne � afficher � c�t� 359 d'un fichier dont le nom se termine par <var>nom</var>, dans le cas 360 d'un affichage <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>. <var>ic�ne</var> est une URL relative 361 (�chapp�e par des caract�res '%') vers 362 l'ic�ne, une URL pleinement qualifi�e, ou de la forme 363 <code>(<var>alttext</var>,<var>url</var>)</code>, o� 364 <var>alttext</var> est le symbole texte correspondant � l'ic�ne � 365 afficher dans les navigateurs en mode texte.</p> 366 367 <p><var>nom</var> correspond � <code>^^DIRECTORY^^</code> pour les 368 r�pertoires, <code>^^BLANKICON^^</code> pour les lignes vides 369 (pour personnaliser la pr�sentation du listing), une extension de 370 fichier, une expression avec caract�res g�n�riques, un nom de 371 fichier partiel ou un nom de fichier complet.</p> 372 373 <p><code>^^BLANKICON^^</code> n'est utilis� que pour le formatage, 374 et n'est donc pas n�cessaire si vous utilisez <code>IndexOptions 375 HTMLTable</code>.</p> 376 377 <div class="example"><h3>Exemples</h3><p><code> 378 AddIcon (IMG,/icons/image.xbm) .gif .jpg .xbm<br /> 379 AddIcon /icons/dir.xbm ^^DIRECTORY^^<br /> 380 AddIcon /icons/backup.xbm *~ 381 </code></p></div> 382 383 <p>Lorsque c'est possible, il est pr�f�rable d'utiliser <code class="directive"><a href="#addiconbytype">AddIconByType</a></code> plut�t que 384 <code class="directive">AddIcon</code>.</p> 385 386</div> 387<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 388<div class="directive-section"><h2><a name="AddIconByEncoding" id="AddIconByEncoding">AddIconByEncoding</a> <a name="addiconbyencoding" id="addiconbyencoding">Directive</a></h2> 389<table class="directive"> 390<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ic�ne � afficher � c�t� d'un fichier en fonction de son 391codage MIME</td></tr> 392<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddIconByEncoding <var>ic�ne</var> <var>codage MIME</var> 393[<var>codage MIME</var>] ...</code></td></tr> 394<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 395<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Indexes</td></tr> 396<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 397<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr> 398</table> 399 <p>Cette directive permet de d�terminer l'ic�ne � afficher � c�t� 400 d'un fichier dans le cas d'un affichage <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>. 401 <var>ic�ne</var> est une URL relative 402 (�chapp�e par des caract�res '%') vers 403 l'ic�ne, une URL pleinement qualifi�e, ou de la forme 404 <code>(<var>alttext</var>,<var>url</var>)</code>, o� 405 <var>alttext</var> est le symbole texte correspondant � l'ic�ne � 406 afficher dans les navigateurs en mode texte.</p> 407 408 <p><var>codage MIME</var> doit �tre un codage valide, comme 409 <code>x-compress</code>.</p> 410 411 <div class="example"><h3>Exemple</h3><p><code> 412 AddIconByEncoding /icons/compress.xbm x-compress 413 </code></p></div> 414 415</div> 416<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 417<div class="directive-section"><h2><a name="AddIconByType" id="AddIconByType">AddIconByType</a> <a name="addiconbytype" id="addiconbytype">Directive</a></h2> 418<table class="directive"> 419<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ic�ne � afficher � c�t� d'un fichier en fonction de son 420type MIME</td></tr> 421<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>AddIconByType <var>ic�ne</var> <var>type MIME</var> 422[<var>type MIME</var>] ...</code></td></tr> 423<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 424<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Indexes</td></tr> 425<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 426<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr> 427</table> 428 <p>Cette directive permet de d�terminer l'ic�ne � afficher � c�t� 429 d'un fichier de type MIME <var>type MIME</var> dans le cas d'un 430 affichage <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>. 431 <var>ic�ne</var> est une URL relative 432 (�chapp�e par des caract�res '%') vers 433 l'ic�ne, une URL pleinement qualifi�e, ou de la forme 434 <code>(<var>alttext</var>,<var>url</var>)</code>, o� 435 <var>alttext</var> est le symbole texte correspondant � l'ic�ne � 436 afficher dans les navigateurs en mode texte.</p> 437 438 <p><var>type MIME</var> est une expression avec caract�res 439 g�n�riques repr�sentant le type MIME.</p> 440 441 <div class="example"><h3>Exemple</h3><p><code> 442 AddIconByType (IMG,/icons/image.xbm) image/* 443 </code></p></div> 444 445</div> 446<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 447<div class="directive-section"><h2><a name="DefaultIcon" id="DefaultIcon">DefaultIcon</a> <a name="defaulticon" id="defaulticon">Directive</a></h2> 448<table class="directive"> 449<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ic�ne � afficher par d�faut lorsqu'aucun ic�ne sp�cifique 450n'est pr�cis�</td></tr> 451<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>DefaultIcon <var>chemin URL</var></code></td></tr> 452<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 453<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Indexes</td></tr> 454<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 455<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr> 456</table> 457 <p>La directive <code class="directive">DefaultIcon</code> permet de d�finir 458 l'ic�ne � afficher � c�t� d'un fichier lorsqu'aucun ic�ne sp�cifique 459 n'a �t� pr�cis�, dans le cas d'un affichage <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>. 460 <var>chemin URL</var> est une URL relative (�chapp�e par des 461 caract�res '%') vers l'ic�ne,ou une URL pleinement qualifi�e.</p> 462 463 <div class="example"><h3>Exemple</h3><p><code> 464 DefaultIcon /icon/inconnu.xbm 465 </code></p></div> 466 467</div> 468<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 469<div class="directive-section"><h2><a name="HeaderName" id="HeaderName">HeaderName</a> <a name="headername" id="headername">Directive</a></h2> 470<table class="directive"> 471<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 472contenant l'index</td></tr> 473<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>HeaderName <var>nom fichier</var></code></td></tr> 474<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 475<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Indexes</td></tr> 476<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 477<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr> 478</table> 479 <p>La directive <code class="directive">HeaderName</code> permet de d�finir 480 le nom du fichier qui sera ins�r� au d�but de la page contenant 481 l'index. <var>nom fichier</var> est le nom du fichier � inclure.</p> 482 483 <div class="example"><h3>Exemple</h3><p><code> 484 HeaderName HEADER.html 485 </code></p></div> 486 487 <div class="note"> 488 <p>Les deux directives HeaderName et <code class="directive"><a href="#readmename">ReadmeName</a></code> traitent maintenant 489 <var>nom fichier</var> comme un chemin URI relatif au chemin 490 utilis� pour acc�der au r�pertoire faisant l'objet de l'index. Si 491 <var>nom fichier</var> commence par un slash '/', il sera 492 consid�r� comme relatif au r�pertoire d�fini par la directive 493 <code class="directive"><a href="/mod/core.html#documentroot">DocumentRoot</a></code>.</p> 494 495 <div class="example"><h3>Exemple</h3><p><code> 496 HeaderName /include/HEADER.html 497 </code></p></div> 498 499 <p><var>nom fichier</var> doit correspondre � un document dont le 500 type MIME est du style <code>text/*</code> (<em>par exemple</em> 501 <code>text/html</code>, <code>text/plain</code>, etc...). Cela 502 signifie que <var>nom fichier</var> peut faire r�f�rence � un 503 script CGI si le v�ritable type MIME du script (et non celui de sa 504 sortie) est marqu� comme <code>text/html</code> par exemple � 505 l'aide d'une directive comme :</p> 506 507 <div class="example"><p><code> 508 AddType text/html .cgi 509 </code></p></div> 510 511 <p>Une <a href="/content-negotiation.html">n�gociation de 512 contenu</a> sera effectu�e si <code class="directive"><a href="/mod/core.html#options">Options</a></code> <code>MultiViews</code> a �t� 513 pr�cis�. Si <var>nom fichier</var> correspond � un document 514 statique <code>text/html</code> (et non � un script CGI), et une 515 des deux <code class="directive"><a href="/mod/core.html#options">options</a></code> 516 <code>Includes</code> ou <code>IncludesNOEXEC</code> est activ�e, 517 le fichier sera trait� en tant qu'inclusion c�t� serveur (Server 518 Side Include) (voir la documentation de 519 <code class="module"><a href="/mod/mod_include.html">mod_include</a></code>).</p> 520 </div> 521 522 <p>Si le fichier sp�cifi� par la directive 523 <code class="directive">HeaderName</code> contient les en-t�tes d'un 524 document HTML ((<html>, <head>, etc...), vous serez 525 probablement amen� � d�finir <a href="#indexoptions.suppresshtmlpreamble"><code>IndexOptions 526 +SuppressHTMLPreamble</code></a>, de mani�re � ce que ces balises ne 527 soient pas r�p�t�es.</p> 528 529</div> 530<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 531<div class="directive-section"><h2><a name="IndexHeadInsert" id="IndexHeadInsert">IndexHeadInsert</a> <a name="indexheadinsert" id="indexheadinsert">Directive</a></h2> 532<table class="directive"> 533<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ins�re du texte dans la section HEAD de la page 534d'index.</td></tr> 535<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>IndexHeadInsert <var>"marque ..."</var></code></td></tr> 536<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 537<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Indexes</td></tr> 538<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 539<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr> 540<tr><th><a href="directive-dict.html#Compatibility">Compatibilit�:</a></th><td>Disponible depuis la version 2.2.11 541d'Apache</td></tr> 542</table> 543 <p>La directive <code class="directive">IndexHeadInsert</code> permet de 544 sp�cifier une cha�ne de caract�res � ins�rer dans la section 545 <var><head></var> du code HTML g�n�r� pour la page 546 d'index.</p> 547 <div class="example"><h3>Exemple</h3><p><code> 548 549 IndexHeadInsert "<link rel=\"sitemap\" href=\"/sitemap.html\">" 550 </code></p></div> 551 552</div> 553<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 554<div class="directive-section"><h2><a name="IndexIgnore" id="IndexIgnore">IndexIgnore</a> <a name="indexignore" id="indexignore">Directive</a></h2> 555<table class="directive"> 556<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajouts � la liste des fichiers � cacher lors de l'affichage 557de l'index d'un r�pertoire</td></tr> 558<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>IndexIgnore <var>fichier</var> [<var>fichier</var>] ...</code></td></tr> 559<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>IndexIgnore "."</code></td></tr> 560<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 561<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Indexes</td></tr> 562<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 563<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr> 564</table> 565 <p>La directive <code class="directive">IndexIgnore</code> permet 566 d'effectuer des ajouts � la liste des fichiers � cacher lors de 567 l'affichage de l'index d'un r�pertoire. <var>fichier</var> est une 568 expression avec caract�res g�n�riques de style shell ou un nom de 569 fichier complet. Plusieurs directives IndexIgnore effectuent des 570 ajouts � la liste, et ne remplacent pas la liste des fichiers � 571 ignorer. Par d�faut, la liste contient <code>.</code> (le r�pertoire 572 courant).</p> 573 574 <div class="example"><p><code> 575 IndexIgnore .??* *~ *# HEADER* README* RCS CVS *,v *,t 576 </code></p></div> 577 578 <div class="note"><h3>Expressions rationnelles</h3> 579 <p>Cette directive est actuellement incompatible avec les sections 580 de configuration qui comportent des arguments avec expressions 581 rationnelles comme <code class="directive"><a href="/mod/core.html#directorymatch"><DirectoryMatch></a></code></p> 582 </div> 583 584</div> 585<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 586<div class="directive-section"><h2><a name="IndexOptions" id="IndexOptions">IndexOptions</a> <a name="indexoptions" id="indexoptions">Directive</a></h2> 587<table class="directive"> 588<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Diverses options de configuration pour l'indexation d'un 589r�pertoire</td></tr> 590<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>IndexOptions [+|-]<var>option</var> [[+|-]<var>option</var>] 591...</code></td></tr> 592<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> 593<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 594<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Indexes</td></tr> 595<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 596<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr> 597</table> 598 <p>La directive <code class="directive">IndexOptions</code> permet de 599 sp�cifier les options de configuration de l'indexation du 600 r�pertoire. <var>option</var> peut prendre l'une des valeurs 601 suivantes :</p> 602 603 <dl> 604 <dt><a name="indexoptions.charset" id="indexoptions.charset">Charset=<var>jeu de caract�res</var></a> (<em>Versions 2.0.61 et 605 sup�rieures d'Apache</em>)</dt> 606 607 <dd>Le mot-cl� <code>Charset</code> vous permet de sp�cifier le 608 jeu de caract�res de la page g�n�r�e. La valeur par d�faut est 609 soit <var>UTF-8</var>, <var>ISO-8859-1</var>, selon que le 610 syst�me de fichiers sous-jacent est unicode ou non. 611 612 <div class="example"><h3>Exemple :</h3><p><code> 613 IndexOptions Charset=UTF-8 614 </code></p></div> 615 </dd> 616 617 <dt><a name="indexoptions.type" id="indexoptions.type">Type=<var>type MIME</var></a> (<em>Versions 2.0.61 et 618 sup�rieures d'Apache</em>)</dt> 619 620 <dd>Le mot-cl� <code>Type</code> vous permet de sp�cifier le type 621 MIME de la page g�n�r�e. La valeur par d�faut est 622 <var>text/html</var>. 623 624 <div class="example"><h3>Exemple :</h3><p><code> 625 IndexOptions Type=text/plain 626 </code></p></div> 627 </dd> 628 629 <dt><a name="indexoptions.descriptionwidth" id="indexoptions.descriptionwidth">DescriptionWidth=[<var>n</var> | *]</a> (<em>Versions 2.0.23 et 630 sup�rieures d'Apache</em>)</dt> 631 632 <dd>Le mot-cl� <code>DescriptionWidth</code> vous permet de 633 sp�cifier la taille en caract�res de la colonne description.</dd> 634 635 <dd>Avec <code>-DescriptionWidth</code> (ou si l'option n'est pas 636 d�finie), <code class="module"><a href="/mod/mod_autoindex.html">mod_autoindex</a></code> calcule la meilleure 637 taille.</dd> 638 639 <dd><code>DescriptionWidth=<var>n</var></code> fixe la taille de 640 la colonne � <var>n</var> octets.</dd> 641 642 <dd><code>DescriptionWidth=*</code> ajuste la taille de la colonne 643 � la plus longue cha�ne de description.</dd> 644 645 <dd><strong>Voir la section concernant <code class="directive"><a href="#adddescription">AddDescription</a></code> pour les dangers 646 inh�rants � la troncature des descriptions.</strong></dd> 647 648 <dt><a name="indexoptions.fancyindexing" id="indexoptions.fancyindexing">FancyIndexing</a></dt> 649 650 <dd>Cette option active l'indexation "am�lior�e" des r�pertoires, 651 c'est � dire avec en-t�tes de colonnes sous forme d'hyper-liens 652 auto-r�f�rants.</dd> 653 654 <dt><a name="indexoptions.foldersfirst" id="indexoptions.foldersfirst">FoldersFirst</a> (<em>Versions 2.0.23 et 655 sup�rieures d'Apache</em>)</dt> 656 657 <dd>Lorsque cette option est activ�e, la liste des 658 sous-r�pertoires appara�tra <em>toujours</em> en premier, suivie 659 de la liste des fichiers normaux du r�pertoire. Le listing 660 comporte principalement deux parties, les fichiers et les 661 sous-r�pertoires, chacun d'eux �tant tri� s�par�ment et les 662 sous-r�pertoires affich�s en premier. Par exemple, si l'ordre de 663 tri est d�croissant par nom, et si <code>FoldersFirst</code> est 664 activ�, le sous-r�pertoire <code>Zed</code> sera affich� avant le 665 sous-r�pertoire <code>Beta</code>, qui sera lui-m�me affich� avant 666 les fichiers normaux <code>Gamma</code> et <code>Alpha</code>. 667 <strong>Cette option n'a d'effet que si <a href="#indexoptions.fancyindexing"><code>FancyIndexing</code></a> 668 est aussi activ�.</strong></dd> 669 670 <dt><a name="indexoptions.htmltable" id="indexoptions.htmltable">HTMLTable</a> 671 (<em>Exp�rimental, versions 2.0.23 et sup�rieures 672 d'Apache</em>)</dt> 673 674 <dd>Cette option exp�rimentale pour l'affichage 675 <code>FancyIndexing</code> permet de construire une table simple 676 pour l'affichage de l'index du r�pertoire. Notez que cela risque 677 de perturber les anciens navigateurs. Cette option s'av�rera 678 particuli�rement n�cessaire si les noms de fichiers ou les cha�nes 679 de description alternent entre les ordres de lecture gauche � 680 droite et droite � gauche, comme cela peut arriver sous WinNT ou 681 d'autres plate-formes o� utf-8 est activ�.</dd> 682 683 <dt><a name="indexoptions.iconsarelinks" id="indexoptions.iconsarelinks">IconsAreLinks</a></dt> 684 685 <dd>Configure la partie r�serv�e aux ic�nes de l'ancrage pour le 686 nom de fichier, dans le cas d'un affichage "am�lior�".</dd> 687 688 <dt><a name="indexoptions.iconheight" id="indexoptions.iconheight">IconHeight[=<var>pixels</var>]</a></dt> 689 690 <dd>Si cette option est pr�sente, en combinaison avec 691 <code>IconWidth</code>, le serveur va inclure les attributs 692 <code>height</code> et <code>width</code> dans la balise 693 <code>img</code> qui r�f�rence le fichier de l'ic�ne. Ceci va 694 permettre au navigateur de pr�voir les caract�ristiques de la page 695 sans devoir attendre que toutes les images aient �t� charg�es. En 696 l'absence de cette option, c'est la hauteur standard d�finie par 697 le logiciel Apache qui est choisie comme valeur par d�faut.</dd> 698 699 <dt><a name="indexoptions.iconwidth" id="indexoptions.iconwidth">IconWidth[=<var>pixels</var>]</a></dt> 700 701 <dd>Si cette option est pr�sente, en combinaison avec 702 <code>IconHeight</code>, le serveur va inclure les attributs 703 <code>height</code> et <code>width</code> dans la balise 704 <code>img</code> qui r�f�rence le fichier de l'ic�ne. Ceci va 705 permettre au navigateur de pr�voir les caract�ristiques de la page 706 sans devoir attendre que toutes les images aient �t� charg�es. En 707 l'absence de cette option, c'est la largeur standard d�finie par 708 le logiciel Apache qui est choisie comme valeur par d�faut.</dd> 709 710 <dt><a name="indexoptions.ignorecase" id="indexoptions.ignorecase">IgnoreCase</a></dt> 711 712 <dd>Si cette option est activ�e, les noms sont tri�s sans tenir 713 compte de la casse. Par exemple, si le tri s'effectue sur les noms 714 dans l'ordre croissant, et si <code>IgnoreCase</code> est activ�, 715 le fichier Zeta appara�tra apr�s le fichier alfa (Note : le 716 fichier GAMMA appara�tra toujours avant le fichier gamma). 717 </dd> 718 719 <dt><a name="indexoptions.ignoreclient" id="indexoptions.ignoreclient">IgnoreClient</a></dt> 720 721 <dd>Si cette option est activ�e, <code class="module"><a href="/mod/mod_autoindex.html">mod_autoindex</a></code> va 722 ignorer toutes les variables de requ�te fournies par le client, y 723 compris les informations de tri (ce qui implique l'activation de 724 l'option <code><a href="#indexoptions.suppresscolumnsorting">SuppressColumnSorting</a></code>).</dd> 725 726 <dt><a name="indexoptions.namewidth" id="indexoptions.namewidth">NameWidth=[<var>n</var> 727 | *]</a></dt> 728 729 <dd>Le mot-cl� <code>NameWidth</code> vous permet de sp�cifier la 730 largeur en octets de la colonne correspondant au nom du 731 fichier.</dd> 732 733 <dd>Avec <code>-NameWidth</code> (ou si l'option n'est pas 734 d�finie), <code class="module"><a href="/mod/mod_autoindex.html">mod_autoindex</a></code> va calculer la meilleure largeur 735 possible.</dd> 736 737 <dd><code>NameWidth=<var>n</var></code> fixe la largeur de la 738 colonne � <var>n</var> octets.</dd> 739 740 <dd><code>NameWidth=*</code> d�finit la largeur de colonne � la 741 valeur n�cessaire.</dd> 742 743 <dt><a name="indexoptions.scanhtmltitles" id="indexoptions.scanhtmltitles">ScanHTMLTitles</a></dt> 744 745 <dd>L'activation de cette option permet d'extraire le titre des 746 documents HTML dans le cas d'un affichage "am�lior�". Si le fichier 747 ne poss�de aucune description d�finie par la directive <code class="directive"><a href="#adddescription">AddDescription</a></code>, httpd va lire 748 le document pour tenter d'en extraire le <code>titre</code>. Ce 749 processus est co�teux en ressources disque et CPU.</dd> 750 751 <dt><a name="indexoptions.showforbidden" id="indexoptions.showforbidden">ShowForbidden</a></dt> 752 753 <dd>Si cette option est activ�e, Apache affichera les fichiers 754 normalement cach�s suite au retour des valeurs 755 <code>HTTP_UNAUTHORIZED</code> ou <code>HTTP_FORBIDDEN</code> par 756 la sous-requ�te.</dd> 757 758 <dt><a name="indexoptions.suppresscolumnsorting" id="indexoptions.suppresscolumnsorting">SuppressColumnSorting</a></dt> 759 760 <dd>Si cette option est activ�e, Apache supprimera les liens 761 hyper-texte dans les en-t�tes de colonnes dans le cas d'un 762 affichage "am�lior�". Par d�faut, ces en-t�tes constituent des liens 763 hyper-texte, et la s�lection de l'un d'entre eux va trier l'index 764 du r�pertoire en fonction des valeurs de la colonne 765 correspondante. <strong>Avant 766 Apache 2.0.23, cette option d�sactivait aussi l'interpr�tation des 767 informations de tri transmises via les arguments de la 768 requ�te.</strong> Depuis Apache 2.0.23, ce comportement est 769 contr�l� par <a href="#indexoptions.ignoreclient"><code>IndexOptions 770 IgnoreClient</code></a>.</dd> 771 772 <dt><a name="indexoptions.suppressdescription" id="indexoptions.suppressdescription">SuppressDescription</a></dt> 773 774 <dd>L'activation de cette option va supprimer la description des 775 fichiers dans le cas d'un affichage "am�lior�". Par d�faut aucune 776 description de fichier n'est d�finie, et par cons�quent 777 l'utilisation de cette option va permettre de r�cup�rer un espace 778 � l'�cran de 23 caract�res pouvant �tre utilis� pour autre chose. 779 Voir la directive <code class="directive"><a href="#adddescription">AddDescription</a></code> pour plus d'informations � propos de 780 la d�finition des descriptions de fichiers. Voir aussi l'option 781 d'index <code><a href="#indexoptions.descriptionwidth">DescriptionWidth</a></code> 782 pour limiter la taille de la colonne description.</dd> 783 784 <dt><a name="indexoptions.suppresshtmlpreamble" id="indexoptions.suppresshtmlpreamble">SuppressHTMLPreamble</a></dt> 785 786 <dd>Si le r�pertoire contient effectivement le fichier sp�cifi� 787 par la directive <code class="directive"><a href="#headername">HeaderName</a></code>, le module inclut 788 en g�n�ral le contenu du fichier apr�s avoir ins�r� un pr�ambule 789 HTML standard (<code><html></code>, 790 <code><head></code>, <em>etc...</em>). L'activation de 791 l'option <code>SuppressHTMLPreamble</code> supprime l'insertion de 792 ce pr�ambule, et le module va alors commencer l'affichage 793 directement par le contenu du fichier d'en-t�te. Dans ce cas par 794 contre, le fichier d'en-t�te doit contenir des instructions HTML 795 appropri�es. S'il n'y a pas de fichier d'en-t�te, le pr�ambule est 796 g�n�r� comme dans le cas g�n�ral.</dd> 797 798 <dt><a name="indexoptions.suppressicon" id="indexoptions.suppressicon">SuppressIcon</a> 799 (<em>Versions 2.0.23 et sup�rieures d'Apache</em>)</dt> 800 801 <dd>L'activation de cette option supprime l'affichage des ic�nes 802 dans le cas d'un affichage "am�lior�". La combinaison de 803 <code>SuppressIcon</code> et <code>SuppressRules</code> permet de 804 g�n�rer une sortie au format HTML 3.2 qui, selon les derni�res 805 sp�cifications, interdit les �l�ments <code>img</code> et 806 <code>hr</code> dans les blocs <code>pre</code> (utilis�s pour 807 formater les affichages "am�lior�s").</dd> 808 809 <dt><a name="indexoptions.suppresslastmodified" id="indexoptions.suppresslastmodified">SuppressLastModified</a></dt> 810 811 <dd>L'activation de cette option supprime l'affichage de la date 812 de derni�re modification dans le cas d'un affichage "am�lior�".</dd> 813 814 <dt><a name="indexoptions.suppressrules" id="indexoptions.suppressrules">SuppressRules</a> 815 (<em>Versions 2.0.23 et sup�rieures d'Apache</em>)</dt> 816 817 <dd>L'activation de cette option supprime l'affichage des lignes 818 horizontales (�l�ments <code>hr</code>) dans les index de 819 r�pertoires. La combinaison de 820 <code>SuppressIcon</code> et <code>SuppressRules</code> permet de 821 g�n�rer une sortie au format HTML 3.2 qui, selon les derni�res 822 sp�cifications, interdit les �l�ments <code>img</code> et 823 <code>hr</code> dans les blocs <code>pre</code> (utilis�s pour 824 formater les affichages "am�lior�s").</dd> 825 826 <dt><a name="indexoptions.suppresssize" id="indexoptions.suppresssize">SuppressSize</a></dt> 827 828 <dd>L'activation de cette option supprime l'affichage de la taille 829 du fichier dans le cas d'un affichage "am�lior�".</dd> 830 831 <dt><a name="indexoptions.trackmodified" id="indexoptions.trackmodified">TrackModified</a> 832 (<em>Versions 2.0.23 et sup�rieures d'Apache</em>)</dt> 833 834 <dd>Cette option renvoie les valeurs <code>Last-Modified</code> et 835 <code>ETag</code> pour le r�pertoire index� dans l'en-t�te HTTP. 836 Elle n'est valide que si le syst�me d'exploitation et le syst�me 837 de fichiers renvoient des r�sultats appropri�s pour la fonction 838 stat(). C'est le cas de certains syst�mes Unix, ainsi que JFS sous 839 OS2 et les volumes NTFS sous Win32. Ce n'est par contre pas le cas 840 des volumes OS2 et FAT Win32. Lorsque cette option est activ�e, le 841 client ou le mandataire peuvent d�tecter les changements dans la 842 liste des fichiers lorsqu'ils effectuent une requ�te 843 <code>HEAD</code>. Notez que certains syst�mes d'exploitation 844 d�tectent correctement les nouveaux fichiers et les fichiers 845 supprim�s, mais ne d�tectent pas les modifications de tailles ou 846 de dates des fichiers du r�pertoire. <strong>Les modifications de 847 taille ou de date d'un fichier existant ne mettent pas � jour 848 l'en-t�te <code>Last-Modified</code> sur toutes les plate-formes 849 Unix.</strong> Si c'est le cas, laissez cette option 850 d�sactiv�e.</dd> 851 852 <dt><a name="indexoptions.versionsort" id="indexoptions.versionsort">VersionSort</a> 853 (<em>Apache 2.0a3 and later</em>)</dt> 854 855 <dd>Le mot-cl� <code>VersionSort</code> permet de trier les 856 fichiers contenant des num�ros de version d'une mani�re 857 sp�cifique. Les cha�nes sont tri�es comme d'habitude, except� les 858 sous-cha�nes de chiffres du nom de fichier et de sa description 859 qui sont compar�es en fonction de leur valeur num�rique. 860 861 <div class="example"><h3>Exemple :</h3><p><code> 862 foo-1.7<br /> 863 foo-1.7.2<br /> 864 foo-1.7.12<br /> 865 foo-1.8.2<br /> 866 foo-1.8.2a<br /> 867 foo-1.12 868 </code></p></div> 869 870 <p>Si le nombre commence par le chiffre 0, il est consid�r� comme 871 la partie fractionnaire d'un nombre :</p> 872 873 <div class="example"><p><code> 874 foo-1.001<br /> 875 foo-1.002<br /> 876 foo-1.030<br /> 877 foo-1.04 878 </code></p></div> 879 </dd> 880 881 <dt><a name="indexoptions.xhtml" id="indexoptions.xhtml">XHTML</a> 882 (<em>Versions 2.0.49 et sup�rieures d'Apache</em>)</dt> 883 884 <dd>Le mot-cl� <code>XHTML</code> enjoint 885 <code class="module"><a href="/mod/mod_autoindex.html">mod_autoindex</a></code> de g�n�rer du code XHTML 1.0 au 886 lieu de HTML 3.2.</dd> 887 </dl> 888 889 890 <dl><dt>Options d'index incr�mentales</dt> 891 <dd> 892 <p>Apache 1.3.3 a apport� d'importantes modifications dans la 893 gestion des directives <code class="directive">IndexOptions</code>. En 894 particulier :</p> 895 896 <ul> 897 <li>Plusieurs directives <code class="directive">IndexOptions</code> 898 apparaissant dans la m�me section directory sont maintenant 899 fusionn�es. Le r�sultat de : 900 901 <div class="example"><p><code> 902 <Directory /foo> 903 <span class="indent"> 904 IndexOptions HTMLTable<br /> 905 IndexOptions SuppressColumnsorting 906 </span> 907 </Directory> 908 </code></p></div> 909 910 <p>est �quivalent �</p> 911 912 <div class="example"><p><code> 913 IndexOptions HTMLTable SuppressColumnsorting 914 </code></p></div> 915 </li> 916 917 <li>L'ajout de la syntaxe incr�mentale (en pr�fixant les mots-cl�s 918 avec <code>+</code> ou <code>-</code>).</li> 919 </ul> 920 921 <p>Chaque fois qu'un mot-cl� pr�fix� par '+' ou '-' est trouv�, il 922 est appliqu� aux d�finitions des 923 <code class="directive">IndexOptions</code> courantes (qui ont �t� 924 �ventuellement h�rit�es d'un directory de niveau sup�rieur). Par 925 contre, si un mot-cl� non pr�fix� est trouv�, il supprime toutes 926 les definitions h�rit�es, ainsi que toute 927 d�finition incr�mentale. Consid�rons l'exemple 928 suivant :</p> 929 930 <div class="example"><p><code> 931 IndexOptions +ScanHTMLTitles -IconsAreLinks FancyIndexing<br /> 932 IndexOptions +SuppressSize 933 </code></p></div> 934 935 <p>L'effet global est �quivalent � l'effet qu'aurait provoqu� 936 <code>IndexOptions FancyIndexing +SuppressSize</code>, car l'option 937 non pr�fix�e <code>FancyIndexing</code> annulent les mots-cl�s 938 incr�mentaux situ�s avant elle, mais leur permet ensuite de 939 s'incr�menter � nouveau.</p> 940 941 <p>Pour d�finir inconditionnellement les 942 <code class="directive">IndexOptions</code> pour un r�pertoire particulier, 943 tout en supprimant les d�finitions h�rit�es, sp�cifiez les 944 mots-cl�s sans pr�fixe <code>+</code> ou <code>-</code></p> 945 </dd> 946 </dl> 947 948</div> 949<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 950<div class="directive-section"><h2><a name="IndexOrderDefault" id="IndexOrderDefault">IndexOrderDefault</a> <a name="indexorderdefault" id="indexorderdefault">Directive</a></h2> 951<table class="directive"> 952<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 953r�pertoire</td></tr> 954<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>IndexOrderDefault Ascending|Descending 955Name|Date|Size|Description</code></td></tr> 956<tr><th><a href="directive-dict.html#Default">D�faut:</a></th><td><code>IndexOrderDefault Ascending Name</code></td></tr> 957<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 958<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Indexes</td></tr> 959<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 960<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr> 961</table> 962 <p>La directive <code class="directive">IndexOrderDefault</code> s'utilise 963 en combinaison avec l'option d'index <code><a href="#indexoptions.fancyindexing">FancyIndexing</a></code>. Par 964 d�faut, les index de r�pertoire "am�lior�s" sont affich�s selon l'ordre 965 croissant des noms de fichiers ; la directive 966 <code class="directive">IndexOrderDefault</code> vous permet de modifier ce 967 comportement.</p> 968 969 <p>La directive <code class="directive">IndexOrderDefault</code> accepte 970 deux arguments. Le premier est soit <code>Ascending</code>, soit 971 <code>Descending</code>, et indique l'ordre de tri. Le second doit 972 prendre une des valeurs <code>Name</code>, <code>Date</code>, 973 <code>Size</code>, ou <code>Description</code>, et permet 974 d'identifier la cl� primaire. La cl� secondaire est 975 <em>toujours</em> le nom du fichier selon un ordre croissant.</p> 976 977 <p>Si vous le d�sirez, vous pouvez emp�cher le client de modifier 978 l'ordre de tri de la liste en ajoutant l'option d'index <code><a href="#indexoptions.suppresscolumnsorting">SuppressColumnSorting</a></code> 979 qui supprime le lien de d�finition du tri de l'en-t�te de la 980 colonne, ainsi que l'option <code><a href="#indexoptions.ignoreclient">IgnoreClient</a></code> qui 981 emp�che ce m�me client de passer outre vos pr�f�rences de tri en 982 ajoutant manuellement des options de tri � la cha�ne de param�tres 983 de la requ�te.</p> 984 985</div> 986<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 987<div class="directive-section"><h2><a name="IndexStyleSheet" id="IndexStyleSheet">IndexStyleSheet</a> <a name="indexstylesheet" id="indexstylesheet">Directive</a></h2> 988<table class="directive"> 989<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ajoute une feuille de style CSS � l'index du 990r�pertoire</td></tr> 991<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>IndexStyleSheet <var>chemin-url</var></code></td></tr> 992<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 993<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Indexes</td></tr> 994<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 995<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr> 996</table> 997 <p>La directive <code class="directive">IndexStyleSheet</code> permet de 998 d�finir le nom du fichier qui servira de feuille de style CSS pour 999 l'index. 1000 </p> 1001 <div class="example"><h3>Exemple</h3><p><code> 1002 1003 IndexStyleSheet "/css/style.css" 1004 </code></p></div> 1005 1006</div> 1007<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 1008<div class="directive-section"><h2><a name="ReadmeName" id="ReadmeName">ReadmeName</a> <a name="readmename" id="readmename">Directive</a></h2> 1009<table class="directive"> 1010<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Nom du fichier dont le contenu sera ins�r� � la fin de 1011l'index</td></tr> 1012<tr><th><a href="directive-dict.html#Syntax">Syntaxe:</a></th><td><code>ReadmeName <var>nom-fichier</var></code></td></tr> 1013<tr><th><a href="directive-dict.html#Context">Contexte:</a></th><td>configuration du serveur, serveur virtuel, r�pertoire, .htaccess</td></tr> 1014<tr><th><a href="directive-dict.html#Override">AllowOverride:</a></th><td>Indexes</td></tr> 1015<tr><th><a href="directive-dict.html#Status">Statut:</a></th><td>Base</td></tr> 1016<tr><th><a href="directive-dict.html#Module">Module:</a></th><td>mod_autoindex</td></tr> 1017</table> 1018 <p>La directive <code class="directive">ReadmeName</code> permet de d�finir 1019 le nom du fichier dont le contenu sera ajout� � la fin de l'index. 1020 <var>nom-fichier</var> est le nom du fichier � inclure, et est 1021 consid� comme relatif au r�pertoire faisant l'objet de l'index. Si 1022 <var>nom-fichier</var> commence par un slash '/', il sera consid�r� 1023 comme relatif au r�pertoire d�fini par la directive <code class="directive"><a href="/mod/core.html#documentroot">DocumentRoot</a></code>. 1024 </p> 1025 1026 <div class="example"><h3>Exemple</h3><p><code> 1027 ReadmeName FOOTER.html 1028 </code></p></div> 1029 1030 <div class="example"><h3>Exemple 2</h3><p><code> 1031 ReadmeName /include/FOOTER.html 1032 </code></p></div> 1033 1034 <p>Voir aussi la directive <code class="directive"><a href="#headername">HeaderName</a></code>, o� cette fonctionnalit� est d�crite plus en 1035 d�tails.</p> 1036 1037</div> 1038</div> 1039<div class="bottomlang"> 1040<p><span>Langues Disponibles: </span><a href="/en/mod/mod_autoindex.html" hreflang="en" rel="alternate" title="English"> en </a> | 1041<a href="/fr/mod/mod_autoindex.html" title="Fran�ais"> fr </a> | 1042<a href="/ja/mod/mod_autoindex.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | 1043<a href="/ko/mod/mod_autoindex.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | 1044<a href="/tr/mod/mod_autoindex.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p> 1045</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&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> 1046<script type="text/javascript"><!--//--><![CDATA[//><!-- 1047var comments_shortname = 'httpd'; 1048var comments_identifier = 'http://httpd.apache.org/docs/2.2/mod/mod_autoindex.html'; 1049(function(w, d) { 1050 if (w.location.hostname.toLowerCase() == "httpd.apache.org") { 1051 d.write('<div id="comments_thread"><\/div>'); 1052 var s = d.createElement('script'); 1053 s.type = 'text/javascript'; 1054 s.async = true; 1055 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; 1056 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); 1057 } 1058 else { 1059 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); 1060 } 1061})(window, document); 1062//--><!]]></script></div><div id="footer"> 1063<p class="apache">Copyright 2013 The Apache Software Foundation.<br />Autoris� sous <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p> 1064<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.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[//><!-- 1065if (typeof(prettyPrint) !== 'undefined') { 1066 prettyPrint(); 1067} 1068//--><!]]></script> 1069</body></html>