## Configurer Amaya

Amaya utilise différents fichiers de configuration pour initialiser les paramètres globaux, dialogues, raccourcis, taille et position de la fenêtre, feuille de style de l'utilisateur, etc. Vous pouvez changer la majorité des paramètres de configuration par le biais des menus de préférences spécifiques. Ce document expose sommairement le répertoire de configuration et les conventions du fichier, donne un aperçu des différents menus de préférence, et donne une information spécifique sur comment configurer les raccourcis clavier.

### Conventions

#### Le répertoire d'Amaya/Config

C'est le répertoire dans lequel la plupart des valeurs par défaut et tous les messages de dialogue sont stockés. Le parent du répertoire est celui où Amaya a été installé.

#### Le répertoire d'AmayaHome

Amaya stocke les préférences de l'utilisateur ainsi que les autres fichiers de configuration de l'utilisateur que nous appellerons le répertoire AmayaHome. Un répertoire existant peut être sélectionné par l'utilisateur en utilisant la variable d'environnement `AMAYA_USER_HOME`. Sinon Amaya sélectionne un répertoire par défaut.

La table suivante montre la position par défaut de ce répertoire dans les différentes architectures :

architecture | le répertoire AmayaHome
Unix | `$HOME/.amaya`
Windows 95/ Windows 98 | `AMAYA-INSTALL-DIR\users\username` or, if the user didn't login to Windows, `AMAYA-INSTALL-DIR\users\default`
Windows NT/XP | `$HOMEDRIVE\$HOMEPATH\amaya par défaut c:\Documents and Settings\$user_name\amaya`

Le répertoire AmayaHome est conservé seulement quand on installe les nouvelles versions d'Amaya et peut contenir les fichiers suivants :

- thot.rc : les préférences de l'utilisateur, changées grâce au menu préférences.
- amaya.keyboard (Unix) ou amaya.kb (Windows) : ce fichier définit les raccourcis clavier d'Amaya.
- amaya.css : contient la feuille de style de l'utilisateur.
- dictionary.DCT : Amaya fournit un vérificateur d'orthographe multi-langues. Par défaut le vérificateur d'orthographe travaille avec deux dictionnaires : Le dictionnaire Anglais et le dictionnaire Français (ces deux dictionnaires peuvent être téléchargés depuis les serveurs W3C). Quand l'utilisateur veut enregistrer un nouveau mot, le vérificateur d'orthographe crée ou met à jour le "dictionnaire personnel de l'utilisateur".

Note : les fichiers amaya.keyboard/amaya.kb et amaya.css sont chargés au moment du démarrage. Si vous les changer, vous devrez quitter et redémarrer Amaya pour les prendre en compte.

#### Le répertoire AmayaTemp

Amaya stocke tous les fichiers temporaires qu'il crée durant l'exécution dans un répertoire que nous appelons le répertoire AmayaTemp. La table suivante montre où ce répertoire est stocké dans les différents architectures :

architecture | le répertoire AmayaTemp
Unix | $HOME/.amaya
Windows 9x | c :\temp\amaya (default value)
Window XP | $HOMEDRIVE\$HOMEPATH\Local Settings\Temp\amaya par défaut c:\Documents and Settings\$user_name\Local Settings\Temp\amaya

Amaya crée des fichiers dans ce répertoire pendant que vous naviguez des documents lointains ou que vous imprimez un document. Le cache est stocké dans ce répertoire. L'utilisateur peut changer le répertoire AmayaTemp et le répertoire cache par le biais des menus Préférences Générales et Préférences Cache.

Amaya essaye toujours d'effacer tous les fichiers temporaires qu'il crée. Cependant, si Amaya plante, les fichiers temporaires ne seront pas effacés. Ceci n'aura pas d'impact sur les exécutions d'Amaya ultérieurement.

## Menus des Préférences

Ces menus se trouvent sous le menu Éditer/Préférences. Il y a 10 différents menus de préférences disponibles : Générales, Navigation, Publication, Cache, Proxy, Couleurs, Géométrie, Négociation des langues, Profils, et Modèles de page. Ces menus sont légèrement différents sur Windows et station Unix, mais chacun présente trois boutons d'action :

Appliquer | Ce bouton valide et stocke les options affichées dans le menu.
Défauts | Ce bouton rétablit, mais ne sauve pas, les valeurs par défaut. Utilisez le bouton Appliquer pour valider les options.
Terminer | Ce bouton ferme le menu.

