home *** CD-ROM | disk | FTP | other *** search
/ PC World 2005 October / PCWorld_2005-10_cd.bin / komunikace / amaya / amaya-WinXP-9.2.1.exe / doc / WX / Configure.html < prev    next >
Encoding:
Extensible Markup Language  |  2005-02-24  |  30.5 KB  |  713 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 http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
  7.   <title>Configuring Amaya</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. <div>
  16. <img alt="Amaya" src="../../resources/icons/22x22/logo.png" class="logo" />
  17.  
  18. <p class="nav"><a href="bookmarks.html" accesskey="p"><img alt="previous"
  19. src="../../resources/icons/misc/left.png" /></a> <a href="Manual.html"
  20. accesskey="t"><img alt="top" src="../../resources/icons/misc/up.png" /></a>
  21. <a href="ShortCuts.html" accesskey="n"><img alt="next"
  22. src="../../resources/icons/misc/right.png" /></a></p>
  23. </div>
  24.  
  25. <div class="toc">
  26. <ul>
  27.   <li><a href="#Configurin">Configuring Amaya</a>
  28.     <ul>
  29.       <li><a href="#About">About Configuration Directory and File
  30.         Conventions</a>
  31.         <ul>
  32.           <li><a href="#config">The config Directory</a></li>
  33.           <li><a href="#AmayaHome">The AmayaHome Directory</a></li>
  34.           <li><a href="#AmayaTemp">The AmayaTemp Directory</a></li>
  35.         </ul>
  36.       </li>
  37.       <li><a href="#Menu">Menu Preferences</a>
  38.         <ul>
  39.           <li><a href="#General">General Preferences</a>
  40.             <ul>
  41.               <li><a href="#Check">Check boxes</a></li>
  42.               <li><a href="#Font">Font and language options</a></li>
  43.               <li><a href="#Access">Access keys</a></li>
  44.             </ul>
  45.           </li>
  46.           <li><a href="#Browsing">Browsing Preferences</a>
  47.             <ul>
  48.               <li><a href="#Opening">Opening location</a></li>
  49.               <li><a href="#Check1">Check boxes</a></li>
  50.               <li><a href="#Current">Current screen type</a></li>
  51.               <li><a href="#Language">Language Negotiation
  52.               Preferences</a></li>
  53.             </ul>
  54.           </li>
  55.           <li><a href="#Publishing">Publishing Preferences</a>
  56.             <ul>
  57.               <li><a href="#Charset">Charset for new documents</a></li>
  58.               <li><a href="#Check2">Check boxes</a></li>
  59.               <li><a href="#Default">Default name for URLs finishing in
  60.                 '/'</a></li>
  61.               <li><a href="#Allow">Allow automatic PUT redirections on these
  62.                 domains</a></li>
  63.             </ul>
  64.           </li>
  65.           <li><a href="#Cache">Cache Preferences</a>
  66.             <ul>
  67.               <li><a href="#Check3">Check boxes</a></li>
  68.               <li><a href="#Cache1">Cache directory</a></li>
  69.               <li><a href="#Cache2">Cache size</a></li>
  70.               <li><a href="#Cache3">Cache entry size limit</a></li>
  71.               <li><a href="#Flush">Flush cache</a></li>
  72.             </ul>
  73.           </li>
  74.           <li><a href="#Proxy">Proxy Preferences</a>
  75.             <ul>
  76.               <li><a href="#Proxy1">Proxy domain list</a></li>
  77.             </ul>
  78.           </li>
  79.           <li><a href="#Color">Color Preferences</a></li>
  80.           <li><a href="#Window">Window Geometry Preferences</a></li>
  81.           <li><a href="#Configurin1">Configuring Annotation Settings</a></li>
  82.           <li><a href="#Annotation">Annotation user</a></li>
  83.           <li><a href="#Annotation1">Annotation post server</a></li>
  84.           <li><a href="#Annotation2">Annotation servers</a>
  85.             <ul>
  86.               <li><a href="#Check4">Check boxes</a></li>
  87.             </ul>
  88.           </li>
  89.         </ul>
  90.       </li>
  91.     </ul>
  92.   </li>
  93. </ul>
  94. </div>
  95.  
  96. <div id="page_body">
  97. <h2 id="Configurin">Configuring Amaya</h2>
  98.  
  99. <p>Amaya uses different configuration files to get initial values for global
  100. parameters, dialogs, shortcuts, window size and position, user's style sheet,
  101. and so on. You can change most configuration parameters with various
  102. preferences menus.</p>
  103.  
  104. <h3 id="About">About Configuration Directory and File Conventions</h3>
  105.  
  106. <p>Amaya uses a number of default directories to store configuration
  107. information.</p>
  108.  
  109. <h4 id="config">The config Directory</h4>
  110.  
  111. <p>Amaya stores most of the default values and all of the dialog messages in
  112. the config directory. This directory's parent is the one in which Amaya was
  113. installed (the default is <code>Amaya/config</code> on Unix; see the table
  114. below for the location on Windows).</p>
  115.  
  116. <h4 id="AmayaHome">The AmayaHome Directory</h4>
  117.  
  118. <p>Amaya stores the user preferences and other user configuration files in a
  119. directory called AmayaHome. An existing directory could be selected by the
  120. user using the system environment variable <code>AMAYA_USER_HOME</code>.
  121. Otherwise Amaya selects a default position.</p>
  122.  
  123. <p>The following table shows the default position of this directory in
  124. different architectures:</p>
  125.  
  126. <table border="1" cellspacing="0">
  127.   <tbody>
  128.     <tr>
  129.       <td valign="top"
  130.       style="border:solid .5pt;   padding:0in 5.4pt 0in 5.4pt"><p
  131.         class="TableHead"><b>Architecture</b></p>
  132.       </td>
  133.       <td valign="top"
  134.       style="border:solid .5pt;   border-left:none;padding:0in 5.4pt 0in 5.4pt"><p
  135.         class="TableHead"><b>AmayaHome Directory Location</b></p>
  136.       </td>
  137.     </tr>
  138.     <tr>
  139.       <td valign="top"
  140.       style="border:solid .5pt;   border-top:none;padding:0in 5.4pt 0in 5.4pt"><p
  141.         class="TableText">Unix</p>
  142.       </td>
  143.       <td valign="top"
  144.       style="border-top:none;border-left:   none;border-bottom:solid .5pt;border-right:solid .5pt;   padding:0in 5.4pt 0in 5.4pt"><p
  145.         class="TableText"><code>$HOME/.amaya</code></p>
  146.       </td>
  147.     </tr>
  148.     <tr>
  149.       <td valign="top"
  150.       style="border:solid .5pt;   border-top:none;padding:0in 5.4pt 0in 5.4pt"><p
  151.         class="TableText">Windows 95/ Windows 98</p>
  152.       </td>
  153.       <td valign="top"
  154.       style="border-top:none;border-left:   none;border-bottom:solid .5pt;border-right:solid .5pt;   padding:0in 5.4pt 0in 5.4pt"><p
  155.         class="TableText"><code>AMAYA-INSTALL-DIR\users\username</code> <br />
  156.         or, if the user didn't login to Windows,
  157.         <code>AMAYA-INSTALL-DIR\users\default</code></p>
  158.       </td>
  159.     </tr>
  160.     <tr>
  161.       <td valign="top"
  162.       style="border:solid .5pt;   border-top:none;padding:0in 5.4pt 0in 5.4pt"><p
  163.         class="TableText">Windows NT/XP</p>
  164.       </td>
  165.       <td valign="top"
  166.       style="border-top:none;border-left:   none;border-bottom:solid .5pt;border-right:solid .5pt;   padding:0in 5.4pt 0in 5.4pt"><p
  167.         class="TableText"><code>$HOMEDRIVE:\$HOMEPATH\amaya</code><br />
  168.         by default <br />
  169.         c:\Documents and Settings\$user_name\amaya</p>
  170.       </td>
  171.     </tr>
  172.   </tbody>
  173. </table>
  174.  
  175. <p>This directory is preserved even when installing new versions of Amaya. It
  176. may contain the following files:</p>
  177. <ul>
  178.   <li><strong>thot.rc</strong>: Contains the user preferences, changed
  179.     through the <strong>Preferences</strong> submenus on the
  180.     <strong>Edit</strong> menu.</li>
  181.   <li><strong><a name="amaya.keyb"
  182.     id="amaya.keyb">amaya.keyboard</a></strong> (Unix) or
  183.     <strong>amaya.kb</strong> (Windows): Defines Amaya keyboard
  184.   shortcuts.</li>
  185.   <li><strong>amaya.css</strong>: Contains the user's style sheet.</li>
  186.   <li><strong>dictionary.DCT</strong>: Amaya provides a multilingual spell
  187.     checker. By default, the spell checker works with two dictionaries:
  188.     English and French (you can download other dictionaries from the <a
  189.     href="http://www.w3.org/Amaya/User/BinDist.html">W3C servers</a>). When
  190.     you want to register a new word, the spell checker creates or updates
  191.     this personal dictionary.</li>
  192. </ul>
  193.  
  194. <p class="Note"><strong>Note</strong>:<br />
  195. The <code>amaya.keyboard</code>, <code>amaya.kb</code>, and
  196. <code>amaya.css</code> files are loaded at launch time. If you change them,
  197. you must quit and restart Amaya to take the changes into account.</p>
  198.  
  199. <h4 id="AmayaTemp">The AmayaTemp Directory</h4>
  200.  
  201. <p>Amaya stores all the temporary files it creates in a directory called the
  202. AmayaTemp directory. The following table shows where this directory is stored
  203. within different architectures:</p>
  204.  
  205. <table border="1" cellspacing="0">
  206.   <tbody>
  207.     <tr>
  208.       <td valign="top"
  209.       style="border:solid .5pt;   padding:0in 5.4pt 0in 5.4pt"><p
  210.         class="TableHead"><b>Architecture</b></p>
  211.       </td>
  212.       <td valign="top"
  213.       style="border:solid .5pt;   border-left:none;padding:0in 5.4pt 0in 5.4pt"><p
  214.         class="TableHead"><b>AmayaTemp Directory</b></p>
  215.       </td>
  216.     </tr>
  217.     <tr>
  218.       <td valign="top"
  219.       style="border:solid .5pt;   border-top:none;padding:0in 5.4pt 0in 5.4pt"><p
  220.         class="TableText">Unix</p>
  221.       </td>
  222.       <td valign="top"
  223.       style="border-top:none;border-left:   none;border-bottom:solid .5pt;border-right:solid .5pt;   padding:0in 5.4pt 0in 5.4pt"><p
  224.         class="TableText"><code>$HOME/.amaya</code></p>
  225.       </td>
  226.     </tr>
  227.     <tr>
  228.       <td valign="top"
  229.       style="border:solid .5pt;   border-top:none;padding:0in 5.4pt 0in 5.4pt"><p
  230.         class="TableText">Windows 9x</p>
  231.       </td>
  232.       <td valign="top"
  233.       style="border-top:none;border-left:   none;border-bottom:solid .5pt;border-right:solid .5pt;   padding:0in 5.4pt 0in 5.4pt"><p
  234.         class="TableText"><code>c:\temp\amaya</code> (default value)</p>
  235.       </td>
  236.     </tr>
  237.     <tr>
  238.       <td>Window XP</td>
  239.       <td>$HOMEDRIVE\$HOMEPATH\LocaláDocumentsáandáSettings\Temp\amaya<br />
  240.         by default <br />
  241.         c:\Documents and Settings\$user_name\Local Settings\Temp\amaya</td>
  242.     </tr>
  243.   </tbody>
  244. </table>
  245.  
  246. <p>Amaya creates files in this directory when browsing or printing a
  247. document. The cache is also stored in this directory. You can change the
  248. cache directory by using the Cache preferences.</p>
  249.  
  250. <p>Amaya always tries to delete the temporary files it creates. However, if
  251. Amaya crashes, the temporary files are not deleted. This will not impact
  252. subsequent executions of Amaya.</p>
  253.  
  254. <h3 id="Menu">Menu Preferences</h3>
  255.  
  256. <p>These dialogs are found under the <strong>Preferences</strong> submenu on
  257. the <strong>Edit</strong> menu. Nine preferences dialogs are available:
  258. <strong>General</strong>, <strong>Browsing, Publishing</strong>,
  259. <strong>Cache</strong>, <strong>Proxy</strong>, <strong>Colors</strong>,
  260. <strong>Window geometry</strong>, <strong>Annotations, WebDAV</strong>.</p>
  261.  
  262. <p>Each of these dialogs contains three action buttons:</p>
  263.  
  264. <table border="1" cellspacing="0" cellpadding="0" width="581"
  265. style="width:435.75pt;  margin-left:3.75pt;border-collapse:collapse;border:none;">
  266.   <tbody>
  267.     <tr>
  268.       <td width="65"
  269.       style="width:48.75pt;border-top:solid .75pt;   border-left:none;border-bottom:double 1.5pt;border-right:solid black .5pt;   padding:3.75pt 3.75pt 3.75pt 3.75pt"><p
  270.         class="TableHead"><b>Button</b></p>
  271.       </td>
  272.       <td width="516"
  273.       style="width:387.0pt;border-top:solid .75pt;   border-left:none;border-bottom:double 1.5pt;border-right:none;padding:3.75pt 3.75pt 3.75pt 3.75pt"><p
  274.         class="TableHead"><b>Action</b></p>
  275.       </td>
  276.     </tr>
  277.     <tr>
  278.       <td width="65"
  279.       style="width:48.75pt;border-top:none;border-left:none;   border-bottom:solid black .5pt;border-right:solid black .5pt;padding:3.75pt 3.75pt 3.75pt 3.75pt"><p
  280.         class="TableText">Apply</p>
  281.       </td>
  282.       <td width="516"
  283.       style="width:387.0pt;border:none;border-bottom:solid black .5pt;   padding:3.75pt 3.75pt 3.75pt 3.75pt"><p
  284.         class="TableText">Validates and stores the options shown in the
  285.         menu.</p>
  286.       </td>
  287.     </tr>
  288.     <tr>
  289.       <td width="65"
  290.       style="width:48.75pt;border-top:none;border-left:none;   border-bottom:solid black .5pt;border-right:solid black .5pt;padding:3.75pt 3.75pt 3.75pt 3.75pt"><p
  291.         class="TableText">Defaults</p>
  292.       </td>
  293.       <td width="516"
  294.       style="width:387.0pt;border:none;border-bottom:solid black .5pt;   padding:3.75pt 3.75pt 3.75pt 3.75pt"><p
  295.         class="TableText">Restores, but does not save, the default values.
  296.         Use the <strong>Apply</strong> button to validate the options.</p>
  297.       </td>
  298.     </tr>
  299.     <tr>
  300.       <td width="65"
  301.       style="width:48.75pt;border-top:none;border-left:none;   border-bottom:solid 1.5pt;border-right:solid black .5pt;padding:3.75pt 3.75pt 3.75pt 3.75pt"><p
  302.         class="TableText">Close</p>
  303.       </td>
  304.       <td width="516"
  305.       style="width:387.0pt;border:none;border-bottom:solid 1.5pt;   padding:3.75pt 3.75pt 3.75pt 3.75pt"><p
  306.         class="TableText">Dismisses the menu.</p>
  307.       </td>
  308.     </tr>
  309.   </tbody>
  310. </table>
  311.  
  312. <h4 id="General">General Preferences</h4>
  313.  
  314. <p>To open the <strong>General Preferences</strong> dialog, choose
  315. <strong>General</strong> from the <strong>Preferences</strong> submenu.</p>
  316.  
  317. <p><strong>Home Page.</strong> Specifies the URI that Amaya will load when
  318. launched or when the user clicks the home page button. An example is <a
  319. href="http://www.w3.org/"><code>http://www.w3.org</code></a></p>
  320.  
  321. <p class="Note"><strong>Note:</strong> A complete URI must be used.</p>
  322.  
  323. <h5 id="Check">Check boxes</h5>
  324.  
  325. <p>The options below can be toggled on or off by clicking the check box next
  326. to an option name. A mark in the box indicates that the option is active.</p>
  327.  
  328. <p><strong>Enable line-byline paste.</strong> This option concerns the
  329. pasting form an external application. When that option is active, Amaya keeps
  330. lines in the source application. If not active, <code>newline</code>
  331. characters are replaced by spaces. This option is immediately effective.</p>
  332.  
  333. <p><strong>Generate backup files.</strong> When that option is active, Amaya
  334. generates a backup file for each edited document, after a given volume of
  335. modification. This option is immediately effective.</p>
  336.  
  337. <p><strong>Save geometry on exit.</strong> Controls whether the current
  338. windows geometry should be saved when the application is exited.</p>
  339.  
  340. <p><strong>Anti-aliasing.</strong> Controls whether anti-aliased fonts are
  341. used (better rendering when this option is used).</p>
  342.  
  343. <p><strong>ISO format for date.</strong> Controls whether generated dates are
  344. displayed using the ISO format (DD-MM-YYYY) or the American format
  345. (YYYY/MM/DD).</p>
  346.  
  347. <p><strong>Show targets.</strong> Controls whether link targets should be
  348. shown in all document main views.</p>
  349.  
  350. <p><strong>Access keys.</strong> Specifies the key (<code>Alt</code> or
  351. <code>Control</code>) used to implement the document <a
  352. href="../html/Browsing.html#Access">access keys</a>, or specifies that access
  353. keys defined in documents are ignored.</p>
  354.  
  355. <h5 id="Font">Font and language options</h5>
  356.  
  357. <p>This section of the <strong>General Preferences</strong> dialog lets you
  358. choose the font zoom level and define the dialogue language used in Amaya.
  359. These options are explained below.</p>
  360.  
  361. <p><strong>Font Zoom.</strong>You can zoom in and out, document window by
  362. document window. Each document (text and images) displayed within a zoomed
  363. window will be displayed larger or smaller than its real size according to
  364. the current zoom. This option enables you to change the font zoom for all
  365. windows. This change affects only font sizes but not image sizes, and is
  366. reflected immediately in all open document windows.</p>
  367.  
  368. <p><strong>Dialogue language.</strong> Specifies the language for all of
  369. Amaya's menus and dialogue messages. The default language is American English
  370. (en). At the present time, alternate languages are available: French (fr),
  371. German (de), Italian (it), Spanish (es), Portuguese (pt), Finnish (fi),
  372. Hungarian (hu), Russian (ru), Turkish (tr), etc. When launched, Amaya loads
  373. dialogue files according to the current dialogue language: en-, fr-, de-,
  374. it-, es-, pt-, fi- or tr-, etc. files. These dialogue files are located in
  375. the <strong>Amaya/config</strong> directory.</p>
  376.  
  377. <h5 id="Access">Access keys</h5>
  378.  
  379. <p>This option lets you specify the <strong>Alt</strong> or
  380. <strong>Control</strong> modifier used to manage <a
  381. href="Browsing.html">access keys</a> of documents, or says that access keys
  382. are ignored.</p>
  383.  
  384. <p class="Note"><strong>Note</strong>: The Alt modifier could not work
  385. because it is used by UI widgets.</p>
  386.  
  387. <h4 id="Browsing">Browsing Preferences</h4>
  388.  
  389. <p>The <strong>Browsing Preferences</strong> dialog control loading of
  390. pages.</p>
  391.  
  392. <h5 id="Opening">Opening location</h5>
  393.  
  394. <p>When the user clicks with the right button on a link to a new Web page,
  395. this new page can be displayed either <strong>in a new tab</strong> or
  396. <strong>in a new window</strong>. This option specifies the user
  397. preference.</p>
  398.  
  399. <h5 id="Check1">Check boxes</h5>
  400.  
  401. <p>The options below can be toggled on or off by clicking the check box next
  402. to an option name. A mark in the box indicates that the option is active.</p>
  403.  
  404. <p><strong>Load images.</strong> Controls whether images should be loaded.
  405. This option is immediately effective.</p>
  406.  
  407. <p><strong>Load objects.</strong> Controls whether objects should be loaded.
  408. This option is immediately effective.</p>
  409.  
  410. <p><strong>Show background images.</strong> Controls whether background
  411. images should be shown. This option is only effective when loading a new
  412. document.</p>
  413.  
  414. <p><strong>Load CSS.</strong> Controls whether CSS style sheets should be
  415. loaded and applied or not. This option is immediately effective.</p>
  416.  
  417. <p><strong>Double-click activates link.</strong> Since the first version of
  418. Amaya, users double-click a link to activate it. This enables you to choose
  419. whether to edit a link or activate it. You can override this behavior by
  420. deactivating this option.</p>
  421.  
  422. <p><strong>Enable FTP.</strong> Enables Amaya to follow FTP URLs. This
  423. support is experimental and is not yet fully debugged. For example, for FTP
  424. URLs needing user authentication, the authentication information is not
  425. always memorized. Also, pressing the <strong>Stop</strong> button during an
  426. FTP download may crash Amaya. Because of these problems, this option was
  427. added to Amaya so that other developers may help to debug it faster. By
  428. default, this option is turned off.</p>
  429.  
  430. <h5 id="Current">Current screen type</h5>
  431.  
  432. <p>Defines the current screen type. This value has an effect when a CSS style
  433. sheet specifies a media. This option is immediately effective.</p>
  434.  
  435. <h5 id="Language">Language Negotiation Preferences</h5>
  436.  
  437. <p>If a document exists in different languages and your server is configured
  438. to do language negotiation, you can use this dialog to enter your language
  439. preferences (the first one has the highest priority). Try browsing this <a
  440. href="http://www.w3.org/1999/05/WCAG-RECPressRelease.html">press release</a>,
  441. which is available in French, English, and Japanese versions. By changing the
  442. language negotiation to the ISO codes for the above languages
  443. (<strong>fr</strong>, <strong>en</strong>, or <strong>ja</strong>) you can
  444. transparently request any of these versions.</p>
  445.  
  446. <h4 id="Publishing">Publishing Preferences</h4>
  447.  
  448. <p>The <strong>Publishing Preferences</strong> dialog lets you set
  449. preferences for ETAGS and preconditions, whether to verify each PUT command
  450. with a GET, set the default name for URLs ending with a slash, and enable PUT
  451. redirections on specified domains. These options are explained below.</p>
  452.  
  453. <h5 id="Charset">Charset for new documents</h5>
  454.  
  455. <p>Defines the charset used for new documents.</p>
  456.  
  457. <h5 id="Check2">Check boxes</h5>
  458.  
  459. <p>The options below can be toggled on or off by clicking the check box next
  460. to an option name. A mark in the box indicates that the option is active.</p>
  461.  
  462. <p><strong>Use the application/xhtml+xml MIME type for XHTML
  463. documents.</strong> This option, if enabled, associated the new, official
  464. XHTML MIME type to all new XTHML documents that are published on the Web.
  465. This option is disabled by default because not all servers can handle this
  466. MIME type at the time of this release, Note that this requires also a change
  467. in your server configuration, if it's not storing somewhere the metadata
  468. associated with each document. This option does not modify the MIME type of
  469. existing documents: the MIME type that is received is the same one that will
  470. be used when saving the document, except if you do a <strong>SaveAs</strong>
  471. operation, of course.</p>
  472.  
  473. <p><strong>Use ETAGS and preconditions.</strong> HTTP/1.1 introduces new
  474. headers that avoid the <a
  475. href="http://www.w3.org/WinCom/NoMoreLostUpdates.html">lost updates</a>
  476. problem when publishing. With this option, you can detect conflicts when two
  477. users are publishing the same document.</p>
  478.  
  479. <p><strong>Verify each PUT with a GET.</strong> If you don't trust your
  480. server, this option tells Amaya to retrieve each document as soon as it has
  481. been published and compare it with the copy stored in your workstation. If
  482. the documents differ, Amaya will warn you.</p>
  483.  
  484. <p><strong>Export CR/LF</strong>. This option, if enabled, precedes each line
  485. feed by a carriage return (DOS format).</p>
  486.  
  487. <h5 id="Default">Default name for URLs finishing in '/'</h5>
  488.  
  489. <p>An HTTP server usually associates URLs that finish in '/' with a default
  490. name, for example, Overview.html. This option enables you to specify the
  491. default name that Amaya should use when publishing such a URL. Ask your
  492. Webmaster for the default name for your server.</p>
  493.  
  494. <h5 id="Allow">Allow automatic PUT redirections on these domains</h5>
  495.  
  496. <p>According to the HTTP/1.1 specification, PUT operations should not be
  497. automatically redirected unless it can be confirmed by the user, because this
  498. might change the conditions under which the request was issued. You can avoid
  499. having Amaya prompt with a PUT redirection warning by entering the name of
  500. the server's domain to which you are publishing. You may specify one or more
  501. domains, each separated with a space, e.g., <code>www.w3.org
  502. groucho.marx.edu</code>.</p>
  503.  
  504. <h4 id="Cache">Cache Preferences</h4>
  505.  
  506. <p>Amaya provides a cache through libwww. The cache is enabled by default and
  507. is stored in the AmayaTemp/libwww-cache directory. This menu also provides a
  508. <strong>Flush Cache</strong> button for erasing the cache directory.</p>
  509.  
  510. <h5 id="Check3">Check boxes</h5>
  511.  
  512. <p>The options below can be toggled on or off by clicking the check box next
  513. to an option name. A mark in the box indicates that the option is active.</p>
  514.  
  515. <p><strong>Enable cache.</strong> Activates or deactivates the cache.</p>
  516.  
  517. <p><strong>Cache protected documents.</strong> By default, documents which
  518. are protected by a password are stored in the cache. Use this option to
  519. override this behavior.</p>
  520.  
  521. <p><strong>Disconnected mode.</strong> Always retrieves documents from the
  522. cache.</p>
  523.  
  524. <p><strong>Ignore Expires: header.</strong> Does not expire cache entries.</p>
  525.  
  526. <h5 id="Cache1">Cache directory</h5>
  527.  
  528. <p>Identifies the parent directory for the libwww-cache directory. Changing
  529. this directory does not erase the contents of the previous one. You must
  530. remove it yourself.</p>
  531.  
  532. <p class="Note"><strong>Note:</strong> File protection mechanisms prevent the
  533. use of NFS (Network File System) directories for the cache directory as NFS
  534. allows reuse by multiple processes or users. Use a local directory for the
  535. cache.</p>
  536.  
  537. <h5 id="Cache2">Cache size</h5>
  538.  
  539. <p>Gives the size, in megabytes, of the cache repository.</p>
  540.  
  541. <h5 id="Cache3">Cache entry size limit</h5>
  542.  
  543. <p>Gives the maximum size for a cache entry.</p>
  544.  
  545. <h5 id="Flush">Flush cache</h5>
  546.  
  547. <p>This button allows you to flush the current cache.</p>
  548.  
  549. <h4 id="Proxy">Proxy Preferences</h4>
  550.  
  551. <p>You can use this dialog to specify a proxy and a set of domains where the
  552. proxy should or should not be used.</p>
  553.  
  554. <p><strong>HTTP proxy.</strong>Identifies the proxy to be used for HTTP
  555. requests. You must specify the full name of the server. If the server is
  556. running in a port other than 80, then, like in a URL, you need to add a ":"
  557. char to the proxy name, followed by the port number. The table below provides
  558. two examples.</p>
  559.  
  560. <table border="1" cellspacing="0" cellpadding="0"
  561. style="margin-left:.2in;border-collapse:  collapse;border:none;">
  562.   <tbody>
  563.     <tr>
  564.       <td width="194" valign="top"
  565.       style="width:145.85pt;border-top:solid green 1.5pt;   border-left:none;border-bottom:solid green .75pt;border-right:none;   padding:0in 5.4pt 0in 5.4pt"><p
  566.         class="TableHead"><span xml:lang="EN" lang="EN"
  567.         style="font-weight:   normal"><b>HTTP Proxy Entry</b></span></p>
  568.       </td>
  569.       <td width="377" valign="top"
  570.       style="width:282.55pt;border-top:solid green 1.5pt;   border-left:none;border-bottom:solid green .75pt;border-right:none;   padding:0in 5.4pt 0in 5.4pt"><p
  571.         class="TableHead"><span xml:lang="EN" lang="EN"
  572.         style="font-weight:   normal"><b>Result</b></span></p>
  573.       </td>
  574.     </tr>
  575.     <tr>
  576.       <td width="194" valign="top"
  577.       style="width:145.85pt;border:none;padding:0in 5.4pt 0in 5.4pt"><p
  578.         class="Code0"><span xml:lang="EN" lang="EN">áá
  579.         groucho.marx.edu</span></p>
  580.  
  581.         <p class="Code0"><span xml:lang="EN" lang="EN">ááááááááááá</span></p>
  582.       </td>
  583.       <td width="377" valign="top"
  584.       style="width:282.55pt;border:none;padding:0in 5.4pt 0in 5.4pt"><p
  585.         class="TableText"><span xml:lang="EN" lang="EN">Declares a proxy
  586.         called groucho.marx.edu running at the default port 80.</span></p>
  587.       </td>
  588.     </tr>
  589.     <tr>
  590.       <td width="194" valign="top"
  591.       style="width:145.85pt;border:none;border-bottom:   solid green 1.5pt;padding:0in 5.4pt 0in 5.4pt"><p
  592.         class="Code0"><span xml:lang="EN" lang="EN">áá
  593.         groucho.marx.edu:1234</span></p>
  594.  
  595.         <p class="Code0"><span xml:lang="EN" lang="EN">ááááááááááá</span></p>
  596.       </td>
  597.       <td width="377" valign="top"
  598.       style="width:282.55pt;border:none;border-bottom:   solid green 1.5pt;padding:0in 5.4pt 0in 5.4pt"><p
  599.         class="TableText"><span xml:lang="EN" lang="EN">Declares a proxy
  600.         called groucho.marx.edu, running at port 1234.</span></p>
  601.       </td>
  602.     </tr>
  603.   </tbody>
  604. </table>
  605.  
  606. <h5 id="Proxy1">Proxy domain list</h5>
  607.  
  608. <p>Lists space-separated domains where you want to use your proxy. Use the
  609. switch buttons to specify if the proxy should or shouldn't be used with this
  610. domain list. For example:</p>
  611.  
  612. <p><code>harpo.marx.edu zeppo.marx.edu chico.marx.edu</code></p>
  613. <pre style="margin-left:.5in">ááááááááá ^----------------^----> space separated entries</pre>
  614.  
  615. <h4 id="Color">Color Preferences</h4>
  616.  
  617. <p>This dialog lets you select the default foreground and background colors
  618. for documents. It enables you to control the colors used by Amaya to display
  619. the current selection.</p>
  620. <ul>
  621.   <li><strong>Document foreground color</strong> is the default foreground
  622.     color of displayed pages.</li>
  623.   <li><strong>Document background color</strong> is the default background
  624.     color of displayed pages.</li>
  625.   <li><strong>Selection color</strong> is the foreground color that shows the
  626.     selection when it's limited to an insert point.</li>
  627.   <li><strong>Selection background color</strong> is the background color
  628.     that shows the current selection when it's extended.</li>
  629. </ul>
  630.  
  631. <p>All these colors may be selected by name, hex code, or RGB format:</p>
  632. <ul>
  633.   <li>Proposed valid names., Black, Blue, Fuchsia, Gray, Green, Lime, Maroon,
  634.     Navy, Olive, Purple, Red, S</li>
  635.   <li>Valid hexcode format is #FF00F, for example.</li>
  636.   <li>Valid RGB format is rgb(255, 0, 255), for example.</li>
  637. </ul>
  638.  
  639. <p>You can also select colors with the associated color palette.</p>
  640.  
  641. <p class="Note"><strong>Note:</strong> Color changes will be effective when
  642. you open a new document window.</p>
  643.  
  644. <h4 id="Window">Window Geometry Preferences</h4>
  645.  
  646. <p>This dialog enables you</p>
  647. <ul>
  648.   <li>to save the current window size and position of the current window,</li>
  649.   <li>or to restore the default values.</li>
  650. </ul>
  651.  
  652. <p class="Note"><strong>Note</strong>: These changes take affect when you
  653. open new document windows.</p>
  654.  
  655. <h4 id="Configurin1">Configuring Annotation Settings</h4>
  656.  
  657. <h4 id="Annotation">Annotation user</h4>
  658.  
  659. <p>The author of the annotation. By default, Amaya uses the login name of the
  660. user. This field enables you to change your user name to something more
  661. meaningful.</p>
  662.  
  663. <h4 id="Annotation1">Annotation post server</h4>
  664.  
  665. <p>This setting defines the server to which the annotations are posted. Local
  666. annotations are always saved to the local repository, and by default, this
  667. setting is empty. The post server is not automatically included in the list
  668. of servers, so you should enter the post server name in both places.</p>
  669.  
  670. <h4 id="Annotation2">Annotation servers</h4>
  671.  
  672. <p>A list of servers Amaya should contact when looking for annotations. You
  673. can specify one or more servers. The reserved server name
  674. <strong>localhost</strong> tells Amaya to search the local annotations, but
  675. does not necessarily mean that a local annotation server is running (or it
  676. would show a complete URL ).Under Unix, the annotation servers are specified
  677. as a space separated list. Under Windows, you can add a new server name by
  678. clicking in the Annotations servers list, pressing the <strong>Enter</strong>
  679. key, and then typing the server name . By default, this list is initialized
  680. to <code>localhost</code>.</p>
  681.  
  682. <p class="Note"><strong>Tip</strong>: To temporarily disable an annotation
  683. server, add a "-" char before its URL. Amaya will ignore it.</p>
  684.  
  685. <h5 id="Check4">Check boxes</h5>
  686.  
  687. <p>The options below can be toggled on or off by clicking the check box next
  688. to an option name. A mark in the box indicates that the option is active.</p>
  689.  
  690. <p><strong>Autoload local annotations</strong>. Whether Amaya should request
  691. local annotations automatically every time you browse a new Web page. If it
  692. is not checked, then you can manually choose <strong>Load
  693. annotations</strong> from the <strong>Annotations</strong> menu.</p>
  694.  
  695. <p><strong>Autoload remote annotations</strong>. Whether Amaya should request
  696. remote annotations automatically (by querying the annotation server) every
  697. time you browse a new Web page. If it is not checked, then you can manually
  698. choose <strong>Load annotations</strong> from the
  699. <strong>Annotations</strong> menu.</p>
  700.  
  701. <p class="Note"><strong>Note:</strong> You may experience a delay when Amaya
  702. loads remote annotations in resolving the DNS name of the annotation
  703. servers.</p>
  704.  
  705. <p><strong>Disable remote autoload at each startup (for offline
  706. work)</strong>. Whether Amaya should reset the <strong>autoload remote
  707. annotations</strong>option at launch time. This option can be useful if you
  708. are working offline, but still want to autoload the local annotations as well
  709. as the remote ones.</p>
  710. </div>
  711. </body>
  712. </html>
  713.