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 deacribes the Publishing menu commands. In addtion, 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 button. This command saves the current document to the location it was fetched from. Newly added images are saved in the same directory 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. This is very useful at browsing time, but it is not supported by the put method. 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:

• save the document to a local disk,
• save the document to a remote URI,
• save images embedded in the document in the document directory or a different location,
• transform embedded URIs,

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

• The Document directories selector shows the directories contained in the current directory. It should be used to save a file on the local file system.
• The Files selector shows the files contained in the current local directory.
• The HTML, XML and Text toggles are exclusive. The default is HTML and you have to change it, if you want to produce an XML (Voyager) or a text format of the current document.
• The Copy Images toggle indicates whether the images embedded in the current document must be copied along with the document to the new location. It's generally better to keep this switch on as otherwise you will not be sure that the corresponding images will be found when opening the document later. However switching it off is useful when you have only changed the text of the document and the document is stored on the same server. When images are copied, Amaya will automatically update all SRC attributes to point new image locations. New locations will be relative URIs.
• The Transform URIs toggle transforms all current URIs into relative URIs when it's possible. Of course, if the document is saved in a local file and URIs point to remote files, URIs will be absolute ones. This ensures that all the links in the document remain correct after the copy. However if you have several document linked together with relative URIs and that you plan to move them to a remote location, disabling URI conversion is needed to avoid referencing the initial locations.
• The Document location field indicates the location where the HTML file has to be written. This can be a file in the local filesystem (e.g. "/pub/html/welcome.html") or the name of a remote URI (e.g. "http://www.w3.org/pub/WWW/Welcome.html").

  Note that this should be a complete path as there is no way to guess the name of "http://www.w3.org/pub/WWW". You should also make sure that you have the right to do a PUT method in the case of a remote location. See the page on configuring your server to accept the PUT method or ask your Web administrator.

• The Images location field allows you to save images (if Copy Images has been selected) to a different place than the HTML file. This field should contain the name of a directory in the local filesystem or a location in the remote server.
  • using a relative path, the images is stored at a location relative to the document directory. For example, if the document location is "http://www.w3.org/pub/WWW/Welcome.html" and the images location is "Images", an image "W3C.png" contained in the document is stored at the URI "http://www.w3.org/pub/WWW/Images/W3C.png" and the HTML file is modified to reference it as:

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

    This is similar in the case of a document location in the local filesystem.

  • using an absolute path, the images are stored at this exact location, independently of the document location. In the previous example, if the images location specified is "http://pub/WWW/Images", the image is stored at "http://www.w3.org/pub/WWW/Images/W3C.png" and the corresponding HTML file is modified in the following way:

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

• Clicking on OK starts the process of transforming the document and a popup asks for confirmation in both of the following cases:
  1. The document has to be saved on a remote server. The complete URI to be written to is displayed for verification.
  2. The document has to be saved locally and the file already exists.

  Notes :

  • When saving to a remote location please check that the http_proxy is not set, or that the proxy server and the target server are configured to work with the PUT method.

  • Amaya does not currently contact the remote server (in case of an "http://..." destination) to check whether such a document already exists.

Saving documents as text

The Save As command from the Edit menu displays a dialog box that allows you to save the current document in various formats. Clicking the Text button from the Output Format menu saves the document in text form, in a local file. A list of all URIs used in the document is appended to that file.