From 6a0bbcd6a75cb81a0894fa075b9d1dba73892e4a Mon Sep 17 00:00:00 2001 From: Lucien Gentis Date: Mon, 23 Sep 2024 12:22:29 +0000 Subject: fr doc rebuild. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1920857 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/content-negotiation.html.fr.utf8 | 147 ++++++++++++++------------- docs/manual/mod/allmodules.xml.fr | 1 - 2 files changed, 74 insertions(+), 74 deletions(-) (limited to 'docs') diff --git a/docs/manual/content-negotiation.html.fr.utf8 b/docs/manual/content-negotiation.html.fr.utf8 index 5680afebcc..cc28e46e5c 100644 --- a/docs/manual/content-negotiation.html.fr.utf8 +++ b/docs/manual/content-negotiation.html.fr.utf8 @@ -31,7 +31,7 @@ -

Apache HTTPD supporte la négociation de +

Apache HTTPD prend en charge la négociation de contenu telle qu'elle est décrite dans la spécification HTTP/1.1. Il peut choisir la meilleure représentation d'une ressource en fonction des préférences du navigateur pour ce qui @@ -63,7 +63,7 @@ conventions de nommage différents types de média, ou une combinaison des deux. Pour faire le meilleur choix, on peut fournir à l'utilisateur une page d'index, et le laisser choisir. Cependant, le serveur peut souvent faire - ce choix automatiquement. Ceci est possible car les navigateurs peuvent + ce choix automatiquement. Cela est possible car les navigateurs peuvent envoyer des informations sur les représentations qu'ils préfèrent à l'intérieur de chaque requête. Par exemple, un navigateur peut indiquer @@ -81,7 +81,7 @@ conventions de nommage

À titre d'exemple d'une requête plus complexe, ce navigateur a été configuré pour accepter le français et l'anglais, avec une préférence pour le français, et accepter différents types de média, avec une préférence - pour HTML par rapport à au texte plat ("plain text") ou autres types de fichiers texte, et + pour HTML par rapport à au texte plat (« plain text ») ou autres types de fichiers texte, et avec une préférence pour GIF ou JPEG par rapport à tout autre type de média, mais autorisant tout autre type de média en dernier ressort :

@@ -90,24 +90,24 @@ conventions de nommage Accept: text/html; q=1.0, text/*; q=0.8, image/gif; q=0.6, image/jpeg; q=0.6, image/*; q=0.5, */*; q=0.1

-

