Return-Path: Delivered-To: apmail-httpd-cvs-archive@www.apache.org Received: (qmail 71911 invoked from network); 4 Oct 2009 11:48:58 -0000 Received: from hermes.apache.org (HELO mail.apache.org) (140.211.11.3) by minotaur.apache.org with SMTP; 4 Oct 2009 11:48:58 -0000 Received: (qmail 69603 invoked by uid 500); 4 Oct 2009 11:48:57 -0000 Delivered-To: apmail-httpd-cvs-archive@httpd.apache.org Received: (qmail 69532 invoked by uid 500); 4 Oct 2009 11:48:57 -0000 Mailing-List: contact cvs-help@httpd.apache.org; run by ezmlm Precedence: bulk Reply-To: dev@httpd.apache.org list-help: list-unsubscribe: List-Post: List-Id: Delivered-To: mailing list cvs@httpd.apache.org Received: (qmail 69523 invoked by uid 99); 4 Oct 2009 11:48:57 -0000 Received: from nike.apache.org (HELO nike.apache.org) (192.87.106.230) by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 04 Oct 2009 11:48:57 +0000 X-ASF-Spam-Status: No, hits=-2000.0 required=10.0 tests=ALL_TRUSTED X-Spam-Check-By: apache.org Received: from [140.211.11.4] (HELO eris.apache.org) (140.211.11.4) by apache.org (qpsmtpd/0.29) with ESMTP; Sun, 04 Oct 2009 11:48:52 +0000 Received: by eris.apache.org (Postfix, from userid 65534) id 2A6F22388908; Sun, 4 Oct 2009 11:48:31 +0000 (UTC) Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit Subject: svn commit: r821517 [2/2] - in /httpd/httpd/trunk/docs/manual/mod: allmodules.xml.fr mod_autoindex.html mod_autoindex.html.en mod_autoindex.html.fr mod_autoindex.xml.fr mod_autoindex.xml.meta Date: Sun, 04 Oct 2009 11:48:30 -0000 To: cvs@httpd.apache.org From: gryzor@apache.org X-Mailer: svnmailer-1.0.8 Message-Id: <20091004114831.2A6F22388908@eris.apache.org> X-Virus-Checked: Checked by ClamAV on apache.org Added: httpd/httpd/trunk/docs/manual/mod/mod_autoindex.xml.fr URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_autoindex.xml.fr?rev=821517&view=auto ============================================================================== --- httpd/httpd/trunk/docs/manual/mod/mod_autoindex.xml.fr (added) +++ httpd/httpd/trunk/docs/manual/mod/mod_autoindex.xml.fr Sun Oct 4 11:48:30 2009 @@ -0,0 +1,1074 @@ + + + + + + + + + + +mod_autoindex + +Génère automatiquement des index de répertoires d'une +manière similaire à la commande Unix ls, ou à la commande +shell Win32 dir +Base +mod_autoindex.c +autoindex_module + + +

L'index d'un répertoire peut être généré de deux manières :

+ +
    +
  • Un fichier écrit par l'utilisateur, en général appelé + index.html, mais dont le nom peut être défini par la + directive DirectoryIndex. C'est le module + mod_dir qui traite alors cet index.
    • + +
  • Un listing généré par le serveur, dont le format est contrôlé + par un certain nombre de directives. Les directives AddIcon, AddIconByEncoding et AddIconByType permettent de + définir une liste d'icônes à afficher en fonction des différents + types de fichiers ; pour chaque fichier listé, le premier icône + qui correspond au type du fichier est affiché. C'est le module + mod_autoindex qui traite alors cet index.
    • +
+

Les deux fonctions sont séparées, si bien que vous pouvez + entièrement supprimer (ou remplacer) la génération automatique + d'index, si vous le souhaitez.

+ +

On active la génération automatique d'index en spécifiant + Options +Indexes. Voir la directive Options pour plus de détails.

+ +

Si la directive IndexOptions est spécifiée avec + l'option FancyIndexing, les en-têtes de colonnes sont des liens + qui permettent de contrôler l'ordre de tri de l'affichage. Si vous + actionnez le lien d'un en-tête, le listing sera généré à nouveau, + trié en fonction des valeurs de la colonne concernée. Si l'on + actionne de manière répétitive le même en-tête, l'ordre de tri est + commuté entre les ordres croissant et décroissant. On peut supprimer + ces liens d'en-têtes de colonnes à l'aide de l'option + SuppressColumnSorting de la directive IndexOptions.

