## Sauver et Publier des documents

Amaya permet de sauver les documents soit en HTML soit en format texte.

Il est possible d'accéder aux sauvegardes lointaine et locale peuvent être accéder de deux façons, grâce aux commandes Sauver et Sauver comme.

Cette section manuelle décrit les commandes du menu de publication. En plus, il existe un nombre d'options de configuration que vous pouvez changer par l'intermédiaire du menu de configuration.

### Sauver des documents en HTML

Amaya ne fournit aucune vue d'ensemble de série de pages installées sur le serveur. Cependant il est possible de sauver des fichiers d'un serveur lointain comme des fichiers locaux grâce aux commandes Sauver et Sauver comme. Pendant ces opérations, Amaya tient compte des images.

#### La commande sauver

La commande sauver peut être invoquée soit en choisissant Sauver depuis le menu Fichier (control-s pour Windows, control-x, control-s pour Unix) ou bien en cliquant sur le bouton . Cette commande sauve le document courant à l'adresse d'où il a été amené. Si la réponse du serveur inclut l'en-tête HTTP `Content-Location`, la cible de la sauvegarde sera l'URL précisée par cet en-tête. Ceci est utile pour enlever les ambiguïtés induites par la négociation du contenu. Par exemple, soient report.html.fr et report.html.en deux versions d'un même document, une écrite en français, l'autre en anglais. De même, on utilisera l'URL virtuelle report.html pour référencer ce document. En fonction de la configuration du client, le serveur retournera soit un ou l'autre document lors de la consultation de l'URL report.html. Si le serveur supporte l'en-tête `Content-Location`, il indiquera dans celle-ci l'URL du document qu'il a actuellement servi, par exemple, report.html.fr. Dans ce cas, la sauvegarde du document sera faite vers cette URL en préférence de l'URL virtuel report.html.

Les images nouvellement ajoutées sont sauvées dans le même répertoire que celui du document et aucune confirmation n'est demandée, excepté si le nom du document est inconnu. Les serveurs permettent aux utilisateurs d'importer un document quand seul le nom du serveur ou le répertoire du serveur ont donné. C'est très utile au moment de la navigation, mais ça n'est pas supporté par la méthode "PUT". Dans ce cas, Amaya détecte que le nom du document manque et propose d'utiliser un nom par défaut pour répondre à la demande. Notez que l'utilisation de l'en-tête`Content-Location` permet de s'affranchir de ce problème.

Si quelqu'un a besoin de sauver des images nouvellement ajoutées dans un autre endroit, la commande Sauver comme devra être utilisée à la place.

#### La commande Sauver comme

Le fait de sélectionner l'entrée Sauver comme dans le menu Fichier ouvre une boîte de dialogue qui vous permet de sauver le document courant à une adresse différente, un serveur Web lointain ou un fichier local.

Vous pouvez :

- sauver le document sur un disque local,
- sauver le document sur un URI lointain,
- sauver des images dans le répertoire du document ou à une adresse différente,
- transformer les URIs dans le document,

Les choix dans la boîte de dialogue, de haut en bas, de gauche à droite sont utilisés comme suit :

- Le Format de document propose le choix entre HTML, XML (XHTML) et Text pour les documents HTML. Ce sous-menu n'est pas proposé quand on sauve un document SVG, MathML, CSS ou tout autre type. Par défaut Amaya conserve le format courant du document. Le format Text (voir plus bas) supprime les balises HTML et les remplace par des espaces, sauts de lignes, etc.
- Le champ Adresse du document indique l'adresse où le fichier HTML a été écrit. Ce peut être un fichier dans le système du fichier local (par exemple "/pub/html/welcome.html") ou le nom d'un URI lointain (par exemple "http://www.w3.org/pub/Welcome.html").

  Notezque vous devrez donner le chemin complet comme si il n'y avait aucun moyen de deviner le nom de "http://www.w3.org/pub". Vous devrez également vous assurer que vous avez le droit d'exécuter une méthode PUT dans le cas d'une adresse lointaine. Regardez la page configurez votre serveur pour permettre la méthode PUT ou demander à votre administrateur Web.

