## Naviguer avec Amaya

Amaya est essentiellement un éditeur avec des capacités de navigation. Il vous permet de naviguer et d´éditer des documents simultanément. Lorsqu'il est utilisé comme navigateur, il se comporte comme beaucoup d'autres navigateurs Web, excepté pour l'activation les liens et pour l'utilisation des formulaires.

Amaya vous permet d'afficher et d'éditer des documents HTML ainsi que certains types de documents XML : XHTML, MathML (expressions mathématiques) et SVG (graphique). Il vous permet aussi d'accéder aux autres types de documents XML et de visualiser leur contenu selon les feuilles de style CSS qui leur sont associées. Pour ces documents, quelques fonctions d'édition sont disponibles.

### Activer un lien, parcourir les liens

Les liens sont par défaut présentés en bleu. Comme Amaya est un éditeur, vous obtiendrez un résultat différent avec un simple-clic, un double-clic, ou un clic-droit sur un lien.

- Un `simple-clic` place seulement le point d'insertion à l'intérieur du lien, pour que vous puissiez modifier le texte, et il affiche l'URI complète du lien dans la barre d'état en bas de la fenêtre.
- Un `double-clic` active le lien et se place sur la cible. Le document cible remplace le document courant dans le même onglet.
- Un `clic-droit` (ou `Cmd + simple-clic` sur MacOS X) active le lien et ouvre le document cible dans un nouvel onglet ou une nouvelle fenêtre. Le document origine reste ouvert dans le premier onglet. Vous pouvez choisir d'ouvrir le document cible dans un nouvel onglet ou une nouvelle fenêtre en mettant l'option correspondante dans les Préférences de Navigation (voir le menu Editer > Préférences).

Ce comportement par défaut peut être modifié, ainsi que d'autres paramètres, par l'intermédiaire du menu Édition/Préférences/Navigation. 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 touches flèche du clavier.

Il est également possible d'utiliser le clavier pour parcourir les liens et les activer. La touche `Tab`, vous permet de trouver le prochain lien ou élément de formulaire HTML dans le document. La commande `Shift Tab`, vous permet de trouver le lien ou élément de formulaire HTML qui précède dans le document. La commande `Alt ↓` vous permet d'activer le lien courant. Vous pouvez choisir d'autres touches ou combinaisons de touches pour toutes ces commandes.

Le document chargé par l'activation d'un lien remplace le document courant dans la même fenêtre. Si le document courant a été modifié et n'a pas encore été sauvegardé, Amaya affiche un dialogue qui demande si vous acceptez de perdre les modifications ou si vous souhaitez sauver le document avant de suivre le lien.

Un clic avec le bouton droit de la souris (cela marche aussi avec le bouton du milieu sur Windows) ouvre le document cible dans un autre onglet ou une autre fenêtre, selon l'option choisie dans les préférences (Édition/Préférences/Navigation).

### Accès rapides

L'auteur d'une page HTML peut associer un attribut `accesskey` à un champ de formulaire, une zone activable, ou un lien. Les éléments suivants supportent cet attribut : A, AREA, BUTTON, INPUT, LABEL, LEGEND, et TEXTAREA. Ceci est important pour les utilisateurs qui ne peuvent manipuler une souris, mais il y a d'autres conditions où c'est nécessaire ou utile.

Si l'auteur du document a associé un attribut `accesskey` à un lien (par exemple `accesskey="a"`) dans un document, la commande Alt accesskey (par exemple Alt a) va activer le lien. Quand elle est associée à un élément de formulaire, la commande Alt accesskey donne le focus à cet élément (ou l'élément qui suit 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 les accès rapides :

- "n" pour aller à la page d'aide suivante,
- "p" pour aller à la page d'aide précédente,
- "t" pour aller à la table des matières.

Si vous avez associé un raccourci clavier `Alt p` à une commande d'édition de Amaya, ce raccourci clavier ne sera pas utilisable quand les pages d'aide sont affichées.

Par défaut la touche de modification utilisée pour les accès rapides est Alt. Le menu de préférences Éditer/Préférences/Général permet de changer cela. L'utilisateur peut utiliser la touche Control au lieu de Alt et peut décider de désactiver le mécanisme 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 être soit visualisées soit cachées juste en modifiant le statut Montrer les cibles de l'onglet courant, qui est une option du menu Vues. Par défaut la commande au clavier est `Ctrl u Ctrl t`.

Ces icônes sont associées aux éléments cibles, c'est-à-dire aux éléments, quel que soit leur type, qui ont un attribut `ID` , ou aux ancres cibles, c'est-à-dire aux éléments a qui ont un attribut `name`. Elles identifient les cibles possibles pour les liens hypertexte. 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.

### Ouvrir un document

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