+ +

Notez que lorsque l'affichage est trié en fonction de la taille, + c'est la taille réelle qui est prise en compte, et non la + valeur affichée - ainsi, un fichier de 1010 octets sera toujours + affiché avant un fichier de 1011 octets (en ordre croissant), même + si la taille affichée des deux fichiers est "1K".

+ + +
+ Arguments de la requête d'autoindexation + +

Apache 2.0.23 a réorganisé les arguments de requête pour le tri + des colonnes, et intoduit un groupe complet de nouvelles options de + requête. Pour interdire effectivement au client tout contrôle sur + l'affichage, l'option IndexOptions + IgnoreClient a été ajoutée.

+ +

Les en-têtes de tri des colonnes eux-mêmes sont des hyper-liens + auto-référant qui ajoutent les options de tri à la requête énumérées + ci-dessous qui peuvent être ajoutées à toute requête concernant la + ressource répertoire.

+ +
    +
  • C=N trie l'affichage en fonction du nom de + fichier
    • + +
  • C=M trie l'affichage en fonction de la date de + dernière modification, puis du nom de fichier
    • + +
  • C=S trie l'affichage en fonction de la taille, + puis du nom de fichier
    • + +
  • C=D trie l'affichage en fonction + de la description, puis du nom de fichier
    • + +
  • O=A trie l'affichage selon l'ordre croissant
    • + +
  • O=D trie l'affichage selon + l'ordre décroissant
    • + +
  • F=0 affiche le listing sous la forme d'une simple + liste (sans FancyIndex)
    • + +
  • F=1 affiche le listing avec en-têtes de colonnes + sous forme de liens hyper-textes (FancyIndexed)
    • + +
  • F=2 affiche le listing sous + forme de table HTML avec en-têtes de colonnes contenant des liens + hyper-textes (FancyIndexed)
    • + +
  • V=0 désactive le tri en fonction de la + version
    • + +
  • V=1 active le tri en fonction de + la version
    • + +
  • P=modèle n'affiche que les fichiers + correspondant au modèle spécifié
    • +
+ +

Notez que l'argument 'P' (pour Pattern) n'est testé + qu'après que les directives habituelles IndexIgnore ont été traitées, + et que tous les noms de fichiers sont encore assujettis aux mêmes + critères que pour tout autre listing auto-indexé. L'interpréteur + d'arguments de requête de mod_autoindex s'arrête + immédiatement s'il rencontre une option non reconnue. Les arguments + de requête doivent être bien formés, selon la table ci-dessus.

+ +

Les options de requêtes sont illustrées par l'exemple ci-dessous, + qui peut être copié et collé dans un fichier header.html. Notez que + l'argument inconnu "X", pour le bouton submit, est introduit en + dernier afin de s'assurer que tous les arguments ont été + interprétés avant que mod_autoindex ne rencontre l'entrée X=Go.

+ + + <form action="" method="get">
+ + Montre moi une <select name="F">
+ + <option value="0"> liste simple</option>
+ <option value="1" selected="selected"> liste avec + en-têtes</option>
+ <option value="2"> liste avec en-tête sous forme de + table</option>
+ + </select>
+ triée par <select name="C">
+ + <option value="N" selected="selected"> nom</option>
+ <option value="M"> date de modification</option>
+ <option value="S"> taille</option>
+ <option value="D"> description</option>
+ + </select>
+ <select name="O">
+ + <option value="A" selected="selected"> croissant</option>
+ <option value="D"> décroissant</option>
+ + </select>
+ <select name="V">
+ + <option value="0" selected="selected"> dans l'ordre + normal</option>
+ <option value="1"> en fonction de la version</option>
+ + </select>
+ correspondant à <input type="text" name="P" value="*" />
+ <input type="submit" name="X" value="Go" />
+ + </form> + + +
+ + +AddAlt +Texte optionnel à afficher à la place d'un icône pour un +fichier en fonction de son nom +AddAlt texte fichier [fichier] ... +server configvirtual host +directory.htaccess + +Indexes + + +

