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