Menu Fichier

  L'entrée Ouvrir du menu Fichier vous permet d'ouvrir un nouveau document. La commande clavier par défaut est `Ctrl o Ctrl o` . Vous pouvez aussi cliquer avec le bouton droit de la souris sur l'onglet d'un document ouvert et choisir l'entrée Ouvrir du menu qui s'affiche. Cette commande fait 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 en utilisant les sélecteurs de fichiers locaux disponibles en haut de cette boîte de dialogue.

  Quand le document est correctement spécifié, cliquez sur le bouton Ouvrir.

  Cette commande peut aussi être utilisée pour créer un nouveau document local, en spécifiant le nom d'un fichier qui n'existe pas encore.

Explorateur de fichiers
  Un explorateur de fichiers est affiché en haut de la fenêtre d'Outils. Cet outil donne accès à tous les répertoires locaux. Un simple clic permet d'ouvrir ou de fermer un répertoire et un double clic sur un nom de fichier ouvre le document correspondant.
Adresse du document courant
  Une zone affiche en haut de la fenêtre le nom du fichier ou l'URI du document courant. Vous pouvez saisir le nom d'un autre document (local ou distant) qui va être affiché à la place du document courant. Tapez sur la touche Enter quand le curseur se trouve dans cette zone pour activer le chargement du document. Cette commande peut aussi être utilisée pour créer un nouveau document local, en entrant le nom d'un fichier qui n'existe pas encore.

  Le bouton à la droite de cette zone affiche la liste des derniers documents chargés. Vous pouvez choisir un document dans cette liste. Ce document vient alors remplacer le document courant.

Liens hypertexte
  En activant un lien vous chargez le document correspondant.

Note sur le codage des caractères

Les documents HTML sont chargés 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 codé en ISO-latin-1. Les documents XML (y compris XHTML) 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 codé en UTF 8. Comme les codages par défaut de HTML et de XML sont différents, il arrive souvent que des auteurs aient créé des documents XML codés en ISO-latin-1 qui ne fournissent pas d'informations explicites sur leur codage. Dès qu'un caractère analysé par Amaya ne correspond pas à un caractère UTF 8 valide (cela doit arriver si le document est codé en ISO-latin-1 mais lu comme un fichier UTF 8), le document est considéré comme incorrect: le traitement s'arrête et un message d'erreur est affiché. Ce message propose soit de recharger le document comme un document HTML, soit de montrer les erreurs. Dans le premier cas, le document est rechargé avec le "charset" correspondant à l'ISO-latin-1. Le document est maintenant considéré comme modifié (un charset a été ajouté) et 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 le document est codé en ASCII, Amaya convertit en entités les caractères ISO Latin-1 qui n'existent pas en ASCII.

### 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 (Suivant) ou reculer (Précédent) dans l'historique. Les raccourcis clavier sont par défaut respectivement `Alt <-` et `Alt ->`.
Barre des boutons
  Deux boutons : et vous permettent de retourner à la page précédente ou d'aller à la page suivante.

Notez que chaque onglet a son propre historique.

### Recharger une page

Les documents peuvent être rechargés en utilisant l'option Recharger le document du menu Fichier, le raccourci clavier `Ctrl r`, ou le bouton de la barre des boutons.

### Commandes au clavier

Amaya fournit un mécanisme pour associer des commandes clavier à de nombreuses fonctions. Les commandes clavier par défaut sont indiquées dans la documentation. La section d'aide Configurer Amaya décrit comment changer les valeurs par défaut.

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 de raccourcis clavier à la Emacs.

Quelques touches du clavier sont pré-affectées, 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.

## Utiliser les formulaires

Certains widgets utilisés par Amaya dans les formulaires HTML (les éléments form) sont différents de ceux utilisés dans les navigateurs courants. Cela vient du fait qu'Amaya doit permettre à la fois la création et l'utilisation des formulaires. Cette section indique les différences les plus significatives.

### Menus simples

Pour utiliser un menu comme celui qui suit ce paragraphe, il faut cliquer deux fois sur l'entrée affichée (ici, "pomme") ou sur le bouton à droite. Cela fait apparaître un popup listant toutes les entrées du menu. Ce popup est ensuite utilisable avec le clavier ou avec la souris.

Avec le clavier, passez d'une entrée à l'autre avec les touches flèches puis sélectionnez l'entrée courante avec la touche Enter. Vous pouvez annuler l'action de ce popup en appuyant sur la touche `Esc` à n'importe quel moment.

Avec la souris, il y a deux types de comportement. Un simple clic permet de sélectionner une entrée tandis qu'un double clic sur une entrée signifie que vous voulez activer cette entrée. Avec les menus très longs, vous pouvez utiliser l'ascenseur pour vous déplacer rapidement dans la liste des entrées. Pour annuler l'action du popup, vous devez cliquer n'inporte où en dehors du popup.

### Menus à sélection multiple

Certains menus, comme celui qui suit ce paragraphe, autorisent la sélection de plusieurs entrées. Leur comportement est similaire à celui d'un menu simple mais le fait d'agir sur une entrée avec la touche Enter ou en cliquant avec la souris fait basculer l'état de cette entrée : si elle était sélectionnée elle ne l'est plus et inversement.