- Le choix Copier les Images indique que les images importées dans le document courant doivent être copiées avec le document à une nouvelle adresse. Il vaut mieux généralement garder ce bouton actif, autrement vous ne serez pas sûr que les images correspondantes seront trouvées en ouvrant le document ultérieurement. Cependant, le rendre inactif est utile quand vous avez changé uniquement le texte du document et que le document est stocké sur le même serveur. Quand les images seront copiées, Amaya mettra à jour automatiquement tous les attributs SRC pour pointer vers de nouvelles adresses d'images. Les nouvelles adresses seront des URIs relatifs.
- Le choix Transformer les URIs transforme tous les URIs courants en URIs relatifs quand c'est possible. Bien sûr, si le document est sauvé dans un fichier local et si les URIs pointent sur des fichiers lointains, les URIs resteront absolus. Ceci assure que tous les liens dans le document restent corrects après la copie. Cependant, si vous avez plusieurs documents reliés aux URIs relatifs et que vous avez l'intention de les déplacer vers une adresse lointaine, la désactivation de la conversion en URI est nécessaire afin d'éviter le référencement des adresses initiales.
- Le champ Répertoire des images vous permet de sauver des images (si Copier les Images a été sélectionné) à un autre endroit que le fichier HTML. Ce champ devrait contenir le nom d'un répertoire dans le système de fichier local ou une adresse dans le serveur lointain.
  - en utilisant un chemin relatif, les images sont stockées à une adresse relative au répertoire du document. Par exemple, si l'adresse du document est "http://www.w3.org/pub/Welcome.html" et que l'adresse des images est "Images", une image "W3C.png" contenue dans le document est stockée à l'URI "http://www.w3.org/pub/Images/W3C.png" et le fichier HTML est modifiée le référant à :

    <IMG SRC="Images/W3C.png">

    C'est la même chose dans le cas d'une adresse dans le fichier système local.

  - en utilisant un chemin absolu, les images sont stockées à cette adresse exacte, indépendamment de l'adresse du document. Dans l'exemple précédent, si l'adresse des images spécifiée est "http://pub/Images", l'image est stockée à l'adresse "http://www.w3.org/pub/Images/W3C.png" et le fichier HTML correspondant est modifié de la manière suivante :

    <IMG SRC="Images/W3C.png">

Il y a une liste de boutons en bas :

- Le fait de cliquer sur Confirmer débute le processus de transformation du document et un événement demande confirmation dans les deux cas suivants :
  1. Le document a été sauvé sur un serveur lointain. L'URI complet qui doit être écrit est visualisé pour vérification.
  2. Le document doit être sauvé localement et le fichier existe déjà.

  Notes :

  - Quand on sauve à une adresse lointaine, s'il vous plaît vérifiez que le proxy http n'est pas mis, ou que le serveur proxy et le serveur cible sont configurés pour travailler avec la méthode PUT.
  - Amaya ne contacte pas le serveur lointain (dans le cas d'une destination "http://..." destination) pour contrôler si un tel document existe déjà.
- En cliquant sur Butiner l'utilisateur peur choisir le répertoire et le fichier de sauvegarde :
  - Le sélecteur Répertoires montre les répertoires contenus dans le répertoire courant. Il devrait être utilisé pour sauver un fichier sur le système de fichier local.
  - Le sélecteur des Fichiers montre les fichiers contenus dans le répertoire local courant.
- Le bouton RAZ annule le contenu des champs Adresse du document et Répertoire des images.
- Le bouton Changer Charset permet de changer le charset du document. En activant ce bouton, un dialogue apparaîtra dans l'écran vous proposant une liste des charsets disponibles. Notez que cette option n'est pas valable que pour les documents supportant la notion de charset, tels que les fichiers HTML ou XML. Cette option est valable pour la sauvegarde locale et distante d'un document.
- Le bouton Changer le type MIME permet de changer le type MIME d'un document lors d'une sauvegarde sur un serveur distant. En activant ce bouton, un dialogue apparaîtra vous proposant un certain nombre de types MIME. Vous pourrez également saisir un type MIME diffèrent de ceux qui sont proposés..
- Le bouton Annuler avorte la commande.

### Sauver des documents en tant que textes

La commande Sauver comme du menu Fichiervisualise une boîte de dialogue permettant de sauver le document courant dans des formats différents.Le bouton Text du menu Format de document sauve le document sous forme de texte, dans un fichier local. Les balises HTML sont remplacées par des espaces, sauts de lignes, etc. La liste de tous les URIs utilisés dans le document est listées dans ce fichier.