httpd supporte la négociation de contenu "server driven" (telle qu'elle +

httpd prend en charge la négociation de contenu « server driven » (telle qu'elle est définie dans la spécification HTTP/1.1), où c'est le serveur qui - décide quelle est la meilleure représentation à retourner pour la ressource - demandée. Il supporte entièrement les en-têtes de requête + décide quelle est la meilleure représentation à renvoyer pour la ressource + demandée. Il prend entièrement en charge les en-têtes de requête Accept, Accept-Language, Accept-Charset et Accept-Encoding. - httpd supporte aussi la négociation de contenu transparente, qui est un + httpd prend aussi en charge la négociation de contenu transparente, qui est un protocole de négociation expérimental défini dans les RFC 2295 et 2296. - Il ne supporte pas la négociation de fonctionnalité (feature negotiation) + Il ne prend pas en charge la négociation de fonctionnalité (feature negotiation) telle qu'elle est définie dans ces RFCs.

Une ressource est une entité conceptuelle identifiée - par une URI (RFC 2396). Un serveur HTTP comme le serveur HTTP Apache + par un URI (RFC 2396). Un serveur HTTP comme le serveur HTTP Apache propose l'accès à des représentations de la ressource à l'intérieur de son espace de nommage, chaque représentation étant composée d'une séquence d'octets avec la définition d'un type de media, d'un jeu de caractères, - d'un encodage, etc... A un instant donné, chaque ressource peut être + d'un encodage, etc. À un instant donné, chaque ressource peut être associée avec zéro, une ou plusieurs représentations. Si plusieurs représentations sont disponibles, la ressource est qualifiée de négociable et chacune de ses représentations se nomme @@ -118,16 +118,16 @@ conventions de nommage

La négociation avec httpd

-

Afin de négocier une ressource, on doit fournir au serveur des +

Pour négocier une ressource, on doit fournir au serveur des informations à propos de chacune des variantes. Il y a deux manières - d'accomplir ceci :

+ d'y parvenir :

@@ -141,7 +141,7 @@ conventions de nommage type MIME application/x-type-map). Notez que pour utiliser cette fonctionnalité, vous devez, dans le fichier de configuration, définir un - gestionnaire qui associe un suffixe de fichier à une type-map; + gestionnaire qui associe un suffixe de fichier à une type-map, ce qui se fait simplement en ajoutant

AddHandler type-map .var
@@ -156,13 +156,13 @@ conventions de nommage foo.var.

Ce fichier doit comporter une entrée pour chaque variante - disponible; chaque entrée consiste en une ligne contiguë d'en-têtes au - format HTTP. les entrées sont séparées par des lignes vides. Les lignes + disponible ; chaque entrée consiste en une ligne contiguë d'en-têtes au + format HTTP. Les entrées sont séparées par des lignes vides. Les lignes vides à l'intérieur d'une entrée sont interdites. Par convention, le fichier de correspondances de types débute par une entrée concernant l'entité considérée dans son ensemble (bien que ce ne soit pas obligatoire, et ignoré si présent). Un exemple de fichier de - correspondance de types est fourni + correspondances de types est fourni ci-dessous.

Les URIs de ce fichier sont relatifs à la localisation du fichier @@ -187,7 +187,7 @@ conventions de nommage

Notez aussi qu'un fichier de correspondances de types prend le pas sur les extensions de noms de fichiers, même si les Multivues sont activées. Si les variantes sont de qualités différentes, on doit l'indiquer - à l'aide du paramètre "qs" à la suite du type de média, comme pour cette + à l'aide du paramètre « qs » à la suite du type de média, comme pour cette image (disponible aux formats JPEG, GIF, ou ASCII-art) :

@@ -212,7 +212,7 @@ conventions de nommage compte des capacités du client. Par exemple, un fichier JPEG possède en général une qualité supérieure à celle d'un fichier ASCII s'il représente une photographie. Cependant, si la ressource représentée est - à un ASCII art original, la représentation ASCII sera de meilleure qualité + un ASCII art original, la représentation ASCII sera de meilleure qualité que la représentation JPEG. Ainsi une valeur de qs est associée à une variante en fonction de la nature de la ressource qu'elle représente.

@@ -230,13 +230,13 @@ conventions de nommage httpd.conf, ou (si AllowOverride est correctement positionnée) dans des fichiers .htaccess. Notez que Options All - n'active pas MultiViews; vous devez activer cette option en + n'active pas MultiViews ; vous devez activer cette option en la nommant explicitement.

L'effet de MultiViews est le suivant : si le serveur reçoit une requête pour /tel/répertoire/foo, si MultiViews est activée pour - /tel/répertoire, et si + /tel/répertoire et si /tel/répertoire/foo n'existe pas, le serveur parcourt le répertoire à la recherche de fichiers nommés foo.*, et simule littéralement une correspondance de types (type map) qui liste tous ces @@ -252,15 +252,15 @@ conventions de nommage

le serveur va choisir entre index.html et index.html3 si les deux fichiers sont présents. Si aucun - n'est présent, mais index.cgi existe, + n'est présent, alors qu’index.cgi existe, le serveur l'exécutera.

Si, parcequ'elle n'est pas reconnue par mod_mime, l'extension d'un des fichiers du répertoire ne permet pas de déterminer son jeu de caractères, son type de contenu, son langage, ou son - encodage, alors + encodage, le résultat dépendra de la définition de la directive MultiViewsMatch. Cette directive détermine - si les gestionnaires (handlers), les filtres, et autres types d'extensions + si les gestionnaires (handlers), les filtres et autres types d'extensions peuvent participer à la négociation MultiVues.

top
@@ -269,8 +269,8 @@ conventions de nommage

Une fois obtenue la liste des variantes pour une ressource donnée, httpd dispose de deux méthodes pour choisir la meilleure variante à - retourner, s'il y a lieu, soit à partir d'un fichier de - correspondances de types, soit en se basant sur les noms de fichiers du + renvoyer, s'il y a lieu, soit à partir d'un fichier de + correspondances de types, soit en se basant sur les noms de fichier du répertoire. Il n'est pas nécessaire de connaître en détails comment la négociation fonctionne réellement pour pouvoir utiliser les fonctionnalités de négociation de contenu de httpd. La suite de ce document explique @@ -281,10 +281,10 @@ conventions de nommage

  1. La négociation effectuée par le serveur selon l'algorithme - de httpd est normalement utilisée. l'algorithme de + de httpd est utilisée par défaut. L'algorithme de httpd est expliqué plus en détails ci-dessous. Quand cet algorithme est utilisé, - httpd peut parfois "bricoler" le facteur de qualité (qs) d'une dimension + httpd peut parfois « bricoler » le facteur de qualité (qs) d'une dimension particulière afin d'obtenir un meilleur résultat. La manière dont httpd peut modifier les facteurs de qualité est expliquée plus en détails ci-dessous.
    2. @@ -292,11 +292,11 @@ conventions de nommage
  2. La négociation de contenu transparente est utilisée quand le navigateur le demande explicitement selon le mécanisme défini dans la RFC 2295. Cette méthode de négociation donne au navigateur le - contrôle total du choix de la meilleure variante; le résultat dépend + contrôle total du choix de la meilleure variante ; le résultat dépend cependant de la spécificité des algorithmes utilisés par le navigateur. Au cours du processus de négociation transparente, le navigateur peut - demander à httpd d'exécuter l'"algorithme de sélection de variante à - distance" défini dans la RFC 2296.
    3. + demander à httpd d'exécuter l'« algorithme de sélection de variante à + distance » défini dans la RFC 2296.

Les dimensions de la négociation

@@ -315,7 +315,7 @@ conventions de nommage Le navigateur affiche ses préférences à l'aide du champ d'en-tête Accept. Chaque type de média peut se voir associé un facteur de qualité. La description de la variante peut aussi avoir un facteur de - qualité (le paramètre "qs"). + qualité (le paramètre « qs »). @@ -328,7 +328,7 @@ conventions de nommage - Encoding + Encodage Le navigateur affiche ses préférences à l'aide du champ d'en-tête Accept-Encoding. Chaque encodage peut se voir associé un facteur de @@ -336,7 +336,7 @@ conventions de nommage - Charset + Jeu de caractères Le navigateur affiche ses préférences à l'aide du champ d'en-tête Accept-Charset. Chaque jeu de caractère peut se voir associé un facteur de @@ -349,8 +349,8 @@ conventions de nommage

L'algorithme de négociation de httpd

-

httpd peut utiliser l'algorithme suivant pour choisir la "meilleure" - variante (s'il y en a une) à retourner au navigateur. Cet algorithme n'est pas +

