-<?xml version="1.0"?>
+<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
<?xml-stylesheet type="text/xsl" href="../style/manual.fr.xsl"?>
-<!-- English Revision : 1673945 -->
+<!-- English Revision : 1741874 -->
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
<modulesynopsis metafile="mod_autoindex.xml.meta">
<name>mod_autoindex</name>
-<description>Génère automatiquement des index de répertoires d'une
-manière similaire à la commande Unix <code>ls</code>, ou à la commande
+<description>Génère automatiquement des index de répertoires d'une
+manière similaire à la commande Unix <code>ls</code>, ou à la commande
shell Win32 <code>dir</code></description>
<status>Base</status>
<sourcefile>mod_autoindex.c</sourcefile>
<identifier>autoindex_module</identifier>
<summary>
- <p>L'index d'un répertoire peut être généré de deux manières :</p>
+ <p>L'index d'un répertoire peut être généré de deux manières :</p>
<ul>
- <li>Un fichier situé dans ce répertoire, en général appelé
- <code>index.html</code>, mais dont le nom de ce ou ces fichiers peut être défini par la
+ <li>Un fichier situé dans ce répertoire, en général appelé
+ <code>index.html</code>, mais dont le nom de ce ou ces fichiers peut être défini par la
directive <directive
module="mod_dir">DirectoryIndex</directive>. C'est le module
<module>mod_dir</module> qui traite alors cet index.</li>
- <li>Un listing généré par le serveur, dont le format est contrôlé
+ <li>Un listing généré par le serveur, dont le format est contrôlé
par un certain nombre de directives. Les directives <directive
module="mod_autoindex">AddIcon</directive>, <directive
module="mod_autoindex">AddIconByEncoding</directive> et <directive
module="mod_autoindex">AddIconByType</directive> 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
+ 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
<module>mod_autoindex</module> qui traite alors cet index.</li>
</ul>
- <p>Les deux fonctions sont séparées, si bien que vous pouvez
- entièrement supprimer (ou remplacer) la génération automatique
+ <p>Les deux fonctions sont séparées, si bien que vous pouvez
+ entièrement supprimer (ou remplacer) la génération automatique
d'index, si vous le souhaitez.</p>
- <p>On active la génération automatique d'index en spécifiant
+ <p>On active la génération automatique d'index en spécifiant
<code>Options +Indexes</code>. Voir la directive <directive
- module="core">Options</directive> pour plus de détails.</p>
+ module="core">Options</directive> pour plus de détails.</p>
<p>Si la directive <directive
- module="mod_autoindex">IndexOptions</directive> est spécifiée avec
+ module="mod_autoindex">IndexOptions</directive> est spécifiée avec
l'option <code><a href="#indexoptions.fancyindexing"
- >FancyIndexing</a></code>, les en-têtes de colonnes sont des liens
- qui permettent de contrôler l'ordre de tri de l'affichage. Si vous
- actionnez le lien d'un en-tête, le listing sera généré à nouveau,
- trié en fonction des valeurs de la colonne concernée. Si l'on
- actionne de manière répétitive le même en-tête, l'ordre de tri est
- commuté entre les ordres croissant et décroissant. On peut supprimer
- ces liens d'en-têtes de colonnes à l'aide de l'option
+ >FancyIndexing</a></code>, les en-têtes de colonnes sont des liens
+ qui permettent de contrôler l'ordre de tri de l'affichage. Si vous
+ actionnez le lien d'un en-tête, le listing sera généré à nouveau,
+ trié en fonction des valeurs de la colonne concernée. Si l'on
+ actionne de manière répétitive le même en-tête, l'ordre de tri est
+ commuté entre les ordres croissant et décroissant. On peut supprimer
+ ces liens d'en-têtes de colonnes à l'aide de l'option
<code><a
href="#indexoptions.suppresscolumnsorting">SuppressColumnSorting</a></code>
de la directive <directive
module="mod_autoindex">IndexOptions</directive>.</p>
- <p>Notez que lorsque l'affichage est trié en fonction de la taille,
- c'est la taille <em>réelle</em> qui est prise en compte, et non la
- valeur affichée - ainsi, un fichier de 1010 octets sera toujours
- affiché avant un fichier de 1011 octets (en ordre croissant), même
- si la taille affichée des deux fichiers est "1K".</p>
+ <p>Notez que lorsque l'affichage est trié en fonction de la taille,
+ c'est la taille <em>réelle</em> qui est prise en compte, et non la
+ valeur affichée - ainsi, un fichier de 1010 octets sera toujours
+ affiché avant un fichier de 1011 octets (en ordre croissant), même
+ si la taille affichée des deux fichiers est "1K".</p>
</summary>
<section id="query">
- <title>Arguments de la requête d'autoindexation</title>
+ <title>Arguments de la requête d'autoindexation</title>
- <p>La chaîne de paramètres de la requête peut contenir de nombreux
- arguments permettant dans une certaine mesure au client de contrôler
- l'ordre de l'index du répertoire, ainsi que la liste des fichiers à
- afficher. Si vous souhaitez désactiver cette fonctionnalité,
+ <p>La chaîne de paramètres de la requête peut contenir de nombreux
+ arguments permettant dans une certaine mesure au client de contrôler
+ l'ordre de l'index du répertoire, ainsi que la liste des fichiers à
+ afficher. Si vous souhaitez désactiver cette fonctionnalité,
utilisez l'option <code><a
href="#indexoptions.ignoreclient">IndexOptions
IgnoreClient</a></code>.</p>
- <p>Les en-têtes de tri des colonnes eux-mêmes sont des hyper-liens
- auto-référant qui ajoutent les options de tri à la requête énumérées
- ci-dessous qui peuvent être ajoutées à toute requête concernant la
- ressource répertoire.</p>
+ <p>Les en-têtes de tri des colonnes eux-mêmes sont des hyper-liens
+ auto-référant qui ajoutent les options de tri à la requête énumérées
+ ci-dessous qui peuvent être ajoutées à toute requête concernant la
+ ressource répertoire.</p>
<ul>
<li><code>C=N</code> trie l'affichage en fonction du nom de
fichier</li>
<li><code>C=M</code> trie l'affichage en fonction de la date de
- dernière modification, puis du nom de fichier</li>
+ dernière modification, puis du nom de fichier</li>
<li><code>C=S</code> trie l'affichage en fonction de la taille,
puis du nom de fichier</li>
<li><code>O=A</code> trie l'affichage selon l'ordre croissant</li>
<li class="separate"><code>O=D</code> trie l'affichage selon
- l'ordre décroissant</li>
+ l'ordre décroissant</li>
<li><code>F=0</code> affiche le listing sous la forme d'une simple
liste (sans FancyIndex)</li>
- <li><code>F=1</code> affiche le listing avec en-têtes de colonnes
+ <li><code>F=1</code> affiche le listing avec en-têtes de colonnes
sous forme de liens hyper-textes (FancyIndexed)</li>
<li class="separate"><code>F=2</code> affiche le listing sous
- forme de table HTML avec en-têtes de colonnes contenant des liens
+ forme de table HTML avec en-têtes de colonnes contenant des liens
hyper-textes (FancyIndexed)</li>
- <li><code>V=0</code> désactive le tri en fonction de la
+ <li><code>V=0</code> désactive le tri en fonction de la
version</li>
<li class="separate"><code>V=1</code> active le tri en fonction de
la version</li>
- <li><code>P=<var>modèle</var></code> n'affiche que les fichiers
- correspondant au <var>modèle</var> spécifié</li>
+ <li><code>P=<var>modèle</var></code> n'affiche que les fichiers
+ correspondant au <var>modèle</var> spécifié</li>
</ul>
- <p>Notez que l'argument 'P' (pour Pattern) n'est testé
- qu'<em>après</em> que les directives habituelles <directive
- module="mod_autoindex">IndexIgnore</directive> 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 <module>mod_autoindex</module> s'arrête
- immédiatement s'il rencontre une option non reconnue. Les arguments
- de requête doivent être bien formés, selon la table ci-dessus.</p>
-
- <p>Les options de requêtes sont illustrées par l'exemple ci-dessous,
- qui peut être copié et collé dans un fichier header.html. Notez que
+ <p>Notez que l'argument 'P' (pour Pattern) n'est testé
+ qu'<em>après</em> que les directives habituelles <directive
+ module="mod_autoindex">IndexIgnore</directive> 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 <module>mod_autoindex</module> s'arrête
+ immédiatement s'il rencontre une option non reconnue. Les arguments
+ de requête doivent être bien formés, selon la table ci-dessus.</p>
+
+ <p>Les options de requêtes sont illustrées par l'exemple ci-dessous,
+ qui peut être copié et collé dans un fichier header.html. Notez que
l'argument inconnu "X", pour le bouton submit, est introduit en
- dernier afin de s'assurer que tous les arguments ont été
- interprétés avant que mod_autoindex ne rencontre l'entrée X=Go.</p>
+ dernier afin de s'assurer que tous les arguments ont été
+ interprétés avant que mod_autoindex ne rencontre l'entrée X=Go.</p>
<example>
<form action="" method="get"><br />
<indent>
<option value="0"> liste simple</option><br />
<option value="1" selected="selected"> liste avec
- en-têtes</option><br />
- <option value="2"> liste avec en-tête sous forme de
+ en-têtes</option><br />
+ <option value="2"> liste avec en-tête sous forme de
table</option><br />
</indent>
</select><br />
- triée par <select name="C"><br />
+ triée par <select name="C"><br />
<indent>
<option value="N" selected="selected"> nom</option><br />
<option value="M"> date de modification</option><br />
<select name="O"><br />
<indent>
<option value="A" selected="selected"> croissant</option><br />
- <option value="D"> décroissant</option><br />
+ <option value="D"> décroissant</option><br />
</indent>
</select><br />
<select name="V"><br />
<option value="1"> en fonction de la version</option><br />
</indent>
</select><br />
- correspondant à <input type="text" name="P" value="*" /><br />
+ correspondant à <input type="text" name="P" value="*" /><br />
<input type="submit" name="X" value="Go" /><br />
</indent>
</form>
<directivesynopsis>
<name>AddAlt</name>
-<description>Texte optionnel à afficher à la place d'un icône pour un
+<description>Texte optionnel à afficher à la place d'un icône pour un
fichier en fonction de son nom</description>
<syntax>AddAlt <var>texte</var> <var>fichier</var> [<var>fichier</var>] ...</syntax>
<contextlist><context>server config</context><context>virtual host</context>
<usage>
<p>La directive <directive>AddAlt</directive> permet d'afficher un
- texte optionnel pour un fichier, à la place d'un icône, dans le cas
+ texte optionnel pour un fichier, à la place d'un icône, dans le cas
d'un affichage <code><a
href="#indexoptions.fancyindexing">FancyIndexing</a></code>.
<var>fichier</var> est une extension de fichier, un nom de fichier
- partiel, une expression avec caractères génériques ou un nom de
- fichier complet permettant de caractériser le(s) fichier(s)
- concerné(s). Si <var>texte</var> contient des espaces, vous devez
+ partiel, une expression avec caractères génériques ou un nom de
+ fichier complet permettant de caractériser le(s) fichier(s)
+ concerné(s). Si <var>texte</var> contient des espaces, vous devez
l'entourer de guillemets ou d'apostrophes (<code>"</code> ou
- <code>'</code>). Ce texte optionnel sera affiché si le client ne
- peut pas afficher d'images, si le chargement d'images est désactivé
- ou si l'icône ne peut pas être trouvé.</p>
+ <code>'</code>). Ce texte optionnel sera affiché si le client ne
+ peut pas afficher d'images, si le chargement d'images est désactivé
+ ou si l'icône ne peut pas être trouvé.</p>
<highlight language="config">
AddAlt "PDF file" *.pdf
<directivesynopsis>
<name>AddAltByEncoding</name>
-<description>Texte optionnel à afficher à la place d'un icône pour un
+<description>Texte optionnel à afficher à la place d'un icône pour un
fichier en fonction de son codage MIME</description>
<syntax>AddAltByEncoding <var>texte</var> <var>codage MIME</var>
[<var>codage MIME</var>] ...</syntax>
<usage>
<p>La directive <directive>AddAltByEncoding</directive> permet
- d'afficher un texte optionnel à la place d'un icône pour un fichier
+ d'afficher un texte optionnel à la place d'un icône pour un fichier
dans le cas d'un affichage <code><a
href="#indexoptions.fancyindexing">FancyIndexing</a></code>.
- <var>codage MIME</var> doit être un type valide, comme
+ <var>codage MIME</var> doit être un type valide, comme
<code>x-compress</code>. Si <var>texte</var> contient des espaces,
vous devez l'entourer de guillemets ou d'apostrophes (<code>"</code>
- ou <code>'</code>). Ce texte optionnel sera affiché si le client ne
- peut pas afficher d'images, si le chargement d'images est désactivé
- ou si l'icône ne peut pas être trouvé.</p>
+ ou <code>'</code>). Ce texte optionnel sera affiché si le client ne
+ peut pas afficher d'images, si le chargement d'images est désactivé
+ ou si l'icône ne peut pas être trouvé.</p>
<highlight language="config">
AddAltByEncoding gzip x-gzip
<directivesynopsis>
<name>AddAltByType</name>
-<description>Texte optionnel à afficher à la place d'un icône pour un
+<description>Texte optionnel à afficher à la place d'un icône pour un
fichier en fonction de son type MIME</description>
<syntax>AddAltByType <var>texte</var> <var>type MIME</var>
[<var>type MIME</var>] ...</syntax>
<usage>
<p>La directive <directive>AddAltByType</directive> permet
- d'afficher un texte optionnel à la place d'un icône pour un fichier
+ d'afficher un texte optionnel à la place d'un icône pour un fichier
dans le cas d'un affichage <code><a
href="#indexoptions.fancyindexing">FancyIndexing</a></code>.
- <var>type MIME</var> doit être un type MIME valide, comme
+ <var>type MIME</var> doit être un type MIME valide, comme
<code>text/html</code>. Si <var>texte</var> contient des espaces,
vous devez l'entourer de guillemets ou d'apostrophes (<code>"</code>
- ou <code>'</code>). Ce texte optionnel sera affiché si le client ne
- peut pas afficher d'images, si le chargement d'images est désactivé
- ou si l'icône ne peut pas être trouvé.</p>
+ ou <code>'</code>). Ce texte optionnel sera affiché si le client ne
+ peut pas afficher d'images, si le chargement d'images est désactivé
+ ou si l'icône ne peut pas être trouvé.</p>
<highlight language="config">
AddAltByType 'Fichier texte' text/plain
fichier, dans le cas d'un affichage <code><a
href="#indexoptions.fancyindexing">FancyIndexing</a></code>.
<var>fichier</var> est une extension de fichier, un nom de fichier
- partiel, une expression avec caractères génériques ou un nom de
- fichier complet permettant de caractériser le fichier.
- <var>texte</var> doit être entouré de guillemets
+ partiel, une expression avec caractères génériques ou un nom de
+ fichier complet permettant de caractériser le fichier.
+ <var>texte</var> doit être entouré de guillemets
(<code>"</code>).</p>
<highlight language="config">
AddDescription "My friend Marshall" friends/mars.gif
</highlight>
- <p>La taille par défaut, habituelle du champ de description est de
+ <p>La taille par défaut, habituelle du champ de description est de
23 octets. L'option <code><a href="#indexoptions.suppressicon"
>IndexOptions SuppressIcon</a></code> ajoute 6 octets, l'option
<code><a href="#indexoptions.suppresssize">IndexOptions
SuppressSize</a></code> en ajoute 7 et l'option <code><a
href="#indexoptions.suppresslastmodified">IndexOptions
SuppressLastModified</a></code> en ajoute 19. Ainsi, la plus grande
- taille par défaut qui peut être assignée à la colonne description
+ taille par défaut qui peut être assignée à la colonne description
est de 55 octets.</p>
- <p>Comme l'argument <var>fichier</var> peut être un nom de fichier
- partiel, vous devez garder à l'esprit qu'un nom de fichier partiel
- trop court pourra correspondre à des fichiers non voulus. Par
+ <p>Comme l'argument <var>fichier</var> peut être un nom de fichier
+ partiel, vous devez garder à l'esprit qu'un nom de fichier partiel
+ trop court pourra correspondre à des fichiers non voulus. Par
exemple, <code>le.html</code> correspondra au fichier
<code>le.html</code>, mais aussi au fichier
- <code>example.html</code>. En cas d'ambiguïté, utilisez un nom de
+ <code>example.html</code>. En cas d'ambiguïté, utilisez un nom de
fichier aussi complet que possible, et ordonnez votre liste de
- directives <code>AddDescription</code> en conséquence.</p>
+ directives <code>AddDescription</code> en conséquence.</p>
- <p>Voir le mot-cl
é <a href="#indexoptions.descriptionwidth"
+ <p>Voir le mot-cl
é <a href="#indexoptions.descriptionwidth"
>DescriptionWidth</a> de la directive <directive
>module="mod_autoindex">IndexOptions</directive> pour plus de
- détails sur la manière d'augmenter la taille de cette colonne, ou
- pour permettre des descriptions de taille illimitée.</p>
+ détails sur la manière d'augmenter la taille de cette colonne, ou
+ pour permettre des descriptions de taille illimitée.</p>
<note><title>Avertissement</title>
- <p>Le texte descriptif défini par la directive
+ <p>Le texte descriptif défini par la directive
<directive>AddDescription</directive> peut contenir des marquages
- HTML, comme des balises ou des entités caractères. Si la limite de
- taille de la colonne description venait à tronquer une balise (par
- exemple couper la fin d'une phrase en caractères gras), le
- résultat pourrait en affecter toute la suite du listing du
- répertoire.</p>
+ HTML, comme des balises ou des entités caractères. Si la limite de
+ taille de la colonne description venait à tronquer une balise (par
+ exemple couper la fin d'une phrase en caractères gras), le
+ résultat pourrait en affecter toute la suite du listing du
+ répertoire.</p>
</note>
<note><title>Arguments avec chemins</title>
- <p>Les chemins absolus ne sont actuellement pas supportés et ne
- peuvent correspondre à aucun chemin réel à l'exécution. Les
- arguments contenant des chemins relatifs, qui ne devraient être
- normalement utilisés que dans les fichiers htaccess, sont
- implicitement préfixés par '*/' afin d'éviter toute association
- avec des noms de répertoires partiels.</p>
+ <p>Les chemins absolus ne sont actuellement pas supportés et ne
+ peuvent correspondre à aucun chemin réel à l'exécution. Les
+ arguments contenant des chemins relatifs, qui ne devraient être
+ normalement utilisés que dans les fichiers htaccess, sont
+ implicitement préfixés par '*/' afin d'éviter toute association
+ avec des noms de répertoires partiels.</p>
</note>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>AddIcon</name>
-<description>Icône à afficher pour un fichier en fonction de son
+<description>Icône à afficher pour un fichier en fonction de son
nom</description>
-<syntax>AddIcon <var>icône</var> <var>nom</var> [<var>nom</var>]
+<syntax>AddIcon <var>icône</var> <var>nom</var> [<var>nom</var>]
...</syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
<override>Indexes</override>
<usage>
- <p>Cette directive permet de déterminer l'icône à afficher à côté
+ <p>Cette directive permet de déterminer l'icône à afficher à côté
d'un fichier dont le nom se termine par <var>nom</var>, dans le cas
d'un affichage <code><a href="#indexoptions.fancyindexing"
- >FancyIndexing</a></code>. <var>icône</var> est une URL relative
- (échappée par des caractères '%') vers
- l'icône, une URL distante pleinement qualifiée, ou de la forme
- <code>(<var>alttext</var>,<var>url</var>)</code>, où
- <var>alttext</var> est le symbole texte correspondant à l'icône à
+ >FancyIndexing</a></code>. <var>icône</var> est une URL relative
+ (échappée par des caractères '%') vers
+ l'icône, une URL distante pleinement qualifiée, ou de la forme
+ <code>(<var>alttext</var>,<var>url</var>)</code>, où
+ <var>alttext</var> est le symbole texte correspondant à l'icône à
afficher dans les navigateurs en mode texte.</p>
- <p><var>nom</var> correspond à <code>^^DIRECTORY^^</code> pour les
- répertoires, <code>^^BLANKICON^^</code> pour les lignes vides
- (pour personnaliser la présentation du listing), une extension de
- fichier, une expression avec caractères génériques, un nom de
+ <p><var>nom</var> correspond à <code>^^DIRECTORY^^</code> pour les
+ répertoires, <code>^^BLANKICON^^</code> pour les lignes vides
+ (pour personnaliser la présentation du listing), une extension de
+ fichier, une expression avec caractères génériques, un nom de
fichier partiel ou un nom de fichier complet.</p>
- <p><code>^^BLANKICON^^</code> n'est utilisé que pour le formatage,
- et n'est donc pas nécessaire si vous utilisez <code>IndexOptions
+ <p><code>^^BLANKICON^^</code> n'est utilisé que pour le formatage,
+ et n'est donc pas nécessaire si vous utilisez <code>IndexOptions
HTMLTable</code>.</p>
<highlight language="config">
AddIcon /icons/backup.png *~
</highlight>
- <p>Lorsque c'est possible, il est préférable d'utiliser <directive
- module="mod_autoindex">AddIconByType</directive> plutôt que
+ <p>Lorsque c'est possible, il est préférable d'utiliser <directive
+ module="mod_autoindex">AddIconByType</directive> plutôt que
<directive>AddIcon</directive>.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>AddIconByEncoding</name>
-<description>Icône à afficher à côté d'un fichier en fonction de son
+<description>Icône à afficher à côté d'un fichier en fonction de son
codage MIME</description>
-<syntax>AddIconByEncoding <var>icône</var> <var>codage MIME</var>
+<syntax>AddIconByEncoding <var>icône</var> <var>codage MIME</var>
[<var>codage MIME</var>] ...</syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
<override>Indexes</override>
<usage>
- <p>Cette directive permet de déterminer l'icône à afficher à côté
+ <p>Cette directive permet de déterminer l'icône à afficher à côté
d'un fichier dans le cas d'un affichage <code><a
href="#indexoptions.fancyindexing">FancyIndexing</a></code>.
- <var>icône</var> est une URL relative
- (échappée par des caractères '%') vers
- l'icône, une URL pleinement qualifiée, ou de la forme
- <code>(<var>alttext</var>,<var>url</var>)</code>, où
- <var>alttext</var> est le symbole texte correspondant à l'icône à
+ <var>icône</var> est une URL relative
+ (échappée par des caractères '%') vers
+ l'icône, une URL pleinement qualifiée, ou de la forme
+ <code>(<var>alttext</var>,<var>url</var>)</code>, où
+ <var>alttext</var> est le symbole texte correspondant à l'icône à
afficher dans les navigateurs en mode texte.</p>
- <p><var>codage MIME</var> doit être un codage valide, comme
+ <p><var>codage MIME</var> doit être un codage valide, comme
<code>x-compress</code>.</p>
<highlight language="config">
<directivesynopsis>
<name>AddIconByType</name>
-<description>Icône à afficher à côté d'un fichier en fonction de son
+<description>Icône à afficher à côté d'un fichier en fonction de son
type MIME</description>
-<syntax>AddIconByType <var>icône</var> <var>type MIME</var>
+<syntax>AddIconByType <var>icône</var> <var>type MIME</var>
[<var>type MIME</var>] ...</syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
<override>Indexes</override>
<usage>
- <p>Cette directive permet de déterminer l'icône à afficher à côté
+ <p>Cette directive permet de déterminer l'icône à afficher à côté
d'un fichier de type MIME <var>type MIME</var> dans le cas d'un
affichage <code><a
href="#indexoptions.fancyindexing">FancyIndexing</a></code>.
- <var>icône</var> est une URL relative
- (échappée par des caractères '%') vers
- l'icône, une URL pleinement qualifiée, ou de la forme
- <code>(<var>alttext</var>,<var>url</var>)</code>, où
- <var>alttext</var> est le symbole texte correspondant à l'icône à
+ <var>icône</var> est une URL relative
+ (échappée par des caractères '%') vers
+ l'icône, une URL pleinement qualifiée, ou de la forme
+ <code>(<var>alttext</var>,<var>url</var>)</code>, où
+ <var>alttext</var> est le symbole texte correspondant à l'icône à
afficher dans les navigateurs en mode texte.</p>
- <p><var>type MIME</var> est une expression avec caractères
- génériques représentant le type MIME.</p>
+ <p><var>type MIME</var> est une expression avec caractères
+ génériques représentant le type MIME.</p>
<highlight language="config">
AddIconByType (IMG,/icons/image.png) image/*
<directivesynopsis>
<name>DefaultIcon</name>
-<description>Icône à afficher par défaut lorsqu'aucun icône spécifique
-n'est précisé</description>
+<description>Icône à afficher par défaut lorsqu'aucun icône spécifique
+n'est précisé</description>
<syntax>DefaultIcon <var>chemin URL</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
<override>Indexes</override>
<usage>
- <p>La directive <directive>DefaultIcon</directive> permet de définir
- l'icône à afficher à côté d'un fichier lorsqu'aucun icône spécifique
- n'a
été précisé, dans le cas d'un affichage <code><a
+ <p>La directive <directive>DefaultIcon</directive> permet de définir
+ l'icône à afficher à côté d'un fichier lorsqu'aucun icône spécifique
+ n'a
été précisé, dans le cas d'un affichage <code><a
href="#indexoptions.fancyindexing">FancyIndexing</a></code>.
- <var>chemin URL</var> est une URL relative (échappée par des
- caractères '%') vers l'icône ou une URL pleinement qualifiée.</p>
+ <var>chemin URL</var> est une URL relative (échappée par des
+ caractères '%') vers l'icône ou une URL pleinement qualifiée.</p>
<highlight language="config">
DefaultIcon /icon/unknown.png
<directivesynopsis>
<name>HeaderName</name>
-<description>Nom du fichier qui sera inséré au début de la page
+<description>Nom du fichier qui sera inséré au début de la page
contenant l'index</description>
<syntax>HeaderName <var>nom fichier</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
<override>Indexes</override>
<usage>
- <p>La directive <directive>HeaderName</directive> permet de définir
- le nom du fichier qui sera inséré au début de la page contenant
- l'index. <var>nom fichier</var> est le nom du fichier à inclure.</p>
+ <p>La directive <directive>HeaderName</directive> permet de définir
+ le nom du fichier qui sera inséré au début de la page contenant
+ l'index. <var>nom fichier</var> est le nom du fichier à inclure.</p>
<highlight language="config">
HeaderName HEADER.html
<p>Les deux directives HeaderName et <directive
module="mod_autoindex">ReadmeName</directive> traitent maintenant
<var>nom fichier</var> comme un chemin URI relatif au chemin
- utilisé pour accéder au répertoire faisant l'objet de l'index. Si
+ utilisé pour accéder au répertoire faisant l'objet de l'index. Si
<var>nom fichier</var> commence par un slash '/', il sera
- considéré comme relatif au répertoire défini par la directive
+ considéré comme relatif au répertoire défini par la directive
<directive module="core">DocumentRoot</directive>.</p>
<highlight language="config">
HeaderName /include/HEADER.html
</highlight>
- <p><var>nom fichier</var> doit correspondre à un document dont le
+ <p><var>nom fichier</var> doit correspondre à un document dont le
type MIME est du style <code>text/*</code> (<em>par exemple</em>
<code>text/html</code>, <code>text/plain</code>, etc...). Cela
- signifie que <var>nom fichier</var> peut faire référence à un
- script CGI si le véritable type MIME du script (et non celui de sa
- sortie) est marqué comme <code>text/html</code> par exemple à
+ signifie que <var>nom fichier</var> peut faire référence à un
+ script CGI si le véritable type MIME du script (et non celui de sa
+ sortie) est marqué comme <code>text/html</code> par exemple à
l'aide d'une directive comme :</p>
<highlight language="config">
AddType text/html .cgi
</highlight>
- <p>Une <a href="../content-negotiation.html">négociation de
- contenu</a> sera effectuée si <directive
- module="core">Options</directive> <code>MultiViews</code> a été
- précisé. Si <var>nom fichier</var> correspond à un document
- statique <code>text/html</code> (et non à un script CGI), et une
+ <p>Une <a href="../content-negotiation.html">négociation de
+ contenu</a> sera effectuée si <directive
+ module="core">Options</directive> <code>MultiViews</code> a été
+ précisé. Si <var>nom fichier</var> correspond à un document
+ statique <code>text/html</code> (et non à un script CGI), et une
des deux <directive module="core">options</directive>
- <code>Includes</code> ou <code>IncludesNOEXEC</code> est activée,
- le fichier sera traité en tant qu'inclusion côté serveur (Server
+ <code>Includes</code> ou <code>IncludesNOEXEC</code> est activée,
+ le fichier sera traité en tant qu'inclusion côté serveur (Server
Side Include) (voir la documentation de
<module>mod_include</module>).</p>
</note>
- <p>Si le fichier spécifié par la directive
- <directive>HeaderName</directive> contient les en-têtes d'un
+ <p>Si le fichier spécifié par la directive
+ <directive>HeaderName</directive> contient les en-têtes d'un
document HTML ((<html>, <head>, etc...), vous serez
- probablement amen
é à définir <a
+ probablement amen
é à définir <a
href="#indexoptions.suppresshtmlpreamble"><code>IndexOptions
- +SuppressHTMLPreamble</code></a>, de manière à ce que ces balises ne
- soient pas répétées.</p>
+ +SuppressHTMLPreamble</code></a>, de manière à ce que ces balises ne
+ soient pas répétées.</p>
</usage>
<seealso><directive module="mod_autoindex">ReadmeName</directive></seealso>
<directivesynopsis>
<name>IndexIgnore</name>
-<description>Ajouts à la liste des fichiers à cacher lors de l'affichage
-de l'index d'un répertoire</description>
+<description>Ajouts à la liste des fichiers à cacher lors de l'affichage
+de l'index d'un répertoire</description>
<syntax>IndexIgnore <var>fichier</var> [<var>fichier</var>] ...</syntax>
<default>IndexIgnore "."</default>
<contextlist><context>server config</context><context>virtual host</context>
<usage>
<p>La directive <directive>IndexIgnore</directive> permet
- d'effectuer des ajouts à la liste des fichiers à cacher lors de
- l'affichage de l'index d'un répertoire. <var>fichier</var> est une
- expression avec caractères génériques de style shell ou un nom de
+ d'effectuer des ajouts à la liste des fichiers à cacher lors de
+ l'affichage de l'index d'un répertoire. <var>fichier</var> est une
+ expression avec caractères génériques de style shell ou un nom de
fichier complet. Plusieurs directives IndexIgnore effectuent des
- ajouts à la liste, et ne remplacent pas la liste des fichiers à
- ignorer. Par défaut, la liste contient <code>.</code> (le répertoire
+ ajouts à la liste, et ne remplacent pas la liste des fichiers à
+ ignorer. Par défaut, la liste contient <code>.</code> (le répertoire
courant).</p>
<highlight language="config">
<directivesynopsis>
<name>IndexIgnoreReset</name>
-<description>Vide la liste des fichiers à cacher lors de l'affichage du
-contenu d'un répertoire</description>
+<description>Vide la liste des fichiers à cacher lors de l'affichage du
+contenu d'un répertoire</description>
<syntax>IndexIgnoreReset ON|OFF</syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
</contextlist>
<override>Indexes</override>
-<compatibility>Versions 2.3.10 et supérieures</compatibility>
+<compatibility>Versions 2.3.10 et supérieures</compatibility>
<usage>
<p>La directive <directive>IndexIgnoreReset</directive> supprime
- toute liste de fichiers définie par la directive
- <directive>IndexIgnore</directive> et héritée par ailleurs d'autres
+ toute liste de fichiers définie par la directive
+ <directive>IndexIgnore</directive> et héritée par ailleurs d'autres
sections de configuration.</p>
<highlight language="config">
</Directory>
</highlight>
- <note type="warning"><p>Revoyez la configuration par défaut pour une
- liste de modèles que vous voulez ignorer explicitement après usage
+ <note type="warning"><p>Revoyez la configuration par défaut pour une
+ liste de modèles que vous voulez ignorer explicitement après usage
de cette directive.</p></note>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>IndexOptions</name>
<description>Diverses options de configuration pour l'indexation d'un
-répertoire</description>
+répertoire</description>
<syntax>IndexOptions [+|-]<var>option</var> [[+|-]<var>option</var>]
...</syntax>
-<default>Par défaut, aucune option n'est activée.</default>
+<default>Par défaut, aucune option n'est activée.</default>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
</contextlist>
<usage>
<p>La directive <directive>IndexOptions</directive> permet de
- spécifier les options de configuration de l'indexation du
- répertoire. <var>option</var> peut prendre l'une des valeurs
+ spécifier les options de configuration de l'indexation du
+ répertoire. <var>option</var> peut prendre l'une des valeurs
suivantes :</p>
<dl>
<dt><a name="indexoptions.addaltclass"
id="indexoptions.addaltclass">AddAltClass</a></dt>
- <dd>Ajoute une déclaration de classe CSS supplémentaire à chaque
- enregistrement de la table du listing du répertoire dans le cas où
- <code>IndexOptions HTMLTable</code> est activé et où un
- <code>IndexStyleSheet</code> a été défini. Plutôt que d'appliquer
- à chaque enregistrement de la table les classes standards
+ <dd>Ajoute une déclaration de classe CSS supplémentaire à chaque
+ enregistrement de la table du listing du répertoire dans le cas où
+ <code>IndexOptions HTMLTable</code> est activé et où un
+ <code>IndexStyleSheet</code> a été défini. Plutôt que d'appliquer
+ à chaque enregistrement de la table les classes standards
<code>even</code> et <code>odd</code>, c'est ici une classe
<code>even-<em>ALT</em></code> ou <code>odd-<em>ALT</em></code>
- qui sera appliquée, où <em>ALT</em> sera soit le texte alternatif
- standard associé au style du fichier (par exemple <em>snd</em>,
+ qui sera appliquée, où <em>ALT</em> sera soit le texte alternatif
+ standard associé au style du fichier (par exemple <em>snd</em>,
<em>txt</em>, <em>img</em>, etc...), soit le texte alternatif
- défini par une des différentes directives <code>AddAlt*</code>.
+ défini par une des différentes directives <code>AddAlt*</code>.
</dd>
<dt><a name="indexoptions.charset"
id="indexoptions.charset"
- >Charset=<var>jeu de caractères</var></a> (<em>Versions 2.0.61 et
- supérieures du serveur HTTP Apache</em>)</dt>
+ >Charset=<var>jeu de caractères</var></a> (<em>Versions 2.0.61 et
+ supérieures du serveur HTTP Apache</em>)</dt>
- <dd>Le mot-clé <code>Charset</code> vous permet de spécifier le
- jeu de caractères de la page générée. La valeur par défaut est
+ <dd>Le mot-clé <code>Charset</code> vous permet de spécifier le
+ jeu de caractères de la page générée. La valeur par défaut est
<var>UTF-8</var> sous Windows et MAC OS X, et
<var>ISO-8859-1</var> dans les autres cas (en fait selon que le
- système de fichiers sous-jacent utilise les noms de fichiers en
+ système de fichiers sous-jacent utilise les noms de fichiers en
Unicode ou non).
<highlight language="config">
id="indexoptions.descriptionwidth"
>DescriptionWidth=[<var>n</var> | *]</a></dt>
- <dd>Le mot-clé <code>DescriptionWidth</code> vous permet de
- spécifier la taille en caractères de la colonne description.</dd>
+ <dd>Le mot-clé <code>DescriptionWidth</code> vous permet de
+ spécifier la taille en caractères de la colonne description.</dd>
<dt>Avec <code>-DescriptionWidth</code> (ou si l'option n'est pas
- définie), <module>mod_autoindex</module> calcule la meilleure
+ définie), <module>mod_autoindex</module> calcule la meilleure
taille.</dt>
<dd><code>DescriptionWidth=<var>n</var></code> fixe la taille de
- la colonne à <var>n</var> octets.</dd>
+ la colonne à <var>n</var> octets.</dd>
<dd><code>DescriptionWidth=*</code> ajuste la taille de la colonne
- à la plus longue chaîne de description.
+ à la plus longue chaîne de description.
<strong>Voir la section concernant <directive
module="mod_autoindex">AddDescription</directive> pour les dangers
- inhérants à la troncature des descriptions.</strong></dd>
+ inhérants à la troncature des descriptions.</strong></dd>
<dt><a name="indexoptions.fancyindexing"
id="indexoptions.fancyindexing">FancyIndexing</a></dt>
- <dd>Cette option active l'indexation "améliorée" des répertoires,
- c'est à dire avec en-têtes de colonnes sous forme d'hyper-liens
- auto-référants.</dd>
+ <dd>Cette option active l'indexation "améliorée" des répertoires,
+ c'est à dire avec en-têtes de colonnes sous forme d'hyper-liens
+ auto-référants.</dd>
<dt><a name="indexoptions.foldersfirst"
id="indexoptions.foldersfirst">FoldersFirst</a></dt>
- <dd>Lorsque cette option est activée, la liste des
- sous-répertoires apparaîtra <em>toujours</em> en premier, suivie
- de la liste des fichiers normaux du répertoire. Le listing
+ <dd>Lorsque cette option est activée, la liste des
+ sous-répertoires apparaîtra <em>toujours</em> en premier, suivie
+ de la liste des fichiers normaux du répertoire. Le listing
comporte principalement deux parties, les fichiers et les
- sous-répertoires, chacun d'eux étant trié séparément et les
- sous-répertoires affichés en premier. Par exemple, si l'ordre de
- tri est décroissant par nom, et si <code>FoldersFirst</code> est
- activé, le sous-répertoire <code>Zed</code> sera affiché avant le
- sous-répertoire <code>Beta</code>, qui sera lui-même affiché avant
+ sous-répertoires, chacun d'eux étant trié séparément et les
+ sous-répertoires affichés en premier. Par exemple, si l'ordre de
+ tri est décroissant par nom, et si <code>FoldersFirst</code> est
+ activé, le sous-répertoire <code>Zed</code> sera affiché avant le
+ sous-répertoire <code>Beta</code>, qui sera lui-même affiché avant
les fichiers normaux <code>Gamma</code> et <code>Alpha</code>.
<strong>Cette option n'a d'effet que si <a
href="#indexoptions.fancyindexing"><code>FancyIndexing</code></a>
- est aussi activé.</strong>
+ est aussi activé.</strong>
</dd>
<dt><a name="indexoptions.htmltable"
<dd>Cette option pour l'affichage
<code>FancyIndexing</code> permet de construire une table simple
- pour l'affichage de l'index du répertoire. Cette option s'avèrera
- particulièrement nécessaire pour les plates-formes où utf-8 est
- activé et dans le cas où les noms de fichiers ou les chaînes
- de description alternent entre les ordres de lecture gauche à
- droite et droite à gauche.</dd>
+ pour l'affichage de l'index du répertoire. Cette option s'avèrera
+ particulièrement nécessaire pour les plates-formes où utf-8 est
+ activé et dans le cas où les noms de fichiers ou les chaînes
+ de description alternent entre les ordres de lecture gauche à
+ droite et droite à gauche.</dd>
<dt><a name="indexoptions.iconsarelinks"
id="indexoptions.iconsarelinks">IconsAreLinks</a></dt>
- <dd>Configure la partie réservée aux icônes de l'ancrage pour le
- nom de fichier, dans le cas d'un affichage "amélioré".</dd>
+ <dd>Configure la partie réservée aux icônes de l'ancrage pour le
+ nom de fichier, dans le cas d'un affichage "amélioré".</dd>
<dt><a name="indexoptions.iconheight"
id="indexoptions.iconheight">IconHeight[=<var
>pixels</var>]</a></dt>
- <dd>Si cette option est présente, en combinaison avec
+ <dd>Si cette option est présente, en combinaison avec
<code>IconWidth</code>, le serveur va inclure les attributs
<code>height</code> et <code>width</code> dans la balise
- <code>img</code> qui référence le fichier de l'icône. Ceci va
- permettre au navigateur de prévoir les caractéristiques de la page
- sans devoir attendre que toutes les images aient été chargées. En
- l'absence de cette option, c'est la hauteur standard définie par
- le logiciel Apache httpd qui est choisie comme valeur par défaut.
+ <code>img</code> qui référence le fichier de l'icône. Ceci va
+ permettre au navigateur de prévoir les caractéristiques de la page
+ sans devoir attendre que toutes les images aient été chargées. En
+ l'absence de cette option, c'est la hauteur standard définie par
+ le logiciel Apache httpd qui est choisie comme valeur par défaut.
<strong>Cette option n'a d'effet que si <a
href="#indexoptions.fancyindexing"><code>FancyIndexing</code></a>
- est aussi activé.</strong>
+ est aussi activé.</strong>
</dd>
id="indexoptions.iconwidth">IconWidth[=<var
>pixels</var>]</a></dt>
- <dd>Si cette option est présente, en combinaison avec
+ <dd>Si cette option est présente, en combinaison avec
<code>IconHeight</code>, le serveur va inclure les attributs
<code>height</code> et <code>width</code> dans la balise
- <code>img</code> qui référence le fichier de l'icône. Ceci va
- permettre au navigateur de prévoir les caractéristiques de la page
- sans devoir attendre que toutes les images aient été chargées. En
- l'absence de cette option, c'est la largeur standard définie par
- le logiciel Apache httpd qui est choisie comme valeur par défaut.</dd>
+ <code>img</code> qui référence le fichier de l'icône. Ceci va
+ permettre au navigateur de prévoir les caractéristiques de la page
+ sans devoir attendre que toutes les images aient été chargées. En
+ l'absence de cette option, c'est la largeur standard définie par
+ le logiciel Apache httpd qui est choisie comme valeur par défaut.</dd>
<dt><a name="indexoptions.ignorecase"
id="indexoptions.ignorecase">IgnoreCase</a></dt>
- <dd>Si cette option est activée, les noms sont triés sans tenir
+ <dd>Si cette option est activée, les noms sont triés sans tenir
compte de la casse. Par exemple, si le tri s'effectue sur les noms
- dans l'ordre croissant, et si <code>IgnoreCase</code> est activé,
- le fichier Zeta apparaîtra après le fichier alfa (Note : le
- fichier GAMMA apparaîtra toujours avant le fichier gamma).
+ dans l'ordre croissant, et si <code>IgnoreCase</code> est activé,
+ le fichier Zeta apparaîtra après le fichier alfa (Note : le
+ fichier GAMMA apparaîtra toujours avant le fichier gamma).
</dd>
<dt><a name="indexoptions.ignoreclient"
id="indexoptions.ignoreclient">IgnoreClient</a></dt>
- <dd>Si cette option est activée, <module>mod_autoindex</module> va
- ignorer toutes les variables de requête fournies par le client, y
+ <dd>Si cette option est activée, <module>mod_autoindex</module> va
+ ignorer toutes les variables de requête fournies par le client, y
compris les informations de tri (ce qui implique l'activation de
l'option <code><a href="#indexoptions.suppresscolumnsorting"
>SuppressColumnSorting</a></code>).</dd>
id="indexoptions.namewidth">NameWidth=[<var>n</var>
| *]</a></dt>
- <dd>Le mot-clé <code>NameWidth</code> vous permet de spécifier la
+ <dd>Le mot-clé <code>NameWidth</code> vous permet de spécifier la
largeur en octets de la colonne correspondant au nom du
fichier.</dd>
<dd>Avec <code>-NameWidth</code> (ou si l'option n'est pas
- définie), <module
+ définie), <module
>mod_autoindex</module> va calculer la meilleure largeur
- possible, mais jusqu'à une largeur maximale de 20 octets.</dd>
+ possible, mais jusqu'à une largeur maximale de 20 octets.</dd>
<dd><code>NameWidth=<var>n</var></code> fixe la largeur de la
- colonne à <var>n</var> octets.</dd>
+ colonne à <var>n</var> octets.</dd>
- <dd><code>NameWidth=*</code> définit la largeur de colonne à la
- valeur nécessaire.</dd>
+ <dd><code>NameWidth=*</code> définit la largeur de colonne à la
+ valeur nécessaire.</dd>
<dt><a name="indexoptions.scanhtmltitles"
id="indexoptions.scanhtmltitles">ScanHTMLTitles</a></dt>
<dd>L'activation de cette option permet d'extraire le titre des
- documents HTML dans le cas d'un affichage "amélioré". Si le fichier
- ne possède aucune description définie par la directive <directive
+ documents HTML dans le cas d'un affichage "amélioré". Si le fichier
+ ne possède aucune description définie par la directive <directive
module="mod_autoindex">AddDescription</directive>, httpd va lire
le document pour tenter d'en extraire le <code>titre</code>. Ce
- processus est coûteux en ressources disque et CPU.</dd>
+ processus est coûteux en ressources disque et CPU.</dd>
<dt><a name="indexoptions.showforbidden"
id="indexoptions.showforbidden">ShowForbidden</a></dt>
- <dd>Si cette option est activée, Apache httpd affichera les fichiers
- normalement cachés suite au retour des valeurs
+ <dd>Si cette option est activée, Apache httpd affichera les fichiers
+ normalement cachés suite au retour des valeurs
<code>HTTP_UNAUTHORIZED</code> ou <code>HTTP_FORBIDDEN</code> par
- la sous-requête.</dd>
+ la sous-requête.</dd>
<dt><a name="indexoptions.suppresscolumnsorting"
id="indexoptions.suppresscolumnsorting"
>SuppressColumnSorting</a></dt>
- <dd>Si cette option est activée, Apache httpd supprimera les liens
- hyper-texte dans les en-têtes de colonnes dans le cas d'un
- affichage "amélioré". Par défaut, ces en-têtes constituent des liens
- hyper-texte, et la sélection de l'un d'entre eux va trier l'index
- du répertoire en fonction des valeurs de la colonne
- correspondante. Cependant, les arguments de la chaîne de
- paramètres de la requête ajoutés à l'URL seront toujours ignorés.
- Ce comportement est contr
ôlé par l'option <a
+ <dd>Si cette option est activée, Apache httpd supprimera les liens
+ hyper-texte dans les en-têtes de colonnes dans le cas d'un
+ affichage "amélioré". Par défaut, ces en-têtes constituent des liens
+ hyper-texte, et la sélection de l'un d'entre eux va trier l'index
+ du répertoire en fonction des valeurs de la colonne
+ correspondante. Cependant, les arguments de la chaîne de
+ paramètres de la requête ajoutés à l'URL seront toujours ignorés.
+ Ce comportement est contr
ôlé par l'option <a
href="#indexoptions.ignoreclient"><code>IndexOptions
IgnoreClient</code></a>.</dd>
>SuppressDescription</a></dt>
<dd>L'activation de cette option va supprimer la description des
- fichiers dans le cas d'un affichage "amélioré". Par défaut aucune
- description de fichier n'est définie, et par conséquent
- l'utilisation de cette option va permettre de récupérer un espace
- à l'écran de 23 caractères pouvant être utilisé pour autre chose.
+ 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 <directive module="mod_autoindex"
- >AddDescription</directive> pour plus d'informations à propos de
- la définition des descriptions de fichiers. Voir aussi l'option
+ >AddDescription</directive> pour plus d'informations à propos de
+ la définition des descriptions de fichiers. Voir aussi l'option
d'index <code><a
href="#indexoptions.descriptionwidth">DescriptionWidth</a></code>
pour limiter la taille de la colonne description.
<strong>Cette option n'a d'effet que si <a
href="#indexoptions.fancyindexing"><code>FancyIndexing</code></a>
- est aussi activé.</strong>
+ est aussi activé.</strong>
</dd>
<dt><a name="indexoptions.suppresshtmlpreamble"
id="indexoptions.suppresshtmlpreamble"
>SuppressHTMLPreamble</a></dt>
- <dd>Si le répertoire contient effectivement le fichier spécifié
+ <dd>Si le répertoire contient effectivement le fichier spécifié
par la directive <directive
module="mod_autoindex">HeaderName</directive>, le module inclut
- en général le contenu du fichier après avoir inséré un préambule
+ en général le contenu du fichier après avoir inséré un préambule
HTML standard (<code><html></code>,
<code><head></code>, <em>etc...</em>). L'activation de
l'option <code>SuppressHTMLPreamble</code> supprime l'insertion de
- ce préambule, et le module va alors commencer l'affichage
- directement par le contenu du fichier d'en-tête. Dans ce cas par
- contre, le fichier d'en-tête doit contenir des instructions HTML
- appropriées. S'il n'y a pas de fichier d'en-tête, le préambule est
- généré comme dans le cas général. Si vous spécifiez aussi une
+ ce préambule, et le module va alors commencer l'affichage
+ directement par le contenu du fichier d'en-tête. Dans ce cas par
+ contre, le fichier d'en-tête doit contenir des instructions HTML
+ appropriées. S'il n'y a pas de fichier d'en-tête, le préambule est
+ généré comme dans le cas général. Si vous spécifiez aussi une
directive <directive
module="mod_autoindex">ReadmeName</directive>, et si ce
fichier existe, les balises de fermeture closing
</body></html> seront aussi omises dans la sortie, en
- supposant que vous ayez placé ces balises de fermeture dans ce
+ supposant que vous ayez placé ces balises de fermeture dans ce
fichier.</dd>
<dt><a name="indexoptions.suppressicon"
id="indexoptions.suppressicon">SuppressIcon</a></dt>
- <dd>L'activation de cette option supprime l'affichage des icônes
- dans le cas d'un affichage "amélioré". La combinaison de
+ <dd>L'activation de cette option supprime l'affichage des icônes
+ dans le cas d'un affichage "amélioré". La combinaison de
<code>SuppressIcon</code> et <code>SuppressRules</code> permet de
- générer une sortie au format HTML 3.2 qui, selon les dernières
- spécifications, interdit les éléments <code>img</code> et
- <code>hr</code> dans les blocs <code>pre</code> (utilisés pour
- formater les affichages "améliorés").</dd>
+ générer une sortie au format HTML 3.2 qui, selon les dernières
+ spécifications, interdit les éléments <code>img</code> et
+ <code>hr</code> dans les blocs <code>pre</code> (utilisés pour
+ formater les affichages "améliorés").</dd>
<dt><a name="indexoptions.suppresslastmodified"
id="indexoptions.suppresslastmodified"
>SuppressLastModified</a></dt>
<dd>L'activation de cette option supprime l'affichage de la date
- de dernière modification dans le cas d'un affichage "amélioré".
+ de dernière modification dans le cas d'un affichage "amélioré".
<strong>Cette option n'a d'effet que si <a
href="#indexoptions.fancyindexing"><code>FancyIndexing</code></a>
- est aussi activé.</strong>
+ est aussi activé.</strong>
</dd>
<dt><a name="indexoptions.suppressrules"
</dt>
<dd>L'activation de cette option supprime l'affichage des lignes
- horizontales (éléments <code>hr</code>) dans les index de
- répertoires. La combinaison de
+ horizontales (éléments <code>hr</code>) dans les index de
+ répertoires. La combinaison de
<code>SuppressIcon</code> et <code>SuppressRules</code> permet de
- générer une sortie au format HTML 3.2 qui, selon les dernières
- spécifications, interdit les éléments <code>img</code> et
- <code>hr</code> dans les blocs <code>pre</code> (utilisés pour
- formater les affichages "améliorés").
+ générer une sortie au format HTML 3.2 qui, selon les dernières
+ spécifications, interdit les éléments <code>img</code> et
+ <code>hr</code> dans les blocs <code>pre</code> (utilisés pour
+ formater les affichages "améliorés").
<strong>Cette option n'a d'effet que si <a
href="#indexoptions.fancyindexing"><code>FancyIndexing</code></a>
- est aussi activé.</strong>
+ est aussi activé.</strong>
</dd>
<dt><a name="indexoptions.suppresssize"
id="indexoptions.suppresssize">SuppressSize</a></dt>
<dd>L'activation de cette option supprime l'affichage de la taille
- du fichier dans le cas d'un affichage "amélioré".
+ du fichier dans le cas d'un affichage "amélioré".
<strong>Cette option n'a d'effet que si <a
href="#indexoptions.fancyindexing"><code>FancyIndexing</code></a>
- est aussi activé.</strong>
+ est aussi activé.</strong>
</dd>
<dt><a name="indexoptions.trackmodified"
id="indexoptions.trackmodified">TrackModified</a></dt>
<dd>Cette option renvoie les valeurs <code>Last-Modified</code> et
- <code>ETag</code> pour le répertoire indexé dans l'en-tête HTTP.
- Elle n'est valide que si le système d'exploitation et le système
- de fichiers renvoient des résultats appropriés pour la fonction
- stat(). C'est le cas de certains systèmes Unix, ainsi que JFS sous
+ <code>ETag</code> pour le répertoire indexé dans l'en-tête HTTP.
+ Elle n'est valide que si le système d'exploitation et le système
+ de fichiers renvoient des résultats appropriés pour la fonction
+ stat(). C'est le cas de certains systèmes Unix, ainsi que JFS sous
OS/2 ou
les volumes NTFS sous Win32. Ce n'est par contre pas le cas
- des volumes FAT Win32 et OS/2. Lorsque cette option est activée, le
- client ou le mandataire peuvent détecter les changements dans la
- liste des fichiers lorsqu'ils effectuent une requête
- <code>HEAD</code>. Notez que certains systèmes d'exploitation
- détectent correctement les nouveaux fichiers et les fichiers
- supprimés, mais ne détectent pas les modifications de tailles ou
- de dates des fichiers du répertoire. <strong>Les modifications de
- taille ou de date d'un fichier existant ne mettent pas à jour
- l'en-tête <code>Last-Modified</code> sur toutes les plate-formes
+ des volumes FAT Win32 et OS/2. Lorsque cette option est activée, le
+ client ou le mandataire peuvent détecter les changements dans la
+ liste des fichiers lorsqu'ils effectuent une requête
+ <code>HEAD</code>. Notez que certains systèmes d'exploitation
+ détectent correctement les nouveaux fichiers et les fichiers
+ supprimés, mais ne détectent pas les modifications de tailles ou
+ de dates des fichiers du répertoire. <strong>Les modifications de
+ taille ou de date d'un fichier existant ne mettent pas à jour
+ l'en-tête <code>Last-Modified</code> sur toutes les plate-formes
Unix.</strong> Si c'est le cas, laissez cette option
- désactivée.</dd>
+ désactivée.</dd>
<dt><a name="indexoptions.type"
id="indexoptions.type"
>Type=<var>type MIME</var></a> (<em>Versions 2.0.61 et
- supérieures du serveur HTTP Apache</em>)</dt>
+ supérieures du serveur HTTP Apache</em>)</dt>
- <dd>Le mot-clé <code>Type</code> vous permet de spécifier le type
- MIME de la page générée. La valeur par défaut est
+ <dd>Le mot-clé <code>Type</code> vous permet de spécifier le type
+ MIME de la page générée. La valeur par défaut est
<var>text/html</var>.
<highlight language="config">
<dt><a name="indexoptions.versionsort"
id="indexoptions.versionsort">VersionSort</a>
- (<em>Versions 2.0a3 et supérieures du serveur HTTP Apache</em>)</dt>
+ (<em>Versions 2.0a3 et supérieures du serveur HTTP Apache</em>)</dt>
- <dd>Le mot-clé <code>VersionSort</code> permet de trier les
- fichiers contenant des numéros de version d'une manière
- spécifique. Les chaînes sont triées comme d'habitude, excepté les
- sous-chaînes de chiffres du nom de fichier et de sa description
- qui sont comparées en fonction de leur valeur numérique.
+ <dd>Le mot-clé <code>VersionSort</code> permet de trier les
+ fichiers contenant des numéros de version d'une manière
+ spécifique. Les chaînes sont triées comme d'habitude, excepté les
+ sous-chaînes de chiffres du nom de fichier et de sa description
+ qui sont comparées en fonction de leur valeur numérique.
<example><title>Exemple :</title>
foo-1.7<br />
foo-1.12
</example>
- <p>Si le nombre commence par le chiffre 0, il est considéré comme
+ <p>Si le nombre commence par le chiffre 0, il est considéré comme
la partie fractionnaire d'un nombre :</p>
<example>
<dt><a name="indexoptions.xhtml"
id="indexoptions.xhtml">XHTML</a>
- (<em>Versions 2.0.49 et supérieures du serveur HTTP Apache</em>)</dt>
+ (<em>Versions 2.0.49 et supérieures du serveur HTTP Apache</em>)</dt>
- <dd>Le mot-clé <code>XHTML</code> enjoint
- <module>mod_autoindex</module> de générer du code XHTML 1.0 au
+ <dd>Le mot-clé <code>XHTML</code> enjoint
+ <module>mod_autoindex</module> de générer du code XHTML 1.0 au
lieu de HTML 3.2.
<strong>Cette option n'a d'effet que si <a
href="#indexoptions.fancyindexing"><code>FancyIndexing</code></a>
- est aussi activé.</strong>
+ est aussi activé.</strong>
</dd>
</dl>
XXX: we should consider to allow sections inside <usage>
this would require some xslt changes...
-->
- <dl><dt>Options d'index incrémentales</dt>
+ <dl><dt>Options d'index incrémentales</dt>
<dd>
- <p>Vous devez porter une attention particulière à la manière dont
- les <directive>IndexOptions</directive> multiples sont traitées.</p>
+ <p>Vous devez porter une attention particulière à la manière dont
+ les <directive>IndexOptions</directive> multiples sont traitées.</p>
<ul>
<li>Plusieurs directives <directive>IndexOptions</directive>
- apparaissant dans la même section directory sont maintenant
- fusionnées. Le résultat de :
+ apparaissant dans la même section directory sont maintenant
+ fusionnées. Le résultat de :
<highlight language="config">
<Directory "/foo">
</Directory>
</highlight>
- <p>est équivalent à</p>
+ <p>est équivalent à</p>
<highlight language="config">
IndexOptions HTMLTable SuppressColumnsorting
</highlight>
</li>
- <li>L'ajout de la syntaxe incrémentale (en préfixant les mots-clés
+ <li>L'ajout de la syntaxe incrémentale (en préfixant les mots-clés
avec <code>+</code> ou <code>-</code>).</li>
</ul>
- <p>Chaque fois qu'un mot-clé préfixé par '+' ou '-' est trouvé, il
- est appliqué aux définitions des
- <directive>IndexOptions</directive> 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
+ <p>Chaque fois qu'un mot-clé préfixé par '+' ou '-' est trouvé, il
+ est appliqué aux définitions des
+ <directive>IndexOptions</directive> courantes (qui ont été
+ éventuellement héritées d'un directory de niveau supérieur). Par
+ contre, si un mot-clé non préfixé est trouvé, il supprime toutes
+ les definitions héritées, ainsi que toute
+ définition incrémentale. Considérons l'exemple
suivant :</p>
<highlight language="config">
-IndexOptions +ScanHTMLTitles -IconsAreLinks FancyIndexing<br />
+IndexOptions +ScanHTMLTitles -IconsAreLinks FancyIndexing
IndexOptions +SuppressSize
</highlight>
- <p>L'effet global est équivalent à l'effet qu'aurait provoqué
+ <p>L'effet global est équivalent à l'effet qu'aurait provoqué
<code>IndexOptions FancyIndexing +SuppressSize</code>, car l'option
- non préfixée <code>FancyIndexing</code> annule les mots-clés
- incrémentaux situés avant elle, mais leur permet ensuite de
- s'incrémenter à nouveau.</p>
-
- <p>Pour définir inconditionnellement les
- <directive>IndexOptions</directive> pour un répertoire particulier,
- tout en supprimant les définitions héritées, spécifiez les
- mots-clés sans préfixe <code>+</code> ou <code>-</code></p>
+ non préfixée <code>FancyIndexing</code> annule les mots-clés
+ incrémentaux situés avant elle, mais leur permet ensuite de
+ s'incrémenter à nouveau.</p>
+
+ <p>Pour définir inconditionnellement les
+ <directive>IndexOptions</directive> pour un répertoire particulier,
+ tout en supprimant les définitions héritées, spécifiez les
+ mots-clés sans préfixe <code>+</code> ou <code>-</code></p>
</dd>
</dl>
</usage>
<directivesynopsis>
<name>IndexOrderDefault</name>
-<description>Définit l'ordre d'affichage par défaut d'un index de
-répertoire</description>
+<description>Définit l'ordre d'affichage par défaut d'un index de
+répertoire</description>
<syntax>IndexOrderDefault Ascending|Descending
Name|Date|Size|Description</syntax>
<default>IndexOrderDefault Ascending Name</default>
<p>La directive <directive>IndexOrderDefault</directive> s'utilise
en combinaison avec l'option d'index <code><a
href="#indexoptions.fancyindexing">FancyIndexing</a></code>. Par
- défaut, les index de répertoires "améliorés" sont affichés selon l'ordre
+ défaut, les index de répertoires "améliorés" sont affichés selon l'ordre
croissant des noms de fichiers ; la directive
<directive>IndexOrderDefault</directive> vous permet de modifier ce
comportement.</p>
<code>Descending</code>, et indique l'ordre de tri. Le second doit
prendre une des valeurs <code>Name</code>, <code>Date</code>,
<code>Size</code>, ou <code>Description</code>, et permet
- d'identifier la clé primaire. La clé secondaire est
+ d'identifier la clé primaire. La clé secondaire est
<em>toujours</em> le nom du fichier selon un ordre croissant.</p>
- <p>Si vous le désirez, vous pouvez empêcher le client de modifier
+ <p>Si vous le désirez, vous pouvez empêcher le client de modifier
l'ordre de tri de la liste en ajoutant l'option d'index <code><a
href="#indexoptions.suppresscolumnsorting">SuppressColumnSorting</a></code>
- qui supprime le lien de définition du tri de l'en-tête de la
+ qui supprime le lien de définition du tri de l'en-tête de la
colonne, ainsi que l'option <code><a
href="#indexoptions.ignoreclient">IgnoreClient</a></code> qui
- empêche ce même client de passer outre vos préférences de tri en
- ajoutant manuellement des options de tri à la chaîne de paramètres
- de la requête.</p>
+ empêche ce même client de passer outre vos préférences de tri en
+ ajoutant manuellement des options de tri à la chaîne de paramètres
+ de la requête.</p>
</usage>
</directivesynopsis>
<directivesynopsis>
<name>IndexStyleSheet</name>
-<description>Ajoute une feuille de style CSS à l'index du
-répertoire</description>
+<description>Ajoute une feuille de style CSS à l'index du
+répertoire</description>
<syntax>IndexStyleSheet <var>chemin-url</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context>
<usage>
<p>La directive <directive>IndexStyleSheet</directive> permet de
- définir le nom du fichier qui servira de feuille de style CSS pour
+ définir le nom du fichier qui servira de feuille de style CSS pour
l'index.
</p>
<highlight language="config">
<p>L'utilisation de cette directive en conjonction avec <code>IndexOptions
HTMLTable</code> ajoute plusieurs classes CSS au document HTML
- résultant. Un identifiant CSS <code>indexlist</code> est attribué à
- l'ensemble de la table et les classes suivantes sont associées aux
- différentes parties du listing :</p>
+ résultant. Un identifiant CSS <code>indexlist</code> est attribué à
+ l'ensemble de la table et les classes suivantes sont associées aux
+ différentes parties du listing :</p>
<table border="1" style="zebra">
- <tr><th>Classe</th><th>Définition</th></tr>
- <tr><td>tr.indexhead</td><td>Ligne d'en-tête du listing</td></tr>
+ <tr><th>Classe</th><th>Définition</th></tr>
+ <tr><td>tr.indexhead</td><td>Ligne d'en-tête du listing</td></tr>
<tr><td>th.indexcolicon and td.indexcolicon</td> <td>Colonne de
- l'icône</td></tr>
+ l'icône</td></tr>
<tr><td>th.indexcolname and td.indexcolname</td> <td>Colonne du nom
du fichier</td></tr>
<tr><td>th.indexcollastmod and td.indexcollastmod</td> <td>Colonne
- de la date de dernière modification</td></tr>
+ de la date de dernière modification</td></tr>
<tr><td>th.indexcolsize and td.indexcolsize</td> <td>Colonne de la
taille du fichier</td></tr>
<tr><td>th.indexcoldesc and td.indexcoldesc</td> <td>Colonne de la
<directivesynopsis>
<name>IndexHeadInsert</name>
-<description>Insère du texte dans la section HEAD de la page
+<description>Insère du texte dans la section HEAD de la page
d'index.</description>
<syntax>IndexHeadInsert <var>"marque ..."</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
<usage>
<p>La directive <directive>IndexHeadInsert</directive> permet de
- spécifier une chaîne de caractères à insérer dans la section
- <var><head></var> du code HTML généré pour la page
+ spécifier une chaîne de caractères à insérer dans la section
+ <var><head></var> du code HTML généré pour la page
d'index.</p>
<highlight language="config">
IndexHeadInsert "<link rel=\"sitemap\" href=\"/sitemap.html\">"
<directivesynopsis>
<name>ReadmeName</name>
-<description>Nom du fichier dont le contenu sera inséré à la fin de
+<description>Nom du fichier dont le contenu sera inséré à la fin de
l'index</description>
<syntax>ReadmeName <var>nom-fichier</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
<override>Indexes</override>
<usage>
- <p>La directive <directive>ReadmeName</directive> permet de définir
- le nom du fichier dont le contenu sera ajouté à la fin de l'index.
- <var>nom-fichier</var> est le nom du fichier à inclure, et est
- considéré comme relatif au répertoire faisant l'objet de l'index. Si
+ <p>La directive <directive>ReadmeName</directive> permet de définir
+ le nom du fichier dont le contenu sera ajouté à la fin de l'index.
+ <var>nom-fichier</var> est le nom du fichier à inclure, et est
+ considéré comme relatif au répertoire faisant l'objet de l'index. Si
<var>nom-fichier</var> commence par un slash '/', comme dans
- l'exemple 2, il sera considéré
- comme relatif au répertoire défini par la directive <directive
+ l'exemple 2, il sera considéré
+ comme relatif au répertoire défini par la directive <directive
module="core">DocumentRoot</directive>.
</p>
</highlight>
<p>Voir aussi la directive <directive module="mod_autoindex"
- >HeaderName</directive>, où cette fonctionnalité est décrite plus en
- détails.</p>
+ >HeaderName</directive>, où cette fonctionnalité est décrite plus en
+ détails.</p>
</usage>
</directivesynopsis>
-<?xml version="1.0" encoding="ISO-8859-1" ?>
+<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE manualpage SYSTEM "./style/manualpage.dtd">
<?xml-stylesheet type="text/xsl" href="./style/manual.fr.xsl"?>
<!-- French translation : Lucien GENTIS -->
<!-- Reviewed by : Vincent Deffontaines -->
-<!-- English Revision: 1673945 -->
+<!-- English Revision: 1741874 -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
<manualpage metafile="urlmapping.xml.meta">
- <title> Mise en correspondance des URLs avec le système de fichiers</title>
+ <title> Mise en correspondance des URLs avec le système de fichiers</title>
<summary>
<p>Ce document explique comment le serveur HTTP Apache utilise l'URL contenue dans une
- requête pour déterminer le noeud du système de fichier à partir duquel le
- fichier devra être servi.</p>
+ requête pour déterminer le noeud du système de fichier à partir duquel le
+ fichier devra être servi.</p>
</summary>
-<section id="related"><title>Modules et directives concernés</title>
+<section id="related"><title>Modules et directives concernés</title>
<related>
<modulelist>
<section id="documentroot"><title>Racine des documents (DocumentRoot)</title>
- <p>La méthode par défaut de httpd pour déterminer quel fichier servir pour
- une requête donnée, consiste à extraire le chemin du fichier de la requête
- (la partie de l'URL qui suit le nom d'hôte et le port), puis de l'ajouter
- à la fin de la valeur de la directive
- <directive module="core">DocumentRoot</directive> définie dans vos fichiers
+ <p>La méthode par défaut de httpd pour déterminer quel fichier servir pour
+ une requête donnée, consiste à extraire le chemin du fichier de la requête
+ (la partie de l'URL qui suit le nom d'hôte et le port), puis de l'ajouter
+ à la fin de la valeur de la directive
+ <directive module="core">DocumentRoot</directive> définie dans vos fichiers
de configuration.
- Ainsi, les fichiers et répertoires
- situés en dessous de <directive module="core">DocumentRoot</directive>
+ Ainsi, les fichiers et répertoires
+ situés en dessous de <directive module="core">DocumentRoot</directive>
constituent l'arborescence de base des documents qui seront visibles
depuis le web.</p>
<p>Par exemple, si la directive
<directive module="core">DocumentRoot</directive> contient
- <code>/var/www/html</code>, une requête pour
+ <code>/var/www/html</code>, une requête pour
<code>http://www.example.com/fish/guppies.html</code> retournera le
fichier <code>/var/www/html/fish/guppies.html</code> au client.</p>
- <p>Si la requête concerne un répertoire (autrement dit un chemin se
+ <p>Si la requête concerne un répertoire (autrement dit un chemin se
terminant par un slash <code>/</code>), le nom du fichier qui sera
- recherché et servi depuis ce répertoire est défini via la directive
+ recherché et servi depuis ce répertoire est défini via la directive
<directive module="mod_dir">DirectoryIndex</directive>. Par exemple,
- supposons que <code>DocumentRoot</code> ait été définie comme
- précédemment, et que vous ayez défini <code>DirectoryIndex</code>
+ supposons que <code>DocumentRoot</code> ait été définie comme
+ précédemment, et que vous ayez défini <code>DirectoryIndex</code>
comme suit :</p>
<example>DirectoryIndex index.html index.php</example>
- <p>Si httpd reçoit alors une requête pour
+ <p>Si httpd reçoit alors une requête pour
<code>http://www.example.com/fish/</code>, il tentera de servir le
fichier <code>/var/www/html/fish/index.html</code>. Si ce fichier
n'existe pas, il tentera de servir le fichier
<code>/var/www/html/fish/index.php</code>.</p>
- <p>Si aucun de ces fichiers existe, httpd tentera de générer et
- d'afficher un index du répertoire, à condition que
- <module>mod_autoindex</module> ait été chargé et configuré pour le
+ <p>Si aucun de ces fichiers existe, httpd tentera de générer et
+ d'afficher un index du répertoire, à condition que
+ <module>mod_autoindex</module> ait été chargé et configuré pour le
permettre.</p>
- <p>httpd supporte aussi les <a href="vhosts/">Hôtes virtuels</a>,
- ce qui lui permet de traiter des requêtes pour plusieurs hôtes.
+ <p>httpd supporte aussi les <a href="vhosts/">Hôtes virtuels</a>,
+ ce qui lui permet de traiter des requêtes pour plusieurs hôtes.
Dans ce cas, un <directive module="core">DocumentRoot</directive>
- différent peut être défini pour chaque hôte virtuel;
+ différent peut être défini pour chaque hôte virtuel;
les directives fournies par le module
- <module>mod_vhost_alias</module> peuvent aussi être utilisées afin de
- déterminer dynamiquement le noeud approprié du système de fichiers
- à partir duquel servir un contenu en fonction de l'adresse IP
- ou du nom d'hôte.</p>
+ <module>mod_vhost_alias</module> peuvent aussi être utilisées afin de
+ déterminer dynamiquement le noeud approprié du système de fichiers
+ à partir duquel servir un contenu en fonction de l'adresse IP
+ ou du nom d'hôte.</p>
<p>La directive <directive module="core">DocumentRoot</directive> est
- définie dans le fichier de configuration de votre serveur principal
- (<code>httpd.conf</code>), mais peut aussi être redéfinie pour chaque
- <a href="vhosts/">Hôte virtuel</a> supplémentaire que vous avez créé.</p>
+ définie dans le fichier de configuration de votre serveur principal
+ (<code>httpd.conf</code>), mais peut aussi être redéfinie pour chaque
+ <a href="vhosts/">Hôte virtuel</a> supplémentaire que vous avez créé.</p>
</section>
-<section id="outside"><title>Fichiers situés en dehors de
+<section id="outside"><title>Fichiers situés en dehors de
l'arborescence DocumentRoot</title>
- <p>Il existe de nombreuses circonstances pour lesquelles il est nécessaire
- d'autoriser l'accès web à des portions du système de fichiers qui ne se
+ <p>Il existe de nombreuses circonstances pour lesquelles il est nécessaire
+ d'autoriser l'accès web à des portions du système de fichiers qui ne se
trouvent pas dans l'arborescence <directive
module="core">DocumentRoot</directive>. httpd propose de nombreuses
- solutions pour réaliser cela. Sur les systèmes Unix, les liens
- symboliques permettent de rattacher d'autres portions du système de
+ solutions pour réaliser cela. Sur les systèmes Unix, les liens
+ symboliques permettent de rattacher d'autres portions du système de
fichiers au <directive
- module="core">DocumentRoot</directive>. Pour des raisons de sécurité,
+ module="core">DocumentRoot</directive>. Pour des raisons de sécurité,
httpd ne suivra les liens symboliques que si les <directive
- module="core">Options</directive> pour le répertoire concerné contiennent
+ module="core">Options</directive> pour le répertoire concerné contiennent
<code>FollowSymLinks</code> ou <code>SymLinksIfOwnerMatch</code>.</p>
- <p>Une autre méthode consiste à utiliser la directive <directive
+ <p>Une autre méthode consiste à utiliser la directive <directive
module="mod_alias">Alias</directive> pour rattacher toute portion
- du système de fichiers à l'arborescence du site web. Par exemple, avec</p>
+ du système de fichiers à l'arborescence du site web. Par exemple, avec</p>
<highlight language="config">Alias "/docs" "/var/web"</highlight>
correspondra au fichier <code>/var/web/dir/file.html</code>. La
directive
<directive module="mod_alias">ScriptAlias</directive>
- fonctionne de la même manière, excepté que tout contenu localisé dans le
- chemin cible sera traité comme un script <glossary ref="cgi"
+ fonctionne de la même manière, excepté que tout contenu localisé dans le
+ chemin cible sera traité comme un script <glossary ref="cgi"
>CGI</glossary>.</p>
- <p>Pour les situations qui nécessitent plus de flexibilité, vous disposez
+ <p>Pour les situations qui nécessitent plus de flexibilité, vous disposez
des directives <directive module="mod_alias">AliasMatch</directive>
et <directive module="mod_alias">ScriptAliasMatch</directive>
- qui permettent des substitutions et comparaisons puissantes basées
+ qui permettent des substitutions et comparaisons puissantes basées
sur les <glossary ref="regex">expressions rationnelles</glossary>.
Par exemple,</p>
ScriptAliasMatch "^/~([a-zA-Z0-9]+)/cgi-bin/(.+)" "/home/$1/cgi-bin/$2"
</highlight>
- <p>fera correspondre une requête du style
+ <p>fera correspondre une requête du style
<code>http://example.com/~user/cgi-bin/script.cgi</code> au chemin
- <code>/home/user/cgi-bin/script.cgi</code>, et traitera le fichier résultant
+ <code>/home/user/cgi-bin/script.cgi</code>, et traitera le fichier résultant
comme un script CGI.</p>
</section>
-<section id="user"><title>Répertoires des utilisateurs</title>
+<section id="user"><title>Répertoires des utilisateurs</title>
- <p>Sur les systèmes Unix, on peut traditionnellement faire référence
- au répertoire personnel d'un <em>utilisateur</em> particulier à l'aide de
+ <p>Sur les systèmes Unix, on peut traditionnellement faire référence
+ au répertoire personnel d'un <em>utilisateur</em> particulier à l'aide de
l'expression <code>~user/</code>.
Le module <module>mod_userdir</module>
- étend cette idée au web en autorisant l'accès aux fichiers situés dans les
- répertoires home des utilisateurs à l'aide d'URLs
+ étend cette idée au web en autorisant l'accès aux fichiers situés dans les
+ répertoires home des utilisateurs à l'aide d'URLs
comme dans ce qui suit :</p>
<example>http://www.example.com/~user/file.html</example>
- <p>Pour des raisons de sécurité, il est déconseillé de permettre un accès
- direct à un répertoire home d'utilisateur depuis le web. A cet effet, la
+ <p>Pour des raisons de sécurité, il est déconseillé de permettre un accès
+ direct à un répertoire home d'utilisateur depuis le web. A cet effet, la
directive <directive module="mod_userdir">UserDir</directive>
- spécifie un répertoire où sont situés les fichiers accessibles depuis le web
- dans le répertoire home de l'utilisateur.
- Avec la configuration par défaut
- <code>Userdir public_html</code>, l'URL ci-dessus correspondra à un fichier
+ spécifie un répertoire où sont situés les fichiers accessibles depuis le web
+ dans le répertoire home de l'utilisateur.
+ Avec la configuration par défaut
+ <code>Userdir public_html</code>, l'URL ci-dessus correspondra à un fichier
dont le chemin sera du style
- <code>/home/user/public_html/file.html</code> où
- <code>/home/user/</code> est le répertoire home de l'utilisateur tel qu'il
- est défini dans <code>/etc/passwd</code>.</p>
+ <code>/home/user/public_html/file.html</code> où
+ <code>/home/user/</code> est le répertoire home de l'utilisateur tel qu'il
+ est défini dans <code>/etc/passwd</code>.</p>
- <p>La directive <code>Userdir</code> met à votre disposition de nombreuses
- formes différentes pour les systèmes où <code>/etc/passwd</code> ne
- spécifie pas la localisation du répertoire home.</p>
+ <p>La directive <code>Userdir</code> met à votre disposition de nombreuses
+ formes différentes pour les systèmes où <code>/etc/passwd</code> ne
+ spécifie pas la localisation du répertoire home.</p>
<p>Certains jugent le symbole "~" (dont le code sur le web est souvent
- <code>%7e</code>) inapproprié et préfèrent utiliser une chaîne de
- caractères différente pour représenter les répertoires utilisateurs.
- mod_userdir ne supporte pas cette fonctionnalité. Cependant, si les
- répertoires home des utilisateurs sont structurés de manière rationnelle,
+ <code>%7e</code>) inapproprié et préfèrent utiliser une chaîne de
+ caractères différente pour représenter les répertoires utilisateurs.
+ mod_userdir ne supporte pas cette fonctionnalité. Cependant, si les
+ répertoires home des utilisateurs sont structurés de manière rationnelle,
il est possible d'utiliser la directive
<directive module="mod_alias">AliasMatch</directive>
- pour obtenir l'effet désiré. Par exemple, pour faire correspondre
- <code>http://www.example.com/upages/user/file.html</code> à
+ pour obtenir l'effet désiré. Par exemple, pour faire correspondre
+ <code>http://www.example.com/upages/user/file.html</code> à
<code>/home/user/public_html/file.html</code>, utilisez la directive
<code>AliasMatch</code> suivante :</p>
<section id="redirect"><title>Redirection d'URL</title>
- <p>Les directives de configuration décrites dans les sections précédentes
- demandent à httpd d'extraire un contenu depuis un emplacement spécifique
- du système de fichiers
+ <p>Les directives de configuration décrites dans les sections précédentes
+ demandent à httpd d'extraire un contenu depuis un emplacement spécifique
+ du système de fichiers
et de la retourner au client. Il est cependant parfois
souhaitable d'informer le
- client que le contenu demandé est localisé à une URL différente, et de
- demander au client d'élaborer une nouvelle requête avec la nouvelle URL.
- Ce processus se nomme <em>redirection</em> et est implémenté par la
+ client que le contenu demandé est localisé à une URL différente, et de
+ demander au client d'élaborer une nouvelle requête avec la nouvelle URL.
+ Ce processus se nomme <em>redirection</em> et est implémenté par la
directive <directive module="mod_alias">Redirect</directive>.
- Par exemple, si le contenu du répertoire <code>/foo/</code> sous
- <directive module="core">DocumentRoot</directive> est déplacé vers le
- nouveau répertoire <code>/bar/</code>, vous pouvez demander aux clients
- de le requérir à sa nouvelle localisation comme suit :</p>
+ Par exemple, si le contenu du répertoire <code>/foo/</code> sous
+ <directive module="core">DocumentRoot</directive> est déplacé vers le
+ nouveau répertoire <code>/bar/</code>, vous pouvez demander aux clients
+ de le requérir à sa nouvelle localisation comme suit :</p>
<highlight language="config">
Redirect permanent "/foo/" "http://www.example.com/bar/"
</highlight>
- <p>Ceci aura pour effet de rediriger tout chemin d'URL commençant par
- <code>/foo/</code> vers le même chemin d'URL sur le serveur
- <code>www.example.com</code> en remplaçant <code>/foo/</code> par
+ <p>Ceci aura pour effet de rediriger tout chemin d'URL commençant par
+ <code>/foo/</code> vers le même chemin d'URL sur le serveur
+ <code>www.example.com</code> en remplaçant <code>/foo/</code> par
<code>/bar/</code>. Vous pouvez rediriger les clients non seulement sur le
serveur d'origine, mais aussi vers n'importe quel autre serveur.</p>
<p>httpd propose aussi la directive <directive
- module="mod_alias">RedirectMatch</directive> pour traiter les problèmes
- de réécriture d'une plus grande complexité. Par exemple, afin de rediriger
- les requêtes pour la page d'accueil du site vers un site différent, mais
- laisser toutes les autres requêtes inchangées, utilisez la
+ module="mod_alias">RedirectMatch</directive> pour traiter les problèmes
+ de réécriture d'une plus grande complexité. Par exemple, afin de rediriger
+ les requêtes pour la page d'accueil du site vers un site différent, mais
+ laisser toutes les autres requêtes inchangées, utilisez la
configuration suivante :</p>
<highlight language="config">
RedirectMatch permanent "^/$" "http://www.example.com/startpage.html"
</highlight>
- <p>De même, pour rediriger temporairement toutes les pages d'un site
- vers une page particulière d'un autre site, utilisez ce qui suit :</p>
+ <p>De même, pour rediriger temporairement toutes les pages d'un site
+ vers une page particulière d'un autre site, utilisez ce qui suit :</p>
<highlight language="config">
RedirectMatch temp ".*" "http://othersite.example.com/startpage.html"
<p>httpd vous permet aussi de rapatrier des documents distants
dans l'espace des URL du serveur local.
-Cette technique est appelée <em>mandataire inverse ou reverse
+Cette technique est appelée <em>mandataire inverse ou reverse
proxying</em> car le serveur web agit comme un serveur mandataire en
rapatriant les documents depuis un serveur distant puis les renvoyant
-au client. Ceci diffère d'un service de mandataire usuel (direct) car, pour le client,
+au client. Ceci diffère d'un service de mandataire usuel (direct) car, pour le client,
les documents semblent appartenir au serveur mandataire inverse.</p>
-<p>Dans l'exemple suivant, quand les clients demandent des documents situés
-dans le répertoire
-<code>/foo/</code>, le serveur rapatrie ces documents depuis le répertoire
+<p>Dans l'exemple suivant, quand les clients demandent des documents situés
+dans le répertoire
+<code>/foo/</code>, le serveur rapatrie ces documents depuis le répertoire
<code>/bar/</code> sur <code>internal.example.com</code>
et les renvoie au client comme s'ils appartenaient au serveur local.</p>
<highlight language="config">
-ProxyPass "/foo/" "http://internal.example.com/bar/"<br />
-ProxyPassReverse "/foo/" "http://internal.example.com/bar/"<br />
-ProxyPassReverseCookieDomain internal.example.com public.example.com<br />
+ProxyPass "/foo/" "http://internal.example.com/bar/"
+ProxyPassReverse "/foo/" "http://internal.example.com/bar/"
+ProxyPassReverseCookieDomain internal.example.com public.example.com
ProxyPassReverseCookiePath "/foo/" "/bar/"
</highlight>
<p>La directive <directive module="mod_proxy">ProxyPass</directive> configure
-le serveur pour rapatrier les documents appropriés, alors que la directive
+le serveur pour rapatrier les documents appropriés, alors que la directive
<directive module="mod_proxy">ProxyPassReverse</directive>
-réécrit les redirections provenant de
-<code>internal.example.com</code> de telle manière qu'elles ciblent le
-répertoire approprié sur le serveur local. De manière similaire, les directives
+réécrit les redirections provenant de
+<code>internal.example.com</code> de telle manière qu'elles ciblent le
+répertoire approprié sur le serveur local. De manière similaire, les directives
<directive module="mod_proxy">ProxyPassReverseCookieDomain</directive>
et <directive module="mod_proxy">ProxyPassReverseCookiePath</directive>
-réécrivent les cookies élaborés par le serveur d'arrière-plan.</p>
-<p>Il est important de noter cependant, que les liens situés dans les documents
-ne seront pas réécrits. Ainsi, tout lien absolu sur
-<code>internal.example.com</code> fera décrocher le client
-du serveur mandataire et effectuer sa requête directement sur
+réécrivent les cookies élaborés par le serveur d'arrière-plan.</p>
+<p>Il est important de noter cependant, que les liens situés dans les documents
+ne seront pas réécrits. Ainsi, tout lien absolu sur
+<code>internal.example.com</code> fera décrocher le client
+du serveur mandataire et effectuer sa requête directement sur
<code>internal.example.com</code>. Vous pouvez modifier ces liens (et
-d'utres contenus) situés dans la page au moment où elle est envoyée au
+d'utres contenus) situés dans la page au moment où elle est envoyée au
client en utilisant le module <module>mod_substitute</module>.</p>
<highlight language="config">
Substitute s/internal\.example\.com/www.example.com/i
</highlight>
-<p>Le module <module>mod_proxy_html</module> rend possible une réécriture plus
-élaborée des liens en HTML et XHTML. Il permet de créer des listes
-d'URLs et de leurs réécritures, de façon à pouvoir gérer des scénarios
-de réécriture complexes.</p>
+<p>Le module <module>mod_proxy_html</module> rend possible une réécriture plus
+élaborée des liens en HTML et XHTML. Il permet de créer des listes
+d'URLs et de leurs réécritures, de façon à pouvoir gérer des scénarios
+de réécriture complexes.</p>
</section>
-<section id="rewrite"><title>Moteur de réécriture</title>
+<section id="rewrite"><title>Moteur de réécriture</title>
- <p>Le moteur de réécriture <module>mod_rewrite</module> peut s'avérer
- utile lorsqu'une substitution plus puissante est nécessaire.
- Les directives fournies par ce module peuvent utiliser des caractéristiques de la
- requête comme le type de navigateur ou l'adresse IP source afin de décider
- depuis où servir le contenu. En outre, mod_rewrite peut utiliser des
- fichiers ou programmes de bases de données externes pour déterminer comment
- traiter une requête. Le moteur de réécriture peut effectuer les trois types
- de mise en correspondance discutés plus haut :
+ <p>Le moteur de réécriture <module>mod_rewrite</module> peut s'avérer
+ utile lorsqu'une substitution plus puissante est nécessaire.
+ Les directives fournies par ce module peuvent utiliser des caractéristiques de la
+ requête comme le type de navigateur ou l'adresse IP source afin de décider
+ depuis où servir le contenu. En outre, mod_rewrite peut utiliser des
+ fichiers ou programmes de bases de données externes pour déterminer comment
+ traiter une requête. Le moteur de réécriture peut effectuer les trois types
+ de mise en correspondance discutés plus haut :
redirections internes (aliases), redirections externes, et services mandataires.
- De nombreux exemples pratiques utilisant mod_rewrite sont discutés dans la
- <a href="rewrite/">documentation détaillée de mod_rewrite</a>.</p>
+ De nombreux exemples pratiques utilisant mod_rewrite sont discutés dans la
+ <a href="rewrite/">documentation détaillée de mod_rewrite</a>.</p>
</section>
-<section id="notfound"><title>Fichier non trouvé (File Not Found)</title>
+<section id="notfound"><title>Fichier non trouvé (File Not Found)</title>
- <p>Inévitablement, apparaîtront des URLs qui ne correspondront à aucun
- fichier du système de fichiers.
+ <p>Inévitablement, apparaîtront des URLs qui ne correspondront à aucun
+ fichier du système de fichiers.
Ceci peut arriver pour de nombreuses raisons.
- Il peut s'agir du déplacement de documents d'une
+ Il peut s'agir du déplacement de documents d'une
localisation vers une autre. Dans ce cas, le mieux est d'utiliser la
<a href="#redirect">redirection d'URL</a> pour informer les clients de la
- nouvelle localisation de la ressource. De cette façon, vous êtes sur que
- les anciens signets et liens continueront de fonctionner, même si la
- ressource est déplacée.</p>
+ nouvelle localisation de la ressource. De cette façon, vous êtes sur que
+ les anciens signets et liens continueront de fonctionner, même si la
+ ressource est déplacée.</p>
- <p>Une autre cause fréquente d'erreurs "File Not Found" est l'erreur de
+ <p>Une autre cause fréquente d'erreurs "File Not Found" est l'erreur de
frappe accidentelle dans les URLs, soit directement dans le navigateur,
soit dans les liens HTML. httpd propose le module
- <module>mod_speling</module> (sic) pour tenter de résoudre ce problème.
- Lorsque ce module est activé, il intercepte les erreurs
- "File Not Found" et recherche une ressource possédant un nom de fichier
- similaire. Si un tel fichier est trouvé, mod_speling va envoyer une
+ <module>mod_speling</module> (sic) pour tenter de résoudre ce problème.
+ Lorsque ce module est activé, il intercepte les erreurs
+ "File Not Found" et recherche une ressource possédant un nom de fichier
+ similaire. Si un tel fichier est trouvé, mod_speling va envoyer une
redirection HTTP au client pour lui communiquer l'URL correcte.
- Si plusieurs fichiers proches sont trouvés, une liste des alternatives
- possibles sera présentée au client.</p>
+ Si plusieurs fichiers proches sont trouvés, une liste des alternatives
+ possibles sera présentée au client.</p>
- <p>mod_speling possède une fonctionnalité particulièrement utile :
+ <p>mod_speling possède une fonctionnalité particulièrement utile :
il compare les noms de fichiers sans tenir compte de la casse.
- Ceci peut aider les systèmes où les utilisateurs ne connaissent pas la
- sensibilité des URLs à la casse et bien sûr les systèmes de fichiers unix.
+ Ceci peut aider les systèmes où les utilisateurs ne connaissent pas la
+ sensibilité des URLs à la casse et bien sûr les systèmes de fichiers unix.
Mais l'utilisation de mod_speling pour toute autre chose que la correction
occasionnelle d'URLs peut augmenter la charge du serveur, car chaque
- requête "incorrecte" entraîne une redirection d'URL et une nouvelle requête
+ requête "incorrecte" entraîne une redirection d'URL et une nouvelle requête
de la part du client.</p>
<p><module>mod_dir</module> fournit la directive <directive
module="mod_dir">FallbackResource</directive> qui permet d'associer
- des URIs virtuels à une ressource réelle qui peut ainsi les servir.
+ des URIs virtuels à une ressource réelle qui peut ainsi les servir.
Cette directive remplace avantageusement
- <module>mod_rewrite</module> lors de l'implémentation d'un
- "contrôleur frontal".</p>
+ <module>mod_rewrite</module> lors de l'implémentation d'un
+ "contrôleur frontal".</p>
<p>Si toutes les tentatives pour localiser le contenu
- échouent, httpd
+ échouent, httpd
retourne une page d'erreur avec le code de statut HTTP 404
- (file not found). L'apparence de cette page est contrôlée à l'aide de la
+ (file not found). L'apparence de cette page est contrôlée à l'aide de la
directive <directive module="core">ErrorDocument</directive>
- et peut être personnalisée de manière très flexible comme discuté dans le
+ et peut être personnalisée de manière très flexible comme discuté dans le
document
- <a href="custom-error.html">Réponses personnalisées aux erreurs</a>.</p>
+ <a href="custom-error.html">Réponses personnalisées aux erreurs</a>.</p>
</section>
<section id="other"><title>Autres modules de mise en correspondance des
URLs sont :</p>
<ul>
<li><module>mod_actions</module> - Met une URL en correspondance
- avec un script CGI en fonction de la méthode de la requête, ou du
+ avec un script CGI en fonction de la méthode de la requête, ou du
type MIME de la ressource.</li>
<li><module>mod_dir</module> - Permet une mise en correspondance
basique d'un slash terminal dans un fichier index comme
<code>index.html</code>.</li>
<li><module>mod_imagemap</module> - Met en correspondance une
- requête avec une URL en fonction de la zone d'une image intégrée à
+ requête avec une URL en fonction de la zone d'une image intégrée à
un document HTML dans laquelle un utilisateur clique.</li>
- <li><module>mod_negotiation</module> - Sélectionne le document
- approprié en fonction de préférences du client telles que la langue
+ <li><module>mod_negotiation</module> - Sélectionne le document
+ approprié en fonction de préférences du client telles que la langue
ou la compression du contenu.</li>
</ul>
projects / apache / commitdiff