-<?xml version="1.0" encoding="UTF-8" ?>
+<?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: 1932813:1933716 (outdated) -->
+<!-- English Revision: 1933716 -->
<!-- French translation : Lucien GENTIS -->
-<!-- Reviewed by : Vincent Deffontaines -->
<!--
Licensed to the Apache Software Foundation (ASF) under one or more
<name>mod_mime</name>
<description>Associe les extensions des fichiers demandés avec l'action
-déclenchée par ces fichiers et avec leur contenu (type MIME, langue,
+déclenchée par ces fichiers et avec leur contenu (type MIME, langage,
jeu de caractère et codage)</description>
<status>Base</status>
<sourcefile>mod_mime.c</sourcefile>
sélectionnés pour une réponse HTTP, en associant des modèles d'URI
ou de noms de fichiers aux valeurs des métadonnées. Par exemple, les
extensions de noms de fichiers définissent souvent le type de médium
- Internet, la langue, le jeu de caractères et le codage du contenu.
+ Internet, le langage, le jeu de caractères et le codage du contenu.
Ces informations sont relayées par les messages HTTP véhiculant ces
contenus, et utilisées au cours de la négociation de contenu lors de
la sélection des différentes possibilités, de manière à ce que les
module="mod_mime">AddType</directive> permettent d'associer des
extensions de fichiers aux métadonnées de ces fichiers. Elles
définissent respectivement le jeu de caractères, le codage du
- contenu, la langue du contenu et le <glossary>type de
+ contenu, le langage du contenu et le <glossary>type de
médium</glossary> (content-type) des documents. La directive
<directive module="mod_mime">TypesConfig</directive> permet de
spécifier un fichier qui contient lui-même des associations entre
pas la valeur de l'en-tête <code>Last-Modified</code>. Ainsi,
certaines copies de documents préalablement mises en cache peuvent
encore être utilisées par un client ou un mandataire avec les
- anciens en-têtes. Si vous modifiez les métadonnées (langue, type de
+ anciens en-têtes. Si vous modifiez les métadonnées (langage, type de
contenu, jeu de caractère ou codage), vous devez donc enregistrer
une modification du fichier concerné (afin de mettre à jour sa date
de dernière modification), pour être sûr que tous les visiteurs
<p>Les fichiers peuvent posséder plusieurs extensions dont l'ordre
est <em>normalement</em> sans importance. Par exemple, si
le fichier <code>welcome.html.fr</code> est associé au type de
- contenu <code>text/html</code> et à la langue française, le fichier
+ contenu <code>text/html</code> et au langage Français, le fichier
<code>welcome.fr.html</code> possèdera exactement les même
métadonnées. Si le fichier possède plusieurs extensions associées
au même type de métadonnée, c'est celle de ces extensions la plus à
- droite qui sera utilisée, excepté pour ce qui concerne les langues
+ droite qui sera utilisée, excepté pour ce qui concerne les langages
et les codages de contenu. Par exemple, si <code>.gif</code> est
associé au <glossary>type de médium</glossary>
<code>image/gif</code>, et <code>.html</code> au type de médium
<p>Les <a href="#charset-lang">Languages</a> et les <a
href="#contentencoding">codages de contenu</a> sont traités de
manière cumulative, car il est possible d'assigner plusieurs
- langues ou codages à une ressource particulière. Par exemple, le
+ langages ou codages à une ressource particulière. Par exemple, le
fichier <code>welcome.html.en.de</code> sera servi avec les en-têtes
<code>Content-Language: en, de</code> et <code>Content-Type:
text/html</code>.</p>
</highlight>
</example>
+ <note><title>Files with no extension</title>
+ <p>Les fichiers sans extension (comme <code>Makefile</code>) ne peuvent pas
+ être reconnus par les directives de <module>mod_mime</module> basées sur
+ l’extension. Pour définir le type de contenu ou le jeu de caractères de tels
+ fichiers, utilisez à la place une section <directive type="section"
+ module="core">Files</directive> ou <directive type="section"
+ module="core">FilesMatch</directive> :</p>
+
+ <highlight language="config">
+# Pour un fichier spécifique :
+<Files "Makefile">
+ ForceType text/plain
+ AddDefaultCharset UTF-8
+</Files>
+
+# Pour tous les fichiers sans extension :
+<FilesMatch "^[^.]+$">
+ ForceType text/plain
+ AddDefaultCharset UTF-8
+ AddDefaultCharset UTF-8
+</FilesMatch>
+ </highlight>
+ </note>
+
</section>
<section id="contentencoding"><title>Codage du contenu</title>
<p>Un fichier d'un <glossary>type de médium</glossary> particulier
- peut être également codé d'une certaine manière pour simplifier sa
+ peut être aussi codé d'une certaine manière pour simplifier sa
transmission sur Internet. Alors que cela concerne en général la
compression, comme <code>gzip</code>, il peut aussi s'agir de
chiffrement, comme <code>pgp</code> ou d'un codage comme UUencoding,
qui est conçu pour transmettre un fichier binaire sous un format
ASCII (texte).</p>
- <p>La <a href="http://www.ietf.org/rfc/rfc2616.txt">RFC
- HTTP/1.1</a>, section 14.11 stipule à ce titre :</p>
+ <p>La RFC HTTP/1.1 (<rfc>2616</rfc>), section 14.11 stipule à ce titre :</p>
<blockquote cite="http://www.ietf.org/rfc/rfc2616.txt">
<p>Le champ d'en-tête Content-Encoding de l'entité est utilisé en
<highlight language="config">Content-encoding: pkzip</highlight>
</section>
-<section id="charset-lang"><title>Jeux de caractères et langues</title>
+<section id="charset-lang"><title>Jeux de caractères et langages</title>
<p>En plus du type de fichier et du codage, un autre élément
- important d'information est la langue dans laquelle le document est
+ important d'information est le langage dans lequel le document est
écrit, et avec quel jeu de caractères le contenu du fichier doit
être affiché. Par exemple, un document peut être écrit en alphabet
vietnamien ou cyrillique, et doit être affiché en conséquence. Cette
- information est également transmise via des en-têtes HTTP.</p>
+ information est aussi transmise via des en-têtes HTTP.</p>
- <p>Les jeu de caractères, langue, codage et type MIME sont tous
+ <p>Les jeu de caractères, langage, codage et type MIME sont tous
utilisés au cours du processus de négociation de contenu (voir
<module>mod_negotiation</module>) afin de déterminer quel document
servir au client, lorsque plusieurs choix sont possibles en fonction
- du jeu de caractères, de la langue, du codage ou du type MIME. Toutes
+ du jeu de caractères, du langage, du codage ou du type MIME. Toutes
les associations d'extensions de noms de fichiers créées via les
directives <directive module="mod_mime">AddCharset</directive>,
<directive module="mod_mime">AddEncoding</directive>, <directive
<section id="charset"><title>Jeu de caractères</title>
<p>Pour transmettre cette information supplémentaire, Apache peut
ajouter un en-tête <code>Content-Language</code>, afin de
- spécifier la langue dans laquelle le document est écrit, et peut
+ spécifier le langage dans lequel le document est écrit, et peut
ajouter des informations additionnelles à l'en-tête
<code>Content-Type</code> pour indiquer le jeu de caractères
particulier qui doit être utilisé pour restituer correctement le
Content-Type: text/plain; charset=ISO-8859-1
</example>
- <p>La langue est spécifiée via son abréviation en deux lettres. Le
+ <p>Le langage est spécifié via son abréviation en deux lettres. Le
<code>jeu de caractères</code> est le nom du jeu de caractères
particulier qui doit être utilisé.</p>
</section>
client sur le codage des caractères du document afin que ce dernier
puisse être interprété et affiché correctement, et à la <a
href="../content-negotiation.html">négociation de contenu</a>, au
- cours de laquelle le serveur décide lequel parmi plusieurs
+ cours de laquelle le serveur décide lequels parmi plusieurs
documents possibles il renvoie au client en fonction des préférences
de ce dernier en matière de jeu de caractères.</p>
elles.</p>
</usage>
<seealso><directive module="core">SetHandler</directive></seealso>
+<seealso><directive module="mod_dir">FallbackResource</directive></seealso>
</directivesynopsis>
<directivesynopsis>
<usage>
<p>La directive <directive>AddInputFilter</directive> permet
d'associer l'extension de nom de fichier <var>extension</var> aux <a
- href="../filter.html">filtres</a> spécifiés qui traiteront les
+ href="../filter.html">filtres</a> spécifiésqui traiteront les
requêtes clients et les entrées POST à leur réception par le
serveur. Ceci s'ajoute à toute définition de filtre préexistante, y
compris la directive <directive
<directivesynopsis>
<name>AddLanguage</name>
-<description>Associe l'extension de nom de fichier donnée à la langue
+<description>Associe l'extension de nom de fichier donnée au langage
spécifié</description>
-<syntax>AddLanguage <var>symbole-langue</var> <var>extension</var>
+<syntax>AddLanguage <var>symbole-langage</var> <var>extension</var>
[<var>extension</var>] ...</syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<usage>
<p>La directive <directive>AddLanguage</directive> permet d'associer
- l'extension de nom de fichier donnée à la langue spécifiée. Les
+ l'extension de nom de fichier donnée au langage spécifié. Les
fichiers dont l'extension correspond à la valeur
de l'argument <var>extension</var> se voient attribuer la valeur de
- l'argument <var>symbole-langue</var> comme en-tête HTTP
- Content-Language en accord avec les identifiants de langues définis
+ l'argument <var>symbole-langage</var> comme en-tête HTTP
+ Content-Language en accord avec les identifiants de langages définis
par la RFC 3066. Cette directive l'emporte sur toute association
préexistante pour la même <var>extension</var>.</p>
<p>Avec cet exemple, le document <code>xxxx.en.Z</code> sera traité
en tant que document compressé de langue anglaise (idem pour le
- document <code>xxxx.Z.en</code>). Bien que la langue soit fournie au
+ document <code>xxxx.Z.en</code>). Bien que le langage soit fourni au
client, le navigateur n'utilise habituellement pas cette
information. La directive <directive>AddLanguage</directive> est
principalement utilisée au cours de la <a
href="../content-negotiation.html">négociation de contenu</a>, où le
serveur choisit d'envoyer un document parmi plusieurs documents
possibles en fonction de la préférence du client en matière de
- langue.</p>
+ langage.</p>
<p>Si une extension fait l'objet de plusieurs associations de
- langues, c'est la dernière qui sera utilisée. Ainsi, dans le cas
+ langages, c'est la dernière qui sera utilisée. Ainsi, dans le cas
suivant,</p>
<highlight language="config">
</highlight>
<p>les documents possédant l'extension <code>.en</code> seront
- traités en tant que documents de langue <code>en-us</code>.</p>
+ traités en tant que documents de langage <code>en-us</code>.</p>
<p>L'argument <var>extension</var> est insensible à la casse et peut
être spécifié avec ou sans le point initial. Les noms de fichiers
<usage>
<p>La directive <directive>AddType</directive> permet d'associer les
- extensions de noms de fichiers données au type de contenu spécifié.
+ extensions de noms fichiers données au type de contenu spécifié.
<var>type-médium</var> est le <glossary ref="media-type">Type
MIME</glossary> à utiliser pour les fichiers dont le nom possède
l'extension <var>extension</var>. Cette association s'ajoute à toute
sa requête n'est pas en mesure de traiter le contenu renvoyé par le
serveur.</p>
- <p>À la base, cette directive configure le type de contenu généré
+ <p>A la base, cette directive configure le type de contenu généré
pour les fichiers statiques servis à partir du système de fichiers.
Dans le cas des ressources autres que les fichiers statiques pour
lesquelles le générateur de la réponse spécifie en général un
Content-Type, cette directive n'a aucun effet.</p>
<note><title>Note</title>
- <p>Si aucun gestionnaire n'est explicitement défini pour une
- requête, le type de contenu spécifié sera aussi utilisé comme nom du
- gestionnaire.</p>
-
+ <p>Si aucun gestionnaire n'a été explicitement défini pour une
+ requête, c'est le type de contenu spécifié qui sera utilisé comme
+ nom de gestionnaire.</p>
+
<p>Lorsqu'aucune directive comme <directive
module="core">SetHandler</directive> ou
<directive module="mod_mime">AddHandler</directive> ne s'applique à
- une requête, le nom de gestionnaire interne normalement défini
- par une de ces directives est en fait défini par le type de contenu
- spécifié par la présente directive.</p>
+ une requête, le nom de gestionnaire interne qui aurait du être
+ défini par une de ces directives correspond alors au type de contenu
+ spécifié par la directive AddType.
+ </p>
<p>
Pour des raisons historiques, certains modules tiers comme mod_php
- peuvent adopter ce type de comportement pour prendre en compte la
+ peuvent adopter ce comportement pour forcer la prise en compte de la
requête concernée.
</p>
+
<p>Il est conseillé d'éviter les configurations qui reposent sur de
tels types "synthétiques". En outre, les configurations qui
limitent l'accès aux directives <directive
comportements différents pour la fonctionnalité Multiviews du module
<a href="mod_negotiation.html">mod_negotiation</a>. Les vues
multiples permettent d'associer une requête pour un fichier, par
- exemple <code>index.html</code>, à toute extension négociée
+ exemple <code>index.html</code>, à toute extension négotiée
s'ajoutant à la requête de base, par exemple
<code>index.html.en</code>, <code>index.html.fr</code>, ou
<code>index.html.gz</code>.</p>
<directivesynopsis>
<name>DefaultLanguage</name>
-<description>Définit un symbole de langue par défaut à affecter au champ
+<description>Défini un symbole de langage par défaut à affecter au champ
d'en-tête Content-Language pour toutes les ressources dans le contexte
-courant auxquelles aucun symbole de langue n'a été
+courant auxquelles aucun symbole de langage n'a été
associé.</description>
-<syntax>DefaultLanguage <var>symbole-langue</var></syntax>
+<syntax>DefaultLanguage <var>symbole-langage</var></syntax>
<contextlist><context>server config</context><context>virtual host</context>
<context>directory</context><context>.htaccess</context></contextlist>
<override>FileInfo</override>
d'indiquer à Apache que toutes les ressources du contexte courant
(par exemple, toutes les ressources concernées par le conteneur
<directive module="core" type="section">Directory</directive>
- courant) qui ne possèdent pas d'extension de langue explicite
+ courant) qui ne possèdent pas d'extension de langage explicite
(comme <code>.fr</code> ou <code>.de</code> tel que défini par la
directive <directive module="mod_mime">AddLanguage</directive>),
- verront leur en-tête HTTP Content-Language affecté de la langue
- <var>symbole-langue</var>. Ceci permet de marquer des arborescences
+ verront leur en-tête HTTP Content-Language affecté du langage
+ <var>symbole-langage</var>. Ceci permet de marquer des arborescences
de répertoires entières comme contenant des documents en français,
par exemple, sans avoir à renommer chaque fichier. Notez qu'à la
différence de l'utilisation des extensions pour spécifier des
- langues, <directive>DefaultLanguage</directive> ne permet de
- spécifier qu'une seule langue.</p>
+ langages, <directive>DefaultLanguage</directive> ne permet de
+ spécifier qu'un seul langage.</p>
<p>Si aucune directive <directive>DefaultLanguage</directive> n'est
en vigueur, et si un fichier ne possède pas d'extension configurée
<directivesynopsis>
<name>RemoveLanguage</name>
-<description>Supprime toute association de langue à un ensemble
+<description>Supprime toute association de langage à un ensemble
d'extensions de noms de fichiers</description>
<syntax>RemoveLanguage <var>extension</var> [<var>extension</var>]
...</syntax>
<usage>
<p>La directive <directive>RemoveLanguage</directive> permet de
- supprimer toute association de langue à des fichiers dont le nom
+ supprimer toute association de langage à des fichiers dont le nom
possède l'extension donnée. Ceci permet, au
sein des fichiers <code>.htaccess</code>, d'annuler toute
association héritée du répertoire parent ou de la configuration du
fichier contient la liste des associations par défaut des extensions
de noms de fichiers aux types de contenus. La plupart des
administrateurs utilisent le fichier <code>mime.types</code> fourni
- par leur système d'exploitation,
+ par leur OS,
qui associe les extensions de noms de fichiers courantes à la liste
officielle des types de média enregistrés par l'IANA et maintenue à
<a href=
requêtes du type <code>catégorie/x-sous-type</code> seront
systématiquement rejetées, ainsi que toute nouvelle extension de
deux lettres, car elle ont de fortes chances d'entrer en conflit
- par la suite avec les inombrables langues préexistantes et les
+ par la suite avec les innombrables langages préexistants et les
espaces de nommage des jeux de caractères.
</note>
</usage>
projects / thirdparty / apache / httpd.git / commitdiff