La directive AddAlt permet d'afficher un + texte optionnel pour un fichier, à la place d'un icône, dans le cas + d'un affichage FancyIndexing. + fichier est une extension de fichier, un nom de fichier + partiel, une expression avec caractères génériques ou un nom de + fichier complet permettant de caractériser le(s) fichier(s) + concerné(s). Si texte contient des espaces, vous devez + l'entourer de guillemets ou d'apostrophes (" ou + '). Ce texte optionnel sera affiché si le client ne + peut pas afficher d'images, si le chargement d'images est désactivé + ou si l'icône ne peut pas être trouvé.

+ + Exemples + AddAlt "Fichier PDF" *.pdf
+ AddAlt Compressé *.gz *.zip *.Z + + + + + +AddAltByEncoding +Texte optionnel à afficher à la place d'un icône pour un +fichier en fonction de son codage MIME +AddAltByEncoding texte codage MIME +[codage MIME] ... +server configvirtual host +directory.htaccess + +Indexes + + +

La directive AddAltByEncoding permet + d'afficher un texte optionnel à la place d'un icône pour un fichier + dans le cas d'un affichage FancyIndexing. + codage MIME doit être un type valide, comme + x-compress. Si texte contient des espaces, + vous devez l'entourer de guillemets ou d'apostrophes (" + ou '). Ce texte optionnel sera affiché si le client ne + peut pas afficher d'images, si le chargement d'images est désactivé + ou si l'icône ne peut pas être trouvé.

+ + Exemple + AddAltByEncoding gzip x-gzip + + + + + +AddAltByType +Texte optionnel à afficher à la place d'un icône pour un +fichier en fonction de son type MIME +AddAltByType texte type MIME +[type MIME] ... +server configvirtual host +directory.htaccess + +Indexes + + +

La directive AddAltByType permet + d'afficher un texte optionnel à la place d'un icône pour un fichier + dans le cas d'un affichage FancyIndexing. + type MIME doit être un type MIME valide, comme + text/html. Si texte contient des espaces, + vous devez l'entourer de guillemets ou d'apostrophes (" + ou '). Ce texte optionnel sera affiché si le client ne + peut pas afficher d'images, si le chargement d'images est désactivé + ou si l'icône ne peut pas être trouvé.

+ + Exemple + AddAltByType 'Fichier texte' text/plain + + + + + +AddDescription +Afficher la description d'un fichier +AddDescription texte [fichier] ... +server configvirtual host +directory.htaccess + +Indexes + + +

