Amaya

## Naviguer

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

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. Si le document initial a été modifié mais pas sauvé, un dialogue s'affiche pour pouvoir sauver ce document avant qu'il disparaisse.

  Si vous avez choisi un profil sans navigation, ou si vous êtes dans les pages d'aide, le document cible s'ouvre dans un nouvel 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 (un menu s'affiche pour vous offrir ce choix).

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 `Maj-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.

### Accès rapides

L'auteur d'une page HTML peut associer un attribut `accesskey` aux champs de formulaire, aux zones activables, ou aux liens. Plus précisément, les éléments suivants acceptent cet attribut : `a`, `area`, `button`, `input`, `label`, `legend`, et `textarea`.

Si l'auteur du document a associé un attribut `accesskey` à un lien (par exemple `accesskey="l"`) dans un document, la commande `Alt-accesskey` (dans cet exemple `Alt-l`) active le lien (sur MacOS X, la touche `Ctrl` est utilisée à la place de `Alt`). 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`). Ceci est important pour les utilisateurs qui ne peuvent pas manipuler une souris, mais il y a d'autres conditions où c'est nécessaire ou utile.

Les accès rapides supplantent les raccourcis clavier de Amaya, mais pas ceux du système. Les raccourcis des menus, notamment, sont prioritaires.

À titre d'exemple ces pages d'Aide déclarent les accès rapides suivants :

- "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 utilisée pour les accès rapides est `Alt` (`Ctrl` sur MacOS X). Le menu de préférences Préférences/Général permet de changer cela. Vous pouvez utiliser la touche `Ctrl` au lieu de `Alt`. Vous pouvez aussi désactiver le mécanisme des accès rapides fondés sur `accesskey`.

### 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 du document courant, qui est une option du menu Affichage. 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. 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.

### 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 de navigation
  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.

Si vous avez choisi un profil sans navigation, ou si vous êtes dans les pages d'aide, ces commandes ne sont pas disponibles.

### 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 de navigation.

Si vous avez choisi un profil sans navigation, ou si vous êtes dans les pages d'aide, cette commande n'est pas disponible.

### 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 `Entrée` 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. On peut aussi utiliser la touche `Tab` pour se positionner sur le menu, puis la combinaison `Alt-↑` pour l'activer. Cela fait apparaître la liste de toutes les entrées du menu. Cette liste est ensuite utilisable avec la souris ou avec le clavier.

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 `Entrée`. Vous pouvez annuler toute action en appuyant sur la touche `Échap` à 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, vous devez cliquer n'inporte où en dehors de la liste affichée.

### 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 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.