home *** CD-ROM | disk | FTP | other *** search
/ PC World 2001 April / PCWorld_2001-04_cd.bin / Komunik / Amaya / WinNT2000 / amaya-WindowsNT-4.3.exe / _SETUP.1 / Publishing.html < prev    next >
Encoding:
Extensible Markup Language  |  2001-02-22  |  8.9 KB  |  184 lines
  1. <?xml version="1.0" encoding="iso-8859-1"?>
  2. <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  3.     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
  4. <html xmlns="http://www.w3.org/1999/xhtml">
  5. <head>
  6.   <title>Publishing</title>
  7.   <meta name="GENERATOR" content="amaya V4.2.2" />
  8.   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
  9. </head>
  10.  
  11. <body xml:lang="en" lang="en">
  12.  
  13. <table border="0" width="100%" summary="toc">
  14.   <tbody>
  15.     <tr>
  16.       <td><p><img border="0" alt="W3C" src="../../Icons/WWW/w3c_home" /> <img
  17.         border="0" alt="Amaya" src="../Icons/amaya.gif" /></p>
  18.       </td>
  19.       <td><p align="right"><a href="SpellChecking.html" accesskey="p"><img
  20.         alt="previous" border="0" src="../Icons/left.gif" /></a> <a
  21.         href="Manual.html" accesskey="t"><img alt="top" border="0"
  22.         src="../Icons/up.gif" /></a> <a href="Printing.html"
  23.         accesskey="n"><img alt="next" border="0" src="../Icons/right.gif"
  24.         /></a></p>
  25.       </td>
  26.     </tr>
  27.   </tbody>
  28. </table>
  29.  
  30. <div id="Saving">
  31. <h2><a name="L1052">Saving and Publishing documents</a></h2>
  32.  
  33. <p>Amaya allows you to save documents either in HTML or as text format.</p>
  34.  
  35. <p>Remote and local saving can be accessed in two ways, through the
  36. <strong>Save</strong> and <strong>SaveAs</strong> commands.</p>
  37.  
  38. <p>This manual section describes the Publishing menu commands. In addtion,
  39. there are a number of configuration options related to Amaya that you may
  40. change through the <a href="Configure.html#Publishing">Configuration
  41. menu</a>.</p>
  42.  
  43. <h3><a name="L1104">Saving documents in HTML</a></h3>
  44.  
  45. <p><b>Amaya</b> does not provide any global view of the set of pages installed
  46. on a server. However it is possible to save files to a remote server as to
  47. local files through the <strong>Save</strong> and <strong>SaveAs</strong>
  48. commands. During these operations, Amaya takes images into account.</p>
  49.  
  50. <h4><a name="L1517">The Save command</a></h4>
  51.  
  52. <p>The save command can be invoked either by choosing <strong>Save</strong>
  53. from the <strong>File</strong> menu (control-s in Windows, control-x,
  54. control-s in Unix) or by clicking on the <img alt="floppy"
  55. src="../Icons/floppy.gif" align="middle" border="0" /> button. This command
  56. saves the current document to the location it was fetched from. Newly added
  57. images are saved in the same directory and no confirmation is asked except if
  58. the document name is unknown. Servers allow users to fetch a document when
  59. only the server name or the server directory name is given. This is very
  60. useful at browsing time, but it is not supported by the put method. In this
  61. case, Amaya detects that the document name is missing and proposes to use a
  62. default name or to complete the request.</p>
  63.  
  64. <p>If one needs to save newly added images to a different location, the
  65. <strong>Save As</strong> command should be used instead.</p>
  66.  
  67. <h4><a name="L1518">The Save As command</a></h4>
  68.  
  69. <p>Selecting the <strong>Save As</strong> entry in the <strong>File</strong>
  70. menu opens a dialog box that allows you to save the current document to a
  71. different location, a remote Web server or the local file system. You can:</p>
  72. <ul>
  73.   <li>save the document to a local disk,</li>
  74.   <li>save the document to a remote URI,</li>
  75.   <li>save images embedded in the document directory or a different
  76.   location,</li>
  77.   <li>transform embedded URIs,</li>
  78. </ul>
  79.  
  80. <p><img src="../Icons/SaveAs.gif" alt="SaveAs" /></p>
  81.  
  82. <p>The items in the dialog box, from top to bottom, left to right are used as
  83. follows:</p>
  84. <ul>
  85.   <li>The <strong>Document directories</strong> selector shows the directories
  86.     contained in the current directory. It should be used to save a file on
  87.     the local file system.</li>
  88.   <li>The <strong>Files</strong> selector shows the files contained in the
  89.     current local directory.</li>
  90.   <li>The <strong>HTML</strong>, <strong>XML</strong> and
  91.     <strong>Text</strong> toggles are exclusive. The default is HTML and you
  92.     have to change it, if you want to produce an XML (Voyager) or a text
  93.     format of the current document.</li>
  94.   <li>The <strong>Copy Images</strong> toggle indicates whether the images
  95.     embedded in the current document must be copied along with the document to
  96.     the new location. It's generally better to keep this switch on as
  97.     otherwise you will not be sure that the corresponding images will be found
  98.     when opening the document later. However switching it off is useful when
  99.     you have only changed the text of the document and the document is stored
  100.     on the same server. When images are copied, Amaya will automatically
  101.     update all <strong>SRC</strong> attributes to point new image locations.
  102.     New locations will be relative URIs.</li>
  103.   <li>The <strong>Transform URIs</strong> toggle transforms all current URIs
  104.     into relative URIs when it's possible. Of course, if the document is saved
  105.     in a local file and URIs point to remote files, URIs will be absolute.
  106.     This ensures that all the links in the document remain correct after the
  107.     copy. However if you have several document linked together with relative
  108.     URIs and that you plan to move them to a remote location, disabling URI
  109.     conversion is needed to avoid referencing the initial locations.</li>
  110.   <li>The <strong>Document location</strong> field indicates the location
  111.     where the HTML file has to be written. This can be a file in the local
  112.     filesystem (e.g. "/pub/html/welcome.html") or the name of a remote URI
  113.     (e.g. "http://www.w3.org/pub/WWW/Welcome.html"). 
  114.     <p><strong>Note</strong> that this should be a complete path as there is
  115.     no way to guess the name of "http://www.w3.org/pub/WWW". You should also
  116.     make sure that you have the <strong>right to do a PUT</strong> method in
  117.     the case of a remote location. See the page on <a
  118.     href="http://www.w3.org/Amaya/User/Put.html">configuring your server to
  119.     accept the PUT method</a> or ask your Web administrator.</p>
  120.   </li>
  121.   <li>The <strong>Images location</strong> field allows you to save images (if
  122.     <strong>Copy Images</strong> has been selected) to a different place than
  123.     the HTML file. This field should contain the name of a directory in the
  124.     local filesystem or a location in the remote server. 
  125.     <ul>
  126.       <li>using a relative path, the images is stored at a location relative
  127.         to the document directory. For example, if the document location is
  128.         "http://www.w3.org/pub/WWW/Welcome.html" and the images location is
  129.         "Images", an image "W3C.png" contained in the document is stored at
  130.         the URI "http://www.w3.org/pub/WWW/Images/W3C.png" and the HTML file
  131.         is modified to reference it as: 
  132.         <p><IMG SRC="Images/W3C.png"></p>
  133.         <p>This is similar in the case of a document location in the local
  134.         filesystem.</p>
  135.       </li>
  136.       <li>using an absolute path, the images are stored at this exact
  137.         location, independently of the document location. In the previous
  138.         example, if the images location specified is "http://pub/WWW/Images",
  139.         the image is stored at "http://www.w3.org/pub/WWW/Images/W3C.png" and
  140.         the corresponding HTML file is modified in the following way: 
  141.         <p><IMG SRC="Images/W3C.png"></p>
  142.       </li>
  143.     </ul>
  144.   </li>
  145.   <li>Clicking on <strong>OK</strong> starts the process of transforming the
  146.     document and a popup asks for confirmation in both of the following cases:
  147.     
  148.     <ol>
  149.       <li>The document has to be saved on a remote server. The complete URI to
  150.         be written to is displayed for verification.</li>
  151.       <li>The document has to be saved locally and the file already
  152.       exists.</li>
  153.     </ol>
  154.     <p><strong>Notes</strong> :</p>
  155.     <ul>
  156.       <li>When saving to a remote location please check that the http_proxy is
  157.         not set, or that the proxy server and the <a
  158.         href="http://www.w3.org/Amaya/User/Put.html">target server are
  159.         configured to work with the PUT</a> method.</li>
  160.       <li><p><b>Amaya</b> does not currently contact the remote server (in
  161.         case of an "http://..." destination) to check whether such a document
  162.         already exists.</p>
  163.       </li>
  164.     </ul>
  165.   </li>
  166. </ul>
  167.  
  168. <h3><a name="L1105">Saving documents as text</a></h3>
  169.  
  170. <p>The <strong>Save As</strong> command from the <strong>File</strong> menu
  171. displays a dialog box that allows you to save the current document in various
  172. formats. Clicking the <strong>Text</strong> button from the <strong>Output
  173. Format</strong> menu saves the document in text form, in a local file. A list
  174. of all URIs used in the document is happended to that file.</p>
  175. </div>
  176.  
  177. <p align="right"><a href="SpellChecking.html"><img alt="previous" border="0"
  178. src="../Icons/left.gif" /></a> <a href="Manual.html"><img alt="top" border="0"
  179. src="../Icons/up.gif" /></a> <a href="Printing.html"><img alt="next"
  180. border="0" src="../Icons/right.gif" /></a></p>
  181. <hr />
  182. </body>
  183. </html>
  184.