### Les préférences générales

Le répertoire Amaya user (sur stations Windows uniquement, non montré dans la figure incluse)
  Spécifie le répertoire où les préférences de l'utilisateur sont stockées.
  Note : l'utilisateur ne peut changer l'adresse de ce répertoire.
Le répertoire Amaya temporary (sur stations Windows uniquement, non montré dans la figure)
  Spécifie le répertoire où Amaya stockera les fichiers temporaires, par exemple, pendant que vous imprimez un document. Si ce n'est pas spécifié, le répertoire temporaire par défaut sera `c :\temp`.
  Note : le fait de changer ce répertoire n'effacera pas le précédent. Vous devrez supprimer l'ancien répertoire manuellement. Si le cache était localisé sous le répertoire temporaire précédent, un nouveau cache sera créé sous le nouveau répertoire.
Page de démarrage
  Spécifie l'URI qu'Amaya chargera au démarrage ou quand l'utilisateur pressera le bouton Home. Un exemple est `http://www.w3.org`.
  Note : Un URI complet doit être utilisé.
Activer le coller ligne à ligne
  Cette option concerne le coller depuis une autre application. Quand cette option est activée, les lignes de l'application source sont conservées. Sinon les caractères « fin de ligne » sont remplacés par des espaces.
Produire des fichiers de sauvegarde
  Si cette option est active Amaya va produire périodiquement un fichier de sauvegarde pour chaque document édité.
Sauver la géométrie en quittant
  La géométrie courante des fenêtres sera automatiquement sauvegardée en quittant l'application..
Montrer boutons
  Contrôle si Amaya affiche les barres de boutons dans chaque vue principale de document.
Montrer adresse
  Contrôle si Amaya affiche les adresses des pages dans chaque vue principale de document.
Montrer les cibles
  Contrôle si les cibles de liens sont visualisées ou non. Montrer les cibles peut aider quand on veut créer de nouveaux liens. Cette option agit immédiatement sur toutes les vues formatées de documents.
Accès rapides
  Spécifie la touche Alt ou Control utilisée pour mettre en oeuvre les accès rapides du document ou indique que les accès rapides définis les documents sont ignorés.
Taille de caractères des menus (stations Unix uniquement)
  Spécifie la taille de la police de caractères dans tous les menus d'Amaya. Cette option est aussi prise en compte au démarrage.
Zoom sur les caractères
  Il est possible d'augmenter et de diminuer l'effet de zoom, fenêtre de document par fenêtre de document. Chaque document (texte et images) visualisé à l'intérieur d'une fenêtre zoomée sera visualisée plus gros ou plus petit que sa taille réelle selon le zoom courant.
  Cette option vous permet de changer le zoom par défaut pour toutes les fenêtres. Ce changement affecte uniquement les tailles des polices de caractères mais pas les images. Cette option est reflétée immédiatement sur tous les documents ouverts.
Langue du dialogue
  Spécifie la langue utilisée dans les menus et les messages. La langue par défaut est l'anglais américain (valeur `en`). D'autres langues sont possibles comme le français (`fr`), l'italien (it), l'espagnol (es), et l'allemand (`de`). Au démarrage, Amaya charge les fichiers de dialogue selon la langue de dialogue courante : les fichiers en-, fr-, ou de- . Ces fichiers de dialogue se trouvent dans le répertoire Amaya/config.

  Il est possible d'adapter Amaya aux nouvelles langues ISO-Latin-1 en écrivant les fichiers de dialogue correspondants. Ces fichiers de dialogue doivent se trouver dans le même répertoire (c'est à dire Amaya/config) et doivent utiliser le code correct ISO 639 comme préfixe (it- pour Italien, de- pour Allemand, etc.). Le fichier code spécifique HTML doit aussi être créé.

### Préférences de navigation

Cette boîte de dialogue vous permet d'enregistrer vos préférences de navigation.

Charger les images
  Contrôle si les images doivent être chargées et affichées. Sinon, l'attribut ALT est visualisé à la place de l'image. Cette option prend effet dès que le formulaire est validé.
Charger les objets
  Contrôle si les objets doivent être chargés et affichés. Sinon, le contenu de l'objet est visualisé à la place de l'objet. Cette option prend effet dès que le formulaire est validé.
