W3C Amaya

previous top next

Saving and Publishing documents

Amaya allows you to save documents either in HTML or as text format.

Remote and local saving can be accessed in two ways, through the Save and SaveAs commands.

This manual section describes the Publishing menu commands. In addition, there are a number of configuration options related to Amaya that you may change through the Configuration menu.

Saving documents in HTML

Amaya does not provide any global view of the set of pages installed on a server. However it is possible to save files to a remote server as to local files through the Save and SaveAs commands. During these operations, Amaya takes images into account.

The Save command

The save command can be invoked either by choosing Save from the File menu (control-s in Windows, control-x, control-s in Unix) or by clicking on the floppy button. This command saves the current document to the location it was fetched from. If the server's replies includes an n HTTP Content-Location header, the target of the save will be the URL given as the value of this header. This is useful when doing content negotation. For example, let report.html.fr and report.html.en be two versions of the same page, the first written in French and the second in English. Also, let all the links to this page will be given as report.html. In function of the client's language preferences, the server will return either report.html.fr or report.html.en, transparently to the user when browsing html.fr. If the server supports the Content-Location header, it will give set its value to the URL that was actually served bac, for example, report.html.fr. In this case, if you save your page, it will be saved to this URL, rather than to the virtual URL report.html.

Newly added images are saved in the same directory as that of the document and no confirmation is asked except if the document name is unknown. Servers allow users to fetch a document when only the server name or the server directory name is given. Note that it won't be possible to save to such a URL if the server doesn't send back a Content-Location header, as you need to explicitly specify the URL of the resource you want to save. In this case, Amaya detects that the document name is missing and proposes to use a default name or to complete the request.

If one needs to save newly added images to a different location, the Save As command should be used instead.

The Save As command

Selecting the Save As entry in the File menu opens a dialog box that allows you to save the current document to a different location, a remote Web server or the local file system. You can:

SaveAs

The items in the dialog box, from top to bottom, left to right are used as follows:

There is a list of buttons at the bottom:

Saving documents as text

The Save As command from the File menu displays a dialog box that allows you to save the current document in various formats. Clicking the Text button from the Document format menu saves the document in text form, in a local file. The HTML mark-up is replaced by spaces, newlines, etc. A list of all URIs used in the document is appended to that file.

previous top next