## Naviguer et Éditer

Amaya est essentiellement un éditeur ayant des capacités de navigation. Lorsqu'il est utilisé comme navigateur, il se comporte comme beaucoup d'autres navigateurs du Web, excepté pour ce qui est d'activer les liens. Lors d'une opération normale, Amaya vous permet de naviguer et d´éditer des documents simultanément, mais vous pouvez changer ce comportement standard pour chaque fenêtre de document indépendamment. Le bouton indique que la fenêtre est en mode éditeur : vous pouvez éditer le document courant et naviguer dans cette fenêtre. En cliquant sur ce bouton, vous faites passer la fenêtre en mode navigation. Le bouton prend ainsi cette représentation et vous pouvez seulement naviguer et remplir les formulaires. cette option est également disponible à partir de l'option Mode Editeur du menu d'Édition, ou bien par le raccourci clavier (Shift-Control-* par défaut).

Amaya vous permet d'acceder et d'éditer des documents HTML ainsi que certains types de documents XML : XHTML, MathML et SVG. Il vous permet d'acceder (en lecture seulement) aux autres types de documents XML, de visualiser leur contenu et d'interpréter les feuilles de style CSS associées.

Les documents HTML sont lus par défaut comme des fichiers ISO-latin-1. Sans information sur le "charset" dans l'en-tête HTTP ou dans un élément META, un document HTML est considéré comme encodé en ISO-latin-1. Les documents XML sont lus par défaut comme des fichiers UTF 8. Quand il n'y a pas d'information sur le "charset" dans l'en-tête HTTP, dans la déclaration XML, ou dans un élément META, un document XML est considéré comme encodé en UTF 8. Comme les encodages par défaut de HTML et de XML sont différents, il arrive souvent que des auteurs aient créé des documents XML ISO-latin-1 qui ne fournissent pas d'information sur l'encodage. Dès qu'un caractère analysé par le parseur XML ne correspond pas à un caractère UTF 8 valide (cela doit arriver si le document est encodé en ISO-latin-1 mais lu comme un fichier UTF 8), le document est considéré comme incorrect: le parseur s'arrête and un message d'erreur est affiché. Ce message propose soit de recharger le document comme un document HTML, soit de montrer les erreurs. Dans ce dernier cas, la commande "Reparser en HTML" est activée. Cette commande vous permet de re-ouvrir le document avec le "charset" correspondant à l'ISO-latin-1. Le document est maintenant considéré comme modifié (un charset a été ajouté) and peut être sauvé.

Amaya interprète les entités caractères. Quand il ne dispose pas du caractère correspondant, il affiche un '?' (ou il affiche le nom de l'entité lorsqu'elle figure dans un attribut ou quand elle est inconnue). Lorsque le document est sauvé, ces entités caractères sont restaurées, sauf si le document est codé en ISO Latin-1 et que l'entité correspond à un caractère ISO Latin-1. Dans ce cas c'est simplement le code ISO Latin 1 du caractère qui est sauvé. Si l'encodage du document est l'ASCII, Amaya convertit en entités les caractères ISO Latin-1 qui n'existent pas en ASCII.

### Activer un lien

Les liens sont habituellement présentés en bleu (ou soulignés en noir et blanc). Comme Amaya est un éditeur, vous devez effectuer un double-clic sur un lien pour l'activer. Un simple-clic place seulement le point d'insertion à l'intérieur du lien et affiche l'URI complète du lien dans la barre d'état de la fenêtre principale.

Ce comportement par défaut peut être modifié ainsi que d'autres paramètres par l'intermédiaire du menu Spécial/Préférences/Générales. En modifiant "cliquer deux fois pour suivre un lien", vous pourrez naviguer de document en document à l'aide d'un simple-clic. Dans ce cas, vous ne pouvez pas mettre aisément le point d'insertion à l'intérieur des liens : vous devez soit utiliser une sélection étendue soit déplacer le point d'insertion à l'intérieur des liens à l'aide des flèches. Il est également possible d'utiliser le clavier pour activer les liens, ainsi que les formulaires de contrôles. La commande au clavier est Alt-Enter par défaut, mais la commande DoAction peut être associée à un autre raccourci clavier. La commande NextLinkOrFormElement, associée par défaut au raccourci clavier Tab, vous permet de trouver le prochain (ou le premier) lien ou élément de formulaire HTML dans le document. La commande PreviousLinkOrFormElement, associée par défaut au raccourci clavier Shift-Tab, vous permet de trouver le lien ou élément de formulaire HTML qui précède (ou le dernier) dans le document.