Montrer les images de fond
  Contrôle si les images en arrière plan doivent être montrées ou non. Cette option prend effet dès que le formulaire est validé. document.
Le double clic active les liens
  Depuis la première version d'Amaya, les utilisateurs ont besoin de double cliquer sur un lien pour l'activer. Cela permet de différencier l'édition d'un lien de son activation. Vous pouvez changer ce comportement en désactivant cette option.
Activer le FTP
  Amaya permet de suivre les URLs de type FTP. Ce support est expérimental et il n'est pas encore débogué. Par exemple, les URLs FTP nécessitent une authentification de l'utilisateur, l'authentification de l'information n'étant pas toujours mémorisée. Aussi, le fait de taper sur le bouton Stop pendant un téléchargement FTP peut faire planter Amaya. Malgré ces problèmes, nous avons rajouté cette option dans Amaya afin que les autres développeur puissent nous aider à le déboguer rapidement. Par défaut, cette option est inactive.
Type d'écran courant
  L'application des feuilles de style (CSS) dépendent du type d'écran choisi dans ce formulaire.
Négociation de langues

  Si un document existe en différentes langues et que votre serveur est configuré pour faire une négociation de langue, vous pouvez utiliser ce menu pour entrer vos préférences de langue (La première a la plus grande priorité). Essayez de naviguer ce communiqué, qui existe en versions Française, Anglaise et Japonaise. En changeant la négociation de la langue en code ISO pour les langues ci dessus (fr, en, ou ja) vous pouvez demander de façon transparente n'importe laquelle de ces versions.

### Préférences de publication

Cette boîte de dialogue vous permet d'enregistrer vos préférences pour les ETAGS et pré-conditions, pour vérifier ou non chaque commande PUT avec une commande GET, pour définir un nom par défaut pour les URLs finissant par un '/' et pour autoriser la redirection automatique de la commande PUT dans des domaines spécifiques.

Charset pour les nouveaux documents
  Définit le charset (groupe de caractères) utilisé pour les nouveaux documents.
Utiliser le type MIME application/xhtml+xml pour les documents XHTML
  Lorsqu'elle est active, cette option associe le nouveau (et officiel) type MIME XHTML à tout nouveau document XHTML publié sur le Web. Elle est désactivé par défaut pour cette version d'Amaya car à l'heure actuelle, tous les serveurs ne gèrent pas ce type MIME. Cette option ne modifie pas le type MIME des anciens documents: le type MIME qui est reçu est celui qui sera utilisé pour publier le document, sauf si vous utilisez la commande Sauver comme. Il est à noter que cette option nécessite aussi de modifier la configuration de votre serveur si celui-ci n'enregistre pas les méta-données associées à chaque document.
Utiliser les ETAGS et les conditions requises
  HTTP/1.1 introduit des nouvelles entêtes qui permettent d'éviter le problème de la perte des mises à jour en publiant. Avec ce mécanisme, vous pouvez détecter les conflits quand deux utilisateurs publient le même document.
Vérifie chaque PUT avec un GET
  Si vous n'avez pas confiance en votre serveur, cette option dit à Amaya de rétablir chaque document dès qu'il a été publié et le compare à la copie stockée dans votre station de travail. Si les documents diffèrent, Amaya vous alertera.
Exporter CR/LF (Windows uniquement)
  Indique si les fins de lignes des fichiers produits par Amaya se terminent par CR/LF (format DOS) ou par un simple LF (format standard).
Nom par dé faut pour les URLs finissant par '/'
  Un serveur HTTP associe habituellement les URLs qui finissent par '/' à un nom par défaut, par exemple, Overview.html. Cette option permet la spécification du nom par défaut qu'Amaya devrait utiliser quand on publiera un tel URL. S'il vous plaît, consultez votre Webmaster pour découvrir quel est le nom par défaut de votre serveur.
Permettre des redirections PUT automatiques sur ces domaines
  Selon la spécification HTTP/1.1, les opérations PUT ne devraient pas être redirigées automatiquement sans confirmation de l'utilisateur, puisque ça peut changer les conditions sous lesquelles la requête est d'origine. Vous pouvez éviter d'avoir un avertissement d'Amaya avec une alerte de redirection PUT en entrant le nom du domaine du serveur de publication. Vous pouvez spécifier un ou plusieurs domaines, chacun séparé d'un espace, par exemple, `www.w3.org groucho.marx.edu`.

### Préférences de cache