Cette directive permet d'afficher une description pour un + fichier, dans le cas d'un affichage FancyIndexing. + fichier est une extension de fichier, un nom de fichier + partiel, une expression avec caractères génériques ou un nom de + fichier complet permettant de caractériser le fichier. + texte doit être entouré de guillemets + (").

+ + Exemple + AddDescription "La planète Mars" /web/pics/mars.gif + + +

La taille par défaut, habituelle du champ de description est de + 23 octets. L'option IndexOptions SuppressIcon ajoute 6 octets, l'option + IndexOptions + SuppressSize en ajoute 7 et l'option IndexOptions + SuppressLastModified en ajoute 19. Ainsi, la plus grande + taille par défaut qui peut être assignée à la colonne description + est de 55 octets.

+ +

Voir le mot-clé DescriptionWidth de la directive module="mod_autoindex">IndexOptions pour plus de + détails sur la manière d'augmenter la taille de cette colonne, ou + pour permettre des descriptions de taille illimitée.

+ + Avertissement +

Le texte descriptif défini par la directive + AddDescription peut contenir des marquages + HTML, comme des balises ou des entités caractères. Si la limite de + taille de la colonne description venait à tronquer une balise (par + exemple couper la fin d'une phrase en caractères gras), le + résultat pourrait en affecter toute la suite du listing du + répertoire.

+ + + + + +AddIcon +Icône à afficher pour un fichier en fonction de son +nom +AddIcon icône nom [nom] +... +server configvirtual host +directory.htaccess + +Indexes + + +

Cette directive permet de déterminer l'icône à afficher à côté + d'un fichier dont le nom se termine par nom, dans le cas + d'un affichage FancyIndexing. icône est soit une URL relative + (échappée par des caractères '%') vers l'icône, soit de la forme + (alttext,url), où + alttext est le symbole texte correspondant à l'icône à + afficher dans les navigateurs en mode texte.

+ +

nom correspond à ^^DIRECTORY^^ pour les + répertoires, ^^BLANKICON^^ pour les lignes vides + (pour personnaliser la présentation du listing), une extension de + fichier, une expression avec caractères génériques, un nom de + fichier partiel ou un nom de fichier complet.

+ + Exemples + AddIcon (IMG,/icons/image.xbm) .gif .jpg .xbm
+ AddIcon /icons/dir.xbm ^^DIRECTORY^^
+ AddIcon /icons/backup.xbm *~ + + +

Lorsque c'est possible, il est préférable d'utiliser AddIconByType plutôt que + AddIcon.

+ + + + +AddIconByEncoding +Icône à afficher à côté d'un fichier en fonction de son +codage MIME +AddIconByEncoding icône codage MIME +[codage MIME] ... +server configvirtual host +directory.htaccess + +Indexes + + +

Cette directive permet de déterminer l'icône à afficher à côté + d'un fichier dans le cas d'un affichage FancyIndexing. + icône est soit une URL relative + (échappée par des caractères '%') vers l'icône, soit de la forme + (alttext,url), où + alttext est le symbole texte correspondant à l'icône à + afficher dans les navigateurs en mode texte.

+ +

codage MIME doit être un codage valide, comme + x-compress.

+ + Exemple + AddIconByEncoding /icons/compress.xbm x-compress + + + + + +AddIconByType +Icône à afficher à côté d'un fichier en fonction de son +type MIME +AddIconByType icône type MIME +[type MIME] ... +server configvirtual host +directory.htaccess + +Indexes + + +

Cette directive permet de déterminer l'icône à afficher à côté + d'un fichier de type MIME type MIME dans le cas d'un + affichage FancyIndexing. + icône est soit une URL relative + (échappée par des caractères '%') vers l'icône, soit de la forme + (alttext,url), où + alttext est le symbole texte correspondant à l'icône à + afficher dans les navigateurs en mode texte.

+ +

type MIME est une expression avec caractères + génériques représentant le type MIME.

+ + Exemple + AddIconByType (IMG,/icons/image.xbm) image/* + + + + + +DefaultIcon +Icône à afficher par défaut lorsqu'aucun icône spécifique +n'est précisé +DefaultIcon chemin URL +server configvirtual host +directory.htaccess + +Indexes + + +

La directive DefaultIcon permet de définir + l'icône à afficher à côté d'un fichier lorsqu'aucun icône spécifique + n'a été précisé, dans le cas d'un affichage FancyIndexing. + chemin URL est une URL relative (échappée par des + caractères '%') vers l'icône.

+ + Exemple + DefaultIcon /icon/inconnu.xbm + + + + + +HeaderName +Nom du fichier qui sera inséré au début de la page +contenant l'index +HeaderName nom fichier +server configvirtual host +directory.htaccess + +Indexes + + +

La directive HeaderName permet de définir + le nom du fichier qui sera inséré au début de la page contenant + l'index. nom fichier est le nom du fichier à inclure.

+ + Exemple + HeaderName HEADER.html + + + +

Les deux directives HeaderName et ReadmeName traitent maintenant + nom fichier comme un chemin URI relatif au chemin + utilisé pour accéder au répertoire faisant l'objet de l'index. Si + nom fichier commence par un slash '/', il sera + considéré comme relatif au répertoire défini par la directive + DocumentRoot.

+ + Exemple + HeaderName /include/HEADER.html + + +

nom fichier doit correspondre à un document dont le + type MIME est du style text/* (par exemple + text/html, text/plain, etc...). Cela + signifie que nom fichier peut faire référence à un + script CGI si le véritable type MIME du script (et non celui de sa + sortie) est marqué comme text/html par exemple à + l'aide d'une directive comme :

+ + + AddType text/html .cgi + + +

Une négociation de + contenu sera effectuée si Options MultiViews a été + précisé. Si nom fichier correspond à un document + statique text/html (et non à un script CGI), et une + des deux options + Includes ou IncludesNOEXEC est activée, + le fichier sera traité en tant qu'inclusion côté serveur (Server + Side Include) (voir la documentation de + mod_include).

+ + +

Si le fichier spécifié par la directive + HeaderName contient les en-têtes d'un + document HTML ((<html>, <head>, etc...), vous serez + probablement amené à définir IndexOptions + +SuppressHTMLPreamble, de manière à ce que ces balises ne + soient pas répétées.

+ + + + +IndexIgnore +Ajouts à la liste des fichiers à cacher lors de l'affichage +de l'index d'un répertoire +IndexIgnore fichier [fichier] ... +server configvirtual host +directory.htaccess + +Indexes + + +

La directive IndexIgnore permet + d'effectuer des ajouts à la liste des fichiers à cacher lors de + l'affichage de l'index d'un répertoire. fichier est une + expression avec caractères génériques de style shell ou un nom de + fichier complet. Plusieurs directives IndexIgnore effectuent des + ajouts à la liste, et ne remplacent pas la liste des fichiers à + ignorer. Par défaut, la liste contient . (le répertoire + courant).

+ + + IndexIgnore README .htaccess *.bak *~ + + + + + +IndexOptions +Diverses options de configuration pour l'indexation d'un +répertoire +IndexOptions [+|-]option [[+|-]option] +... +server configvirtual host +directory.htaccess + +Indexes + + +

La directive IndexOptions permet de + spécifier les options de configuration de l'indexation du + répertoire. option peut prendre l'une des valeurs + suivantes :

+ +
+
Charset=jeu de caractères (Versions 2.0.61 et + supérieures d'Apache)
+ +
Le mot-clé Charset vous permet de spécifier le + jeu de caractères de la page générée. La valeur par défaut est + soit UTF-8, ISO-8859-1, selon que le + système de fichiers sous-jacent est unicode ou non. + + Exemple : + IndexOptions Charset=UTF-8 + +
+ +
Type=type MIME (Versions 2.0.61 et + supérieures d'Apache)
+ +
Le mot-clé Type vous permet de spécifier le type + MIME de la page générée. La valeur par défaut est + text/html. + + Exemple : + IndexOptions Type=text/plain + +
+ +
DescriptionWidth=[n | *] (Versions 2.0.23 et + supérieures d'Apache)
+ +
Le mot-clé DescriptionWidth vous permet de + spécifier la taille en caractères de la colonne description.
+ +
Avec -DescriptionWidth (ou si l'option n'est pas + définie), mod_autoindex calcule la meilleure + taille.
+ +
DescriptionWidth=n fixe la taille de + la colonne à n octets.
+ +
DescriptionWidth=* ajuste la taille de la colonne + à la plus longue chaîne de description.
+ +
Voir la section concernant AddDescription pour les dangers + inhérants à la troncature des descriptions.
+ +
FancyIndexing
+ +
Cette option active l'indexation "améliorée" des répertoires, + c'est à dire avec en-têtes de colonnes sous forme d'hyper-liens + auto-référants.
+ +
FoldersFirst (Versions 2.0.23 et + supérieures d'Apache)
+ +
Lorsque cette option est activée, la liste des + sous-répertoires apparaîtra toujours en premier, suivie + de la liste des fichiers normaux du répertoire. Le listing + comporte principalement deux parties, les fichiers et les + sous-répertoires, chacun d'eux étant trié séparément et les + sous-répertoires affichés en premier. Par exemple, si l'ordre de + tri est décroissant par nom, et si FoldersFirst est + activé, le sous-répertoire Zed sera affiché avant le + sous-répertoire Beta, qui sera lui-même affiché avant + les fichiers normaux Gamma et Alpha. + Cette option n'a d'effet que si FancyIndexing + est aussi activé.
+ +
HTMLTable + (Expérimental, versions 2.0.23 et supérieures + d'Apache)
+ +
Cette option expérimentale pour l'affichage + FancyIndexing permet de construire une table simple + pour l'affichage de l'index du répertoire. Notez que cela risque + de perturber les anciens navigateurs. Cette option s'avèrera + particulièrement nécessaire si les noms de fichiers ou les chaînes + de description alternent entre les ordres de lecture gauche à + droite et droite à gauche, comme cela peut arriver sous WinNT ou + d'autres plate-formes où utf-8 est activé.
+ +
IconsAreLinks
+ +
Configure la partie réservée aux icônes de l'ancrage pour le + nom de fichier, dans le cas d'un affichage "amélioré".
+ +
IconHeight[=pixels]
+ +
Si cette option est présente, en combinaison avec + IconWidth, le serveur va inclure les attributs + height et width dans la balise + img qui référence le fichier de l'icône. Ceci va + permettre au navigateur de prévoir les caractéristiques de la page + sans devoir attendre que toutes les images aient été chargées. En + l'absence de cette option, c'est la hauteur standard définie par + le logiciel Apache qui est choisie comme valeur par défaut.
+ +
IconWidth[=pixels]
+ +
Si cette option est présente, en combinaison avec + IconHeight, le serveur va inclure les attributs + height et width dans la balise + img qui référence le fichier de l'icône. Ceci va + permettre au navigateur de prévoir les caractéristiques de la page + sans devoir attendre que toutes les images aient été chargées. En + l'absence de cette option, c'est la largeur standard définie par + le logiciel Apache qui est choisie comme valeur par défaut.
+ +
IgnoreCase
+ +
Si cette option est activée, les noms sont triés sans tenir + compte de la casse. Par exemple, si le tri s'effectue sur les noms + dans l'ordre croissant, et si IgnoreCase est activé, + le fichier Zeta apparaîtra après le fichier alfa (Note : le + fichier GAMMA apparaîtra toujours avant le fichier gamma). +
+ +
IgnoreClient
+ +
Si cette option est activée, mod_autoindex va + ignorer toutes les variables de requête fournies par le client, y + compris les informations de tri (ce qui implique l'activation de + l'option SuppressColumnSorting).
+ +
NameWidth=[n + | *]
+ +
Le mot-clé NameWidth vous permet de spécifier la + largeur en octets de la colonne correspondant au nom du + fichier.
+ +
Avec -NameWidth (ou si l'option n'est pas + définie), mod_autoindex va calculer la meilleure largeur + possible.
+ +
NameWidth=n fixe la largeur de la + colonne à n octets.
+ +
NameWidth=* définit la largeur de colonne à la + valeur nécessaire.
+ +
ScanHTMLTitles
+ +
L'activation de cette option permet d'extraire le titre des + documents HTML dans le cas d'un affichage "amélioré". Si le fichier + ne possède aucune description définie par la directive AddDescription, httpd va lire + le document pour tenter d'en extraire le titre. Ce + processus est coûteux en ressources disque et CPU.
+ +
ShowForbidden
+ +
Si cette option est activée, Apache affichera les fichiers + normalement cachés suite au retour des valeurs + HTTP_UNAUTHORIZED ou HTTP_FORBIDDEN par + la sous-requête.
+ +
SuppressColumnSorting
+ +
Si cette option est activée, Apache supprimera les liens + hyper-texte dans les en-têtes de colonnes dans le cas d'un + affichage "amélioré". Par défaut, ces en-têtes constituent des liens + hyper-texte, et la sélection de l'un d'entre eux va trier l'index + du répertoire en fonction des valeurs de la colonne + correspondante. Avant + Apache 2.0.23, cette option désactivait aussi l'interprétation des + informations de tri transmises via les arguments de la + requête. Depuis Apache 2.0.23, ce comportement est + contrôlé par IndexOptions + IgnoreClient.
+ +
SuppressDescription
+ +
L'activation de cette option va supprimer la description des + fichiers dans le cas d'un affichage "amélioré". Par défaut aucune + description de fichier n'est définie, et par conséquent + l'utilisation de cette option va permettre de récupérer un espace + à l'écran de 23 caractères pouvant être utilisé pour autre chose. + Voir la directive AddDescription pour plus d'informations à propos de + la définition des descriptions de fichiers. Voir aussi l'option + d'index DescriptionWidth + pour limiter la taille de la colonne description.
+ +
SuppressHTMLPreamble
+ +
Si le répertoire contient effectivement le fichier spécifié + par la directive HeaderName, le module inclut + en général le contenu du fichier après avoir inséré un préambule + HTML standard (<html>, + <head>, etc...). L'activation de + l'option SuppressHTMLPreamble supprime l'insertion de + ce préambule, et le module va alors commencer l'affichage + directement par le contenu du fichier d'en-tête. Dans ce cas par + contre, le fichier d'en-tête doit contenir des instructions HTML + appropriées. S'il n'y a pas de fichier d'en-tête, le préambule est + généré comme dans le cas général.
+ +
SuppressIcon + (Versions 2.0.23 et supérieures d'Apache)
+ +
L'activation de cette option supprime l'affichage des icônes + dans le cas d'un affichage "amélioré". La combinaison de + SuppressIcon et SuppressRules permet de + générer une sortie au format HTML 3.2 qui, selon les dernières + spécifications, interdit les éléments img et + hr dans les blocs pre (utilisés pour + formater les affichages "améliorés").
+ +
SuppressLastModified
+ +
L'activation de cette option supprime l'affichage de la date + de dernière modification dans le cas d'un affichage "amélioré".
+ +
SuppressRules + (Versions 2.0.23 et supérieures d'Apache)
+ +
L'activation de cette option supprime l'affichage des lignes + horizontales (éléments hr) dans les index de + répertoires. La combinaison de + SuppressIcon et SuppressRules permet de + générer une sortie au format HTML 3.2 qui, selon les dernières + spécifications, interdit les éléments img et + hr dans les blocs pre (utilisés pour + formater les affichages "améliorés").
+ +
SuppressSize
+ +
L'activation de cette option supprime l'affichage de la taille + du fichier dans le cas d'un affichage "amélioré".
+ +
TrackModified + (Versions 2.0.23 et supérieures d'Apache)
+ +
Cette option renvoie les valeurs Last-Modified et + ETag pour le répertoire indexé dans l'en-tête HTTP. + Elle n'est valide que si le système d'exploitation et le système + de fichiers renvoient des résultats appropriés pour la fonction + stat(). C'est le cas de certains systèmes Unix, ainsi que JFS sous + OS/2 ou + les volumes NTFS sous Win32. Ce n'est par contre pas le cas + des volumes FAT Win32 et OS/2. Lorsque cette option est activée, le + client ou le mandataire peuvent détecter les changements dans la + liste des fichiers lorsqu'ils effectuent une requête + HEAD. Notez que certains systèmes d'exploitation + détectent correctement les nouveaux fichiers et les fichiers + supprimés, mais ne détectent pas les modifications de tailles ou + de dates des fichiers du répertoire. Les modifications de + taille ou de date d'un fichier existant ne mettent pas à jour + l'en-tête Last-Modified sur toutes les plate-formes + Unix. Si c'est le cas, laissez cette option + désactivée.
+ +
VersionSort + (Apache 2.0a3 and later)
+ +
Le mot-clé VersionSort permet de trier les + fichiers contenant des numéros de version d'une manière + spécifique. Les chaînes sont triées comme d'habitude, excepté les + sous-chaînes de chiffres du nom de fichier et de sa description + qui sont comparées en fonction de leur valeur numérique. + + Exemple : + foo-1.7
+ foo-1.7.2
+ foo-1.7.12
+ foo-1.8.2
+ foo-1.8.2a
+ foo-1.12 + + +

Si le nombre commence par le chiffre 0, il est considéré comme + la partie fractionnaire d'un nombre :

+ + + foo-1.001
+ foo-1.002
+ foo-1.030
+ foo-1.04 + +
+ +
XHTML + (Versions 2.0.49 et supérieures d'Apache)
+ +
Le mot-clé XHTML enjoint + mod_autoindex de générer du code XHTML 1.0 au + lieu de HTML 3.2.
+
+ + +
Options d'index incrémentales
+
+

Apache 1.3.3 a apporté d'importantes modifications dans la + gestion des directives IndexOptions. En + particulier :

+ +
    +
  • Plusieurs directives IndexOptions + apparaissant dans la même section directory sont maintenant + fusionnées. Le résultat de : + + + <Directory /foo> + + IndexOptions HTMLTable
    + IndexOptions SuppressColumnsorting +     + </Directory> +     + +

    est équivalent à

    + + + IndexOptions HTMLTable SuppressColumnsorting + +
    • + +
  • L'ajout de la syntaxe incrémentale (en préfixant les mots-clés + avec + ou -).
    • +
+ +

Chaque fois qu'un mot-clé préfixé par '+' ou '-' est trouvé, il + est appliqué aux définitions des + IndexOptions courantes (qui ont été + éventuellement héritées d'un directory de niveau supérieur). Par + contre, si un mot-clé non préfixé est trouvé, il supprime toutes + les definitions héritées, ainsi que toute + définition incrémentale. Considérons l'exemple + suivant :

+ + + IndexOptions +ScanHTMLTitles -IconsAreLinks FancyIndexing
+ IndexOptions +SuppressSize + + +

L'effet global est équivalent à l'effet qu'aurait provoqué + IndexOptions FancyIndexing +SuppressSize, car l'option + non préfixée FancyIndexing annule les mots-clés + incrémentaux situés avant elle, mais leur permet ensuite de + s'incrémenter à nouveau.

+ +

Pour définir inconditionnellement les + IndexOptions pour un répertoire particulier, + tout en supprimant les définitions héritées, spécifiez les + mots-clés sans préfixe + ou -

+
+
+ + + + +IndexOrderDefault +Définit l'ordre d'affichage par défaut d'un index de +répertoire +IndexOrderDefault Ascending|Descending +Name|Date|Size|Description +IndexOrderDefault Ascending Name +server configvirtual host +directory.htaccess + +Indexes + + +

La directive IndexOrderDefault s'utilise + en combinaison avec l'option d'index FancyIndexing. Par + défaut, les index de répertoires "améliorés" sont affichés selon l'ordre + croissant des noms de fichiers ; la directive + IndexOrderDefault vous permet de modifier ce + comportement.

+ +

La directive IndexOrderDefault accepte + deux arguments. Le premier est soit Ascending, soit + Descending, et indique l'ordre de tri. Le second doit + prendre une des valeurs Name, Date, + Size, ou Description, et permet + d'identifier la clé primaire. La clé secondaire est + toujours le nom du fichier selon un ordre croissant.

+ +

Vous pouvez forcer l'affichage de l'index d'un répertoire selon + un certain ordre en utilisant la directive + IndexOrderDefault conjointement avec l'option + d'index SuppressColumnSorting ; ceci aura pour effet d'ignorer + les demandes d'affichage de l'index du répertoire par le client + selon un ordre différent.

+ + + + +IndexStyleSheet +Ajoute une feuille de style CSS à l'index du +répertoire +IndexStyleSheet chemin-url +server configvirtual host +directory.htaccess + +Indexes + + +

La directive IndexStyleSheet permet de + définir le nom du fichier qui servira de feuille de style CSS pour + l'index. +

+ + Exemple + IndexStyleSheet "/css/style.css" + + + + + +IndexHeadInsert +Insère du texte dans la section HEAD de la page +d'index. +IndexHeadInsert "marque ..." +server configvirtual host +directory.htaccess + +Indexes + + +

La directive IndexHeadInsert permet de + spécifier une chaîne de caractères à insérer dans la section + <head> du code HTML généré pour la page + d'index.

+ + Exemple + IndexHeadInsert "<link rel=\"sitemap\" href=\"/sitemap.html\">" + + + + + +ReadmeName +Nom du fichier dont le contenu sera inséré à la fin de +l'index +ReadmeName nom-fichier +server configvirtual host +directory.htaccess + +Indexes + + +

La directive ReadmeName permet de définir + le nom du fichier dont le contenu sera ajouté à la fin de l'index. + nom-fichier est le nom du fichier à inclure, et est + considéré comme relatif au répertoire faisant l'objet de l'index. Si + nom-fichier commence par un slash '/', il sera considéré + comme relatif au répertoire défini par la directive DocumentRoot. +

+ + Exemple + ReadmeName FOOTER.html + + + Exemple 2 + ReadmeName /include/FOOTER.html + + +

Voir aussi la directive HeaderName, où cette fonctionnalité est décrite plus en + détails.

+ + + + Modified: httpd/httpd/trunk/docs/manual/mod/mod_autoindex.xml.meta URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/docs/manual/mod/mod_autoindex.xml.meta?rev=821517&r1=821516&r2=821517&view=diff ============================================================================== --- httpd/httpd/trunk/docs/manual/mod/mod_autoindex.xml.meta (original) +++ httpd/httpd/trunk/docs/manual/mod/mod_autoindex.xml.meta Sun Oct 4 11:48:30 2009 @@ -8,6 +8,7 @@ en + fr ja ko tr