Le document récupéré par cette opération remplace le document courant dans la même fenêtre et conserve le mode (éditeur ou navigateur). Si le document courant a été modifié et n'a pas encore été sauvegardé, Amaya affiche une fenêtre de dialogue qui demande si vous acceptez de perte les modifications.

Un simple-clic ou un double-clic avec le bouton droit de la souris (cela marche aussi avec le bouton du milieu sur Windows) ouvre le document cible dans une autre fenêtre.

### Accès rapides

Un auteur peut associer un attribut `acceskey` à un champ de formulaire, une zone activable, ou un lien. Les éléments suivants supportent cet attribut: AREA, BUTTON, INPUT, LABEL, LEGEND, et TEXTAREA. Ceci peut être crucial pour les personnes avec des handicaps moteur, mais il y a d'autres conditions où c'est nécessaire ou utile.

Si l'auteur du document a associé un attribut `accesskey` au lien (par exemple `acceskey="a"`) dans un document, la commande Alt-accesskey (par exemple Alt-a) va activer le lien. Quand elle est assignée à un élément de formulaire, la commande Alt-accesskey donne le focus à cet élément (le suivant dans le cas de LABEL et LEGEND).

Les accès rapides supplantent les raccourcis clavier de Amaya. Par exemple les pages d'Aide déclarent des accès rapides : "n" pour aller à la page suivante, "p" pour aller à la page précédente, "t" pour la table des matières. Si l'utilisateur a associé un raccourci clavier Alt-p à une commande d'édition de Amaya, ce raccourci clavier ne sera pas accessible quand ces pages d'aide sont affichées. Par défaut la touche de modification utilisée est Alt. Le menu de préférences `Special/Preferences/General` permet de modifier cette configuration par défaut. L'utilisateur peut utiliser la touche Control au lieu de Alt et peut décider de désactiver la prise en compte des accès rapides.

### Ancres cibles

Certaines parties du texte peuvent être affichées avec une icône en forme de cible . Ces icônes ne font pas partie du document et peuvent donc être soit visualisées soit cachées juste en modifiant le statut Montrer les cibles de la fenêtre courante, qui est une option du menu Vues. Par défaut la commande au clavier est Control-v Contol-t sur Unix, Alt-v Alt-l sur Windows.

Ces icônes sont associées aux éléments cibles, i.e. éléments avec un attribut `ID` , ou aux ancres cibles, i.e. ancres avec un attribut `name`. Elles identifient les cibles possibles pour les liens. Ces icônes sont destinées à rendre la création de liens plus facile. En effet, le fait de pouvoir reconnaître rapidement la cible possible d'un lien, permet de créer des liens plus vite.

### Ouverture de documents

Vous pouvez ouvrir des documents locaux ou distants de différentes façons :

Menu Fichier

  Deux entrées à partir du menu Fichier, Ouvrir et Ouvrir dans nouvelle fenêtre, vous permettent respectivement d'ouvrir un nouveau document dans la même fenêtre ou dans une nouvelle fenêtre. Les commandes clavier par défaut sont respectivement Control-x Contol-f et Control-x Control-o sur Unix, Control-o et Shift-Control-O sur Windows. Ces deux commandes font apparaître une boîte de dialogue dans laquelle vous pouvez entrer un nom de fichier local ou une URI. Vous pouvez également choisir un fichier à partir de l'option Butiner qui vous propose un sélecteur de fichiers locaux.

  Quand le document est correctement spécifié, cliquez sur le bouton Confirmer. Cette commande peut aussi être utilisée pour créer un nouveau document local.