Amaya fournit un cache par l'intermédiaire de la libwww. Par défaut, le cache est activé et est stocké dans le répertoire AmayaTemp/libwww-cache. Ce menu fournit également un bouton Nettoyage du Cache, pour effacer le répertoire du cache.

Activer le cache
  Active ou désactive le cache
Cache des documents protégés
  Par défaut, les documents qui sont protégés par un mot de passe sont stockés dans le cache. Utiliser ce drapeau pour passer outre ce comportement.
Mode déconnecté
  Récupère toujours les documents depuis le cache.
Ignorer les expirations : entête
  Ignore les dates d'expiration des entrées de cache.
Répertoire du cache
  Donne le répertoire parent pour le répertoire libwww-cache. Le fait de changer ce répertoire n'effacera pas le contenu du précédant. Vous aurez à le supprimer vous même.
  Note : On ne peut pas utiliser des répertoires NFS (Network File System) pour le répertoire du cache en raison de leurs mécanismes de verrouillage. Utiliser un répertoire 'local' pour le cache.
Taille du cache
  Donner la taille, en megabytes, du dépôt du cache.
Taille limite de l'entrée du cache
  Donne la taille maximum d'entrée d'un cache.

### Préférences du proxy

Vous pouvez spécifier un proxy et une série de domaines où le proxy devrait ou ne devrait pas être utilisé par le biais de ce menu.

Proxy HTTP
  Donnes le proxy qui devrait être utilisé pour les requêtes HTTP. Vous devez spécifier le nom du serveur en entier. Si le serveur est en train de fonctionner sur un port autre que 80, alors, comme un URL, vous devez ajouter un caractère ":" au nom du proxy, suivi par le numéro du port.

  Par exemple :

        groucho.marx.edu

  déclare un proxy appelé groucho.marx.edu fonctionne par défaut sur le port 80, et

        groucho.marx.edu:1234

  déclare un proxy appelé groucho.marx.edu, fonctionnant sur le port 1234

Liste du domaine proxy
  Donne une liste des domaines séparés par des espaces pour lesquels vous utilisez votre proxy. Par exemple :

      harpo.marx.edu zeppo.marx.edu chico.marx.edu
                    ^--------------^----> entrées séparées par des espaces

  Utilisez le menu pour spécifier si le proxy doit ou ne doit pas être utilisé avec cette liste de domaines.

### Préférences des couleurs

Ce menu permet la sélection des couleurs du premier plan et de l'arrière plan par défaut pour les documents. Il permet également de contrôler les couleurs utilisées par Amaya pour visualiser la sélection courante.

- Couleur du point d'insertion donne la couleur du premier plan qui montre la sélection quand elle est limitée à un point d'insertion.
- Sélection de la couleur donne la couleur de l'arrière plan qui montre la sélection courante quand elle est étendue.

La version Unix fournit également des entrées pour changer les couleurs des menus. Pour changer les couleurs des menus sur Windows, vous avez besoin d'utiliser le contrôle de configuration standard de Windows, se trouvant dans le répertoire `Control Panel`.

Toutes ces couleurs peuvent être sélectionnées par leur nom, leur code hexadécimal, ou leur format rgb :

- Les noms valides sont : Aqua, Black, Blue, Fuschia, Gray, Green, Lime, Maroon, Navy, Olive, Purple, Red, Silver, Teal, yellow, et White.
- Le format hexadécimal valide est #FF00FF par exemple.
- Le format rgb valide est rgb(255, 0, 255) par exemple.

Si vous entrez une couleur invalide, les couleurs par défaut seront utilisées à la place.

Sur Windows, vous pouvez également sélectionner des couleurs par le biais de la palette de couleur.

Note : le changement des couleurs sera effectif quand vous ouvrirez une nouvelle fenêtre de document ou quand vous téléchargerez un document.

Le moyen de fixer ou de changer les couleurs des liens, des liens visités et des liens activés est donné dans la feuille de style Amaya.css

### Les préférences de géométrie

Ce menu vous permet de sauver la position de la fenêtre courante et la taille des différentes vues d'un document (formatée, structure, alterné, liens, and Table des Matières.) ou pour restaurer les valeurs par défaut. Notez que les valeurs qui sont sauvées appartiennent aux vues du document d'où vous appelez le menu. Ces changements seront effectifs quand vous ouvrirez des nouvelles fenêtres document.