Amaya

## Créer et ouvrir des documents

### Créer un document

Amaya vous permet ce créer de nouveaux documents locaux ou distants. Trois types de documents sont disponibles :

- Nouveau document, pour saisir une page de texte, avec des liens ou des formules, etc.
- Nouvelle formule, pour créer une expression mathématique isolée
- Nouvelle feuille de style, pour créer une feuille de style CSS

Pour créer un document :

1. Choisissez l'entrée Nouveau du menu Fichier et sélectionnez le type de document désiré.
2. Amaya vous demande alors de spécifier l'URI ou le nom local du document à créer (un nom par défaut est affecté si aucun nom n'est spécifié). Un sélecteur de fichier vous permet de trouver le répertoire voulu et de vérifier les fichiers qui existent déjà.
3. Choisissez l'emplacement où le nouveau document doit s'ouvrir : onglet courant, nouvel onglet ou nouvelle fenêtre.
4. Quand un nouveau document XHTML est créé :
   - Quand le titre du document est requis, Amaya engendre un titre par défaut (le nom du fichier sans suffixe). Ce titre pourra être modifié ultérieurement par la commande Outils/Changer le titre.
   - Si vous prévoyez d'utiliser un modèle, cliquez sur le bouton A partir du modèle et sélectionnez un des modèles, soit en sélectionnant dans la liste des modèles enregistrés ou en tapant l'URI ou le nom du fichier du modèle qui n'est pas dans la liste. Vous pouvez mettre à jour la liste des modèles dans Préférences/Modèles
   - Il est possible de spécifier le Profil du document créé (XHTML Transitional, XHTML 1.1, XHTML strict, XHTML basic, HTML transitional, Compound document). Vous pouvez laisser Amaya choisir pour vous.

     Si vous prévoyez de créer un document XHTML composé (Compound document) incluant des éléments MathML ou SVG, il est recommandé de créer un fichier avec un suffixe `.xml`.

5. Sélectionnez un Codage pour encoder le texte du document. Attention si vous prévoyez de publier le document sur un serveur, ce Codage doit être choisi en accord avec le serveur Web qui va délivrer le document.
   Habituellement les pages `.html` sont servies avec `iso-8859-1` and les pages `.xml` sont servies avec `utf-8`.
6. Confirmez avec le bouton Créer. Amaya crée un nouveau document contenant l'élément racine correspondant au type choisi.

### 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` . 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 le sélecteur de fichiers locaux (cliquez sur l'icone de fichier en haut à droite de cette boîte de dialogue).
  Quand le document est correctement spécifié, cliquez sur le bouton Ouvrir.

  Vous pouvez aussi utiliser le bouton à droite de la zone de saisie du nom de fichier. Il affiche la liste des fichiers ouverts récemment avec Amaya. Chosissez dans cette liste celui que vous voulez ouvrir.

  La commande Ouvrir 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 peut être affiché dans la fenêtre d'Outils par la commande Affichage / Barres d'outils / Fichiers. 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 `Entrée` 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.

  Notez que cette possibilité n'est offerte que si vous avez choisi un profil incluant l'option Navigation.

Liens
  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. Si un caractère analysé par Amaya ne correspond pas à un caractère UTF 8 valide (cela arrive 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.