home *** CD-ROM | disk | FTP | other *** search
/ GameStar 2005 May / Gamestar_73_2005-05_dvd.iso / Programy / amaya / amaya-Win98-8.7.3.exe / _SETUP.1 / the_saveas_command.html < prev    next >
Encoding:
Extensible Markup Language  |  2003-04-11  |  8.3 KB  |  188 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.   <meta name="GENERATOR" content="amaya 7.2, see http://www.w3.org/Amaya/" />
  7.   <title>The Save As Command</title>
  8.   <style type="text/css">
  9.   </style>
  10.   <link href="../style.css" rel="stylesheet" type="text/css" />
  11. </head>
  12.  
  13. <body xml:lang="en" lang="en">
  14.  
  15. <table border="0" width="100%" summary="toc">
  16.   <tbody>
  17.     <tr>
  18.       <td><img alt="W3C" src="../../images/w3c_home" /> <img alt="Amaya"
  19.         src="../../images/amaya.gif" /></td>
  20.       <td><p align="right"><a href="the_save_command.html" accesskey="p"><img
  21.         alt="previous" src="../../images/left.gif" /></a> <a
  22.         href="../Publishing.html" accesskey="t"><img alt="top"
  23.         src="../../images/up.gif" /></a> </p>
  24.       </td>
  25.     </tr>
  26.   </tbody>
  27. </table>
  28.  
  29. <div id="page_body">
  30. <h1>The Save As Command</h1>
  31.  
  32. <p>Choosing <strong>Save As</strong> from the <strong>File</strong> menu
  33. opens the <strong>Save As</strong> dialog, where you can: save the document
  34. as XML, HTML, or as a text file to a local disk or a remote URI; save
  35. embedded images into the same document directory or a different location; and
  36. transform embedded URIs.</p>
  37.  
  38. <h2>The Save As Dialog</h2>
  39.  
  40. <p>The items in the dialog box, from top to bottom, left to right are used as
  41. follows:</p>
  42. <ul>
  43.   <li>The <strong>Document format</strong> offers a choice between
  44.     <strong>HTML</strong>, <strong>XML</strong> (XHTML) and
  45.     <strong>Text</strong> for HTML documents. This submenu is not shown when
  46.     saving a SVG, a MathML, a CSS, or any other document type. By default,
  47.     Amaya keeps the current document format. The entry <strong>Text</strong>
  48.     removes the HTML mark-up and replaces it by spaces, newlines, and so on. 
  49.     <p></p>
  50.   </li>
  51.   <li>The <strong>Document location</strong> field indicates where the file
  52.     is to be written. This can be a file in the local file system (for
  53.     example, <code>/pub/html/welcome.html</code>) or the name of a remote URI
  54.     (for example, <code>http://www.w3.org/pub/WWW/Welcome.html</code>). 
  55.     <p></p>
  56.     <p class="Note"><strong>Note:   </strong><span
  57.     xml:lang="EN" lang="EN"
  58.     style="font-weight:normal">Use</span><strong><span></span></strong>a
  59.     complete path for the URL. You should also make sure that you have the
  60.     rights to do a <code>PUT</code>method if it is a remote location. Refer
  61.     to the page on <a
  62.     href="http://www.w3.org/Amaya/User/Put.html">configuring your server to
  63.     accept the PUT method</a> or ask your Web administrator.</p>
  64.     <p></p>
  65.   </li>
  66. </ul>
  67. <ul>
  68.   <li>The <strong>Copy Images</strong> toggle indicates whether the images
  69.     embedded in the current document must be copied along with the document
  70.     to the new location. It's generally better to keep this switch on as
  71.     otherwise you will not be sure that the corresponding images will be
  72.     found when opening the document later. However, switching it off is
  73.     useful when you have only changed the text of the document and the
  74.     document is stored on the same server. When images are copied, Amaya will
  75.     automatically update all <strong>SRC</strong> attributes to point new
  76.     image locations. New locations will be relative URIs. 
  77.     <p></p>
  78.   </li>
  79.   <li>The <strong>Transform URIs</strong> toggle transforms all current URIs
  80.     into relative URIs when possible. Of course, if the document is saved in
  81.     a local file and URIs point to remote files, URIs will be absolute. This
  82.     ensures that all the links in the document remain correct after the copy.
  83.     However, if you have several document linked together with relative URIs
  84.     and you plan to move them to a remote location, you must disable URI
  85.     conversion to avoid referencing the initial locations. 
  86.     <p></p>
  87.   </li>
  88.   <li>The <strong>Images location</strong> field allows you to save images
  89.     (if <strong>Copy Images</strong> has been selected) to a different place
  90.     than the HTML file. This field should contain the name of a directory on
  91.     the local file system or a location on the remote server. 
  92.     <p></p>
  93.     <ul>
  94.       <li>Using a relative path, the images are stored at a location relative
  95.         to the document directory. For example, if the document location is
  96.         <code><a
  97.         href="http://www.w3.org/pub/WWW/Welcome.html">http://www.w3.org/pub/WWW/Welcome.html</a><a
  98.         href="http://www.w3.org/pub/WWW/Welcome.html"></a></code> and the
  99.         images location is "Images", an image "W3C.png" contained in the
  100.         document is stored at the URI <code><a
  101.         href="http://www.w3.org/pub/WWW/Images/W3C.png">http://www.w3.org/pub/WWW/Images/W3C.png</a></code>
  102.         and the HTML file is modified to reference it as: 
  103.         <p></p>
  104.         <p><code><img src="Images/W3C.png"></code></p>
  105.         <p></p>
  106.         <p>This is similar in the case of a document location on the local
  107.         file system.</p>
  108.         <p></p>
  109.       </li>
  110.       <li>Using an absolute path, the images are stored at this exact
  111.         location, independently of the document location. In the previous
  112.         example, if the specified images location is
  113.         <code>http://pub/WWW/Images</code>, the image is stored at
  114.         <code>http://www.w3.org/pub/WWW/Images/W3C.png</code> and the
  115.         corresponding HTML file is modified in the following way: 
  116.         <p></p>
  117.         <p><code><img src="Images/W3C.png"></code></p>
  118.       </li>
  119.     </ul>
  120.   </li>
  121. </ul>
  122.  
  123. <p>Several buttons are at the bottom:</p>
  124. <ul>
  125.   <li>Clicking <strong>Confirm</strong> starts the process of transforming
  126.     the document. A dialog asks for confirmation in both of the following
  127.     cases: 
  128.     <ul>
  129.       <li>The document has to be saved on a remote server. Amaya displays the
  130.         complete URI to be written to for verification.</li>
  131.       <li>The document has to be saved locally and the file already exists. 
  132.         <p></p>
  133.       </li>
  134.     </ul>
  135.   </li>
  136.   <li>When saving to a remote location, check that the http_proxy is not set,
  137.     or that the proxy server and the <a
  138.     href="http://www.w3.org/Amaya/User/Put.html">target server are configured
  139.     to work with the PUT</a> method. 
  140.     <p></p>
  141.   </li>
  142.   <li>Amaya does not currently contact the remote server (in case of an
  143.     <code>http://...</code> destination) to check whether such a document
  144.     already exists. 
  145.     <p></p>
  146.   </li>
  147.   <li>Clicking <strong>Browse</strong> lets you select a local directory and
  148.     file name: 
  149.     <ul>
  150.       <li>The <strong>Document directories</strong> field shows the
  151.         directories contained in the current directory. It should be used to
  152.         save a file on the local file system.</li>
  153.       <li>The <strong>Files</strong> field shows the files contained in the
  154.         current local directory. 
  155.         <p></p>
  156.       </li>
  157.     </ul>
  158.   </li>
  159.   <li>Clicking <strong>Clear</strong> removes the current contents of both
  160.     the <strong>Document location</strong> field and the <strong>Images
  161.     location</strong> field. 
  162.     <p></p>
  163.   </li>
  164.   <li>Clicking <strong>Change Charset</strong> opens a pop-up window that
  165.     enables you to change the charset of the document. This option only works
  166.     with documents that support the notion of charset, such as HTML and XML
  167.     ones. This option is available when saving both remote and local
  168.     documents. 
  169.     <p></p>
  170.   </li>
  171.   <li>Clicking <strong>Change Mime Type</strong> opens a pop-up window where
  172.     you can select the MIME type of the document. If the MIME type you're
  173.     looking for is not listed, you can type it in yourself. This button is
  174.     only active when saving a document to a server (local file systems don't
  175.     store the MIME metadata information.). 
  176.     <p></p>
  177.   </li>
  178.   <li>Clicking <strong>Cancel</strong> terminates the command.</li>
  179. </ul>
  180.  
  181. <h2>See also:</h2>
  182. <ul>
  183.   <li><a href="the_save_command.html">The Save Command</a></li>
  184. </ul>
  185. </div>
  186. </body>
  187. </html>
  188.