Ligne de commande "Ouvrir"
  Cette zone affiche le nom du fichier ou l'URI du document courant. Vous pouvez saisir le nom d'un autre document spécifié (local ou distant) qui va être affiché dans la même fenêtre. Tapez sur la touche Enter quand le curseur se trouve dans cette zone pour rendre le chargement du document effectif. Cette commande peut aussi être utilisée pour créer un nouveau document local.
Liens suivants
  Activer un lien pour obtenir le document correspondant.

### Aller en arrière et en avant

Il existe différentes manières de se déplacer dans l'historique des pages chargées :

Menu Fichier
  Il y a des entrées dans le menu Fichier pour avancer ou reculer. Les raccourcis clavier sont par défaut respectivement Alt-b et Alt-f sur Unix, Control-b et Shift-Control-F sur Windows.
Barre des boutons
  Deux boutons : et vous permettent de retourner à la page précédente ou d'aller à la page suivante.

### Recharger une page

Les documents peuvent être rechargés en utilisant l'option Recharger le document du menu Fichier, le raccourci clavier Alt-r sur Unix et Control-r sur Windows, ou le bouton de la barre des boutons.

### Contrôle du clavier

Amaya fournit un contrôle pour associer des commandes clavier à de nombreuses fonctions. Les commandes clavier par défaut sont fournies à leurs places appropriées dans la documentation. La section d'aide sur Configurer Amaya décrit comment changer les valeurs par défaut, et les raccourcis clavier sont affichés à côté des entrées auxquelles ils sont associés.

Pour les utilisateurs familiers de Emacs un fichier de configuration `Amaya/config/amaya.emacs` est disponible. L'utilisateur peut donc créer un lien depuis son espace privé `$HOME/.amaya/amaya.keyboard` vers ce fichier s'il veut disposer des raccourcis clavier à la Emacs.

Quelques touche du clavier sont pré-affectée, comme :

- La touche Enter dans un élément de formulaire `input` (de type `text` ou `password`) soumet le formulaire correspondant.
- La touche Tab dans un élément de formulaire déplace la sélection sur l'élément de formulaire suivant, ou saute au premier élément de formulaire du formulaire courant.

### Formulaires

Comme Amaya est à la fois un navigateur et un éditeur, certains widgets utilisés pour les éléments HTML form sont différents de ceux utilisés dans les navigateurs seuls. Cette section répertorie les différences les plus significatives.

## Formulaire sélecteur input, sélection simple (GTK et WIN32)

Pour activer ce sélecteur, l'utilisateur doit cliquer deux fois sur l'entrée. Cela fait apparaître un popup listant toutes les entrées. Ce popup est ensuite utilisable soit avec le clavier, soit avec la souris.

Avec le clavier, vous devez au préalable selectionner une entrée grâce aux touches flèches puis valider avec la touche Entrée. Les touches PageUp et PageDown permettent de faire défiler plus rapidement la liste des entrées. Vous pouvez annuler l'action de ce popup en appuyant sur la touche Escape à n'importe quel moment.

Avec la souris, il y a deux types de comportement. Un simple clic permet à l'utilisateur de selectionner une entrée tandis qu'un double clic sur une entrée signifie que l'utilisateur veut activer la selection. Vous pouvez utiliser l'ascenseur pour naviguer plus rapidement dans la liste des entrées. Pour annuler l'action du popup, vous devez cliquer n'inporte où en dehors du popup (NB, cette option n'est pas encore opérationnelle sous GTK).

## Formulaire sélecteur input, sélection multiple

Le comportement de ce widget est similaire au précédent en ce qu'il supporte seulement un basculement d'état de sélection à la fois. Vous devez l'appeler autant de fois que vous devez changer l'état d'une sélection. Lorsque ce widget est activé, il montre l'état courant des sélections, en concaténant un caractère '>' aux entrées sélectionnées (Win32) ou par l'utilisation d'une barre de couleur bleue (GTK). Comme pécédemment, vous pouvez annuler l'action de ce widget soit en utilisant la touche Escape soit en cliquant à l'extérieur du widget (Win32 uniquement).