Publishing in Amaya
Currently Amaya does not offer a complete publishing solution,
as there is
no support for managing links between different HTML pages located on the same
server. Amaya neither provide any global view of the set of pages
installed on
a server. However it is possible to configure the action of saving files to a
remote server. Remote saving can be accessed in two way, through the
Save and SaveAs commands.
The Save command
The save command can be invoked either by choosing Save
from the File menu 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. If one need to save newly added images
to a different location, the SaveAs 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.
- saving to local disk
- saving to a remote URL
- copy images embedded in the document
- transform embedded URLs to asbolute one
- save images to a different location
Notice that for saving a document to a remote URL, you must have the right
to execute a PUT method on the remote machine. The WWW server has to be
explicitely configured to accept input from your machine or some
authentification mecanism will be involved. See the page on configuring your server to accept the PUT method or ask
your Web administrator to do so.
Here is a dump of the Save As dialog box:

The items in the dialog box, from top to bottom, letf 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 directory.
- The Copy Images toggle indicates whether the images
embbeded in the current document must be copied along with the document to the
new location. It's generally better to let this switch on since otherwise you
are not 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 when a remote mirror has to be updated.
- The Transform URLs toggle transforms all relative URLs
contained in the document to absolute ones (i.e. containing the full document
location). This ensures that all the links in the document remain correct
after the copy. However if you have several document linked together with
relative URLs and that you plan to move them to a remote location, disabling
URL 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 URL (e.g.
"http://www.w3.org/pub/WWW/Welcome.html").
Note that this should be a complete path, there is no way
actually to guess what would be 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 URL
"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,
independantly of the document location. In the previous example, if the images
location specified is "/pub/WWW/Img", the image is stored at
"http://www.w3.org/pub/WWW/Img/W3C.png" and the corresponding HTML file is
modified in the following way:
<IMG SRC="/pub/WWW/Img/W3C.png">
Moreover, it is possible to indicate a full URL like
"http://www.w3.org/pub/WWW/Img" and the SRC attribute of all images will
contain an absolute URL.
- Clicking on OK starts the process of transforming the
document and a popup asks for confirmation, showing all the URL to be written
to.
Note that Amaya does not currently contact the
remote server (in case of an "http://..." destination) to check whether such a
document already exists.
Notes :
D. Veillard
Webmaster
$Date: 1997/01/06 17:31:42 $