httpd peut utiliser l'algorithme suivant pour choisir la « meilleure » + variante (s'il y en a une) à renvoyer au navigateur. Cet algorithme n'est pas configurable. Il fonctionne comme suit :

    @@ -361,7 +361,7 @@ httpd S'il ne reste plus de variante, aller à l'étape 4.
  1. - Choisir la "meilleure" variante par élimination. Chacun des tests + Choisir la « meilleure » variante par élimination. Chacun des tests suivants est effectué dans cet ordre. Toute variante non sélectionnée à l'issue d'un test est éliminée. Après chaque test, s'il reste une seule variante, choisir cette dernière comme celle qui correspond le @@ -370,7 +370,7 @@ httpd
    1. Multiplier le facteur de qualité de l'en-tête - Accept par le facteur de qualité "qs" pour le type de + Accept par le facteur de qualité « qs » pour le type de média de ces variantes, et choisir la variante qui possède la valeur la plus importante.
      2. @@ -383,18 +383,18 @@ httpd LanguagePriority (si elle existe).
    2. Sélectionner les variantes possédant le paramètre de média - "level" le plus élevé (utilisé pour préciser la version des types de + « level » le plus élevé (utilisé pour préciser la version des types de média text/html).
    3. Sélectionner les variantes possédant le paramètre de média - "charset" (jeu de caractères) qui correspond le mieux, en se basant + « charset » (jeu de caractères) qui correspond le mieux, en se basant sur la ligne d'en-tête Accept-Charset . Le jeu de caractères ISO-8859-1 est acceptable sauf s'il est explicitement exclus. Les variantes avec un type de média text/* mais non explicitement associées avec un jeu de caractères particulier sont supposées être en ISO-8859-1.
      4. -
    4. Sélectionner les variantes dont le paramètre de média "charset" +
    5. Sélectionner les variantes dont le paramètre de média « charset » associé n'est pas ISO-8859-1. S'il n'en existe pas, sélectionner toutes les variantes.
      6. @@ -417,16 +417,16 @@ httpd
    6. L'algorithme a maintenant sélectionné une variante considérée comme - la "meilleure", il la retourne donc au client en guise de réponse. + la « meilleure », il la renvoie donc au client en guise de réponse. L'en-tête HTTP Vary de la réponse est renseigné de façon à indiquer les dimensions de la négociation (les navigateurs et les caches peuvent utiliser cette information lors de la mise en cache de la ressource). Travail terminé.
    7. Le passage par cette étape signifie qu'aucune variante n'a été - sélectionnée (parcequ'aucune n'est acceptable pour le navigateur). - Envoyer une réponse avec un code de statut 406 (qui signifie "Aucune - représentation acceptable") et un corps comportant un document HTML qui + sélectionnée (parce qu'aucune n'est acceptable pour le navigateur). + Envoyer une réponse avec un code de statut 406 (qui signifie « Aucune + représentation acceptable ») et un corps comportant un document HTML qui affiche les variantes disponibles. Renseigner aussi l'en-tête HTTP Vary de façon à indiquer les dimensions de la variante.
    @@ -437,7 +437,7 @@ httpd

    Parfois httpd modifie les valeurs de qualité par rapport à celles qui découleraient d'une stricte interprétation de l'algorithme de négociation - de httpd ci-dessus, ceci pour améliorer les résultats de l'algorithme pour + de httpd ci-dessus, cela afin d’améliorer les résultats de l'algorithme pour les navigateurs qui envoient des informations incomplètes ou inappropriées. Certains des navigateurs les plus populaires envoient des informations dans l'en-tête Accept qui, sans ce traitement, provoqueraient la @@ -449,13 +449,13 @@ httpd

    L'en-tête de requête Accept: indique les types de média souhaités. Il peut aussi contenir des types de média avec caractères - génériques, comme "image/*" ou "*/*" où * correspond à n'importe quelle + génériques, comme « image/* » ou « */* » où * correspond à n'importe quelle chaîne de caractères. Ainsi une requête contenant :

    Accept: image/*, */*

    indiquerait que tout type de média est acceptable, avec une préférence - pour les types commençant par "image/". + pour les types commençant par « image/ ». Certains navigateurs ajoutent par défaut des types de média avec caractères génériques aux types explicitement nommés qu'ils peuvent gérer. Par exemple :

    @@ -463,7 +463,7 @@ httpd

    Accept: text/html, text/plain, image/gif, image/jpeg, */*

    -

    Ceci indique que les types explicitement listés sont préférés, mais +

    Cela indique que les types explicitement listés sont préférés, mais qu'une représentation avec un type différent de ces derniers conviendra aussi. Les valeurs de qualités explicites, afin de préciser ce que veut vraiment le navigateur, s'utilisent @@ -474,15 +474,16 @@ httpd

    Les types explicites n'ont pas de facteur de qualité, la valeur par défaut de leur préférence est donc de 1.0 (la plus haute). Le type avec caractères génériques */* se voit attribuer une préférence basse de 0.01, - si bien que les types autres que ceux explicitement listés ne seront retournés + si bien que les types autres que ceux explicitement listés ne seront + renvoyés que s'il n'existe pas de variante correspondant à un type explicitement listé.

    -

    Si l'en-tête Accept: ne contient pas aucun +

    Si l'en-tête Accept: ne contient pas de facteur de qualité, httpd positionne la valeur de qualité de - "*/*", si present, à 0.01 pour simuler l'effet désiré. Il positionne aussi + « */* », si présent, à 0.01 pour simuler l'effet désiré. Il positionne aussi la valeur de qualité des types avec caractères génériques au format - "type/*" à 0.02 (ils sont donc préférés à ceux correspondant à "*/*"). Si + « type/* » à 0.02 (ils sont donc préférés à ceux correspondant à « */* »). Si un type de média dans l'en-tête Accept: contient un facteur de qualité, ces valeurs spéciales ne seront pas appliquées, de façon à ce que les requêtes de navigateurs qui envoient les informations @@ -497,11 +498,11 @@ langage quand la négociation ne trouve aucun langage correspondant.

    Quand un client demande une page sur votre serveur, si ce dernier ne - parvient pas à trouver une page dont la langue corresponde à l'en-tête + parvient pas à trouver une page dont la langue correspond à l'en-tête Accept-language envoyé par le navigateur, il enverra au client - une réponse "Aucune variante acceptable" ou "Plusieurs choix possibles". + une réponse « Aucune variante acceptable » ou « Plusieurs choix possibles ». Pour éviter ces - messages d'erreur, il est possible de configurer httpd de façon à ce que, + messages d'erreur, il est possible de configurer httpd de façon que, dans ces cas, il ignore l'en-tête Accept-language et fournisse tout de même un document, même s'il ne correspond pas exactement à la demande explicite du client. La directive ForceLanguagePriority @@ -514,26 +515,26 @@ langage trouvée. Par exemple, si un client demande des documents possédant le langage en-GB, c'est à dire anglais britannique, le standard HTTP/1.1 n'autorise normalement pas le serveur à faire correspondre cette - demande à un document dont le langage est simplement en. - (Notez qu'inclure en-GB et non en dans l'en-tête + demande à un document dont le langage est simplement en + (notez qu'inclure en-GB et non en dans l'en-tête Accept-Language constitue une quasi-erreur de configuration, car il est très peu probable qu'un lecteur qui comprend l'anglais britannique, ne comprenne pas l'anglais en général. Malheureusement, de - nombreux clients ont réellement des configurations par défaut de ce type.) - Cependant, si aucune autre correspondance de langage n'est possible, et que le - serveur est sur le point de retourner une erreur "Aucune variable - acceptable" ou de choisir le langage défini par la directive LanguagePriority, le serveur ignorera + nombreux clients ont réellement des configurations par défaut de ce type). + Cependant, si aucune autre correspondance de langage n'est possible, et si le + serveur est sur le point de renvoyer une erreur « Aucune variable + acceptable » ou de choisir le langage défini par la directive LanguagePriority, le serveur ignorera la spécification du sous-ensemble de langage et associera la demande en en-GB à des documents en en. Implicitement, - httpd ajoute le langage parent à la liste de langues acceptés par le + httpd ajoute le langage parent à la liste de langages acceptés par le client avec une valeur de qualité très basse. Notez cependant que si le - client demande "en-GB; q=0.9, fr; q=0.8", et le serveur dispose de - documents estampillés "en" et "fr", alors c'est le document "fr" qui sera - retourné, tout ceci dans un souci de compatibilité avec la spécification + client demande « en-GB; q=0.9, fr; q=0.8 », et si le serveur dispose de + documents estampillés « en » et « fr », c'est le document « fr » qui sera + renvoyé, tout cela dans un souci de compatibilité avec la spécification HTTP/1.1 et afin de fonctionner efficacement avec les clients correctement configurés.

    -

    Pour supporter les techniques avancées (comme les cookies ou les chemins +

    Pour prendre en charge les techniques avancées (comme les cookies ou les chemins d'URL spéciaux) afin de déterminer le langage préféré de l'utilisateur, le module mod_negotiation reconnaît la variable d'environnement @@ -591,7 +592,7 @@ conventions de nommage @@ -685,10 +686,10 @@ conventions de nommage

    Pour les requêtes en provenance d'un client compatible HTTP/1.0 diff --git a/docs/manual/mod/allmodules.xml.fr b/docs/manual/mod/allmodules.xml.fr index 59b1f29a1d..effe20a274 100644 --- a/docs/manual/mod/allmodules.xml.fr +++ b/docs/manual/mod/allmodules.xml.fr @@ -129,7 +129,6 @@ mod_suexec.xml.fr mod_syslog.xml.fr mod_systemd.xml.fr - mod_tls.xml.fr mod_unique_id.xml.fr mod_unixd.xml.fr mod_userdir.xml.fr -- cgit v1.2.3