Amaya enables you to save (X)HTML documents either in (X)HTML or text format. Other documents (SVG, MathML or CSS) are saved according to their original format. You can save both remote and local documents in two ways, using the Save and Save As commands.
In addition, you can change a number of Amaya publishing options using the Publishing Preferences dialog. You open this dialog by choosing Preferences > Publishing from the Edit menu.
Amaya does not provide any global view of a set of pages installed on a server. However, you can save files to a remote server in the same way you save local files, using the Save and Save As commands. During these operations, Amaya also saves any newly added images.
The Save command saves the current document to the original location. You can access the Save command by choosing Save from the File menu, clicking the Save button on the button bar, or by using keyboard shortcuts Ctrl s. Newly added images are saved in the same directory automatically; confirmation is only requested when the document name is unknown.
You can also fetch a document from servers by specifying the server directory name. This is very useful when browsing, but is not supported by the put method. In this case, Amaya detects that the document name is missing and asks you either to use a default name or to complete the request.
Note: Use the Save As command to save your document to a different location.
Choosing Save As from the File menu opens the Save As dialog, where you can: save the document as XML, HTML, or as a text file to a local disk or a remote URI; save embedded images into the same document directory or a different location; and transform embedded URIs.
The items in the dialog box, from top to bottom, left to right are used as follows:
/pub/html/welcome.html
) or the name of a remote URI
(for example, http://www.w3.org/pub/WWW/Welcome.html
).
Note: Usea
complete path for the URL. You should also make sure that you have the
rights to do a PUT
method if it is a remote location. Refer
to the page on configuring your server to
accept the PUT method or ask your Web administrator.
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 on the local file system.
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">
Four buttons complete this dialog:
When saving to a remote location, 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
.
Three standard encodings are considered:
us-ascii
is a 7-bit code that represents 96 printable
characters (positions 32 through 127 decimal).iso-8859-1
is a 8-bit code that represents the same
characters as us-ascii
, at the same positions, plus 95
additional printable characters.utf-8
is a variable length encoding scheme for the
Universal Character Set - UCS (ISO10646 aka Unicode). UCS represents
thousands of characters. Note that the 96 first characters have the same
positions in UCS as in us-ascii
(and then as in
iso-8859-1
).If an XML or HTML document contains a character that is not available in the character set (charset) available with the encoding, a special representation is required. XML offers two such representations of characters:
α
(hexadecimal) or
α
(decimal)α
Character references may be used in any XML or HTML document, but entity references are allowed only if the document itself contains a means to resolve the name.
Entity name resolution is provided by the Document type definition which
refers to the DTD where names and their associated contents are defined.
Practically, this means that you can use entity references only if the
<!DOCTYPE ...>
is present and refers to a DTD that defines
the names you use.
With that in mind, it is easier to understand how Amaya works. By default, Amaya preserves the initial encoding of the document, that is the encoding that was associated with the document at loading time. You can check this encoding with command File/Document Information (Charset field). The Save command saves the document with that encoding, while the Save As command allows you to choose another encoding (Charset field).
When saving a document (Save or Save As
commands), all characters that are available in the charset of the encoding
are just written using the encoding. Only the other characters are written
using character or entity references. The choice between these two options is
made according to the doctype
. If there is a
doctype
that refers to a DTD that defines a name for the
character, an entity reference is used (i.e. a name), otherwise Amaya
generates a character reference in hexadecimal.
Note: the File/Change The Document Type
command allows you to associate, to change or to remove the
doctype
of a document at any time. This allows you to generate
either character references or entity references.
You san save your document as text using the Save As command from the File menu. HTML mark-up is replaced by spaces, new lines, and so on. A list of all URIs used in the document is appended to the file.
To save your document as text: