home *** CD-ROM | disk | FTP | other *** search
/ GameStar 2005 May / Gamestar_73_2005-05_dvd.iso / Programy / amaya / amaya-WinXP-9.1.exe / doc / html / bookmarks.html < prev    next >
Encoding:
Extensible Markup Language  |  2005-01-06  |  8.5 KB  |  197 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>Bookmark support in Amaya</title>
  8.   <style type="text/css">
  9.   </style>
  10.   <meta name="GENERATOR" content="amaya 8.2, see http://www.w3.org/Amaya/" />
  11.   <link href="style.css" rel="stylesheet" type="text/css" />
  12. </head>
  13.  
  14. <body xml:lang="en" lang="en">
  15.  
  16. <table border="0" width="100%" summary="toc">
  17.   <tbody>
  18.     <tr>
  19.       <td><img alt="W3C" src="../images/w3c_home" /> <img alt="Amaya"
  20.         src="../images/amaya.gif" /></td>
  21.       <td><p align="right"><a href="Annotations.html" accesskey="p"><img
  22.         alt="previous" src="../images/left.gif" /></a><a href="Manual.html"
  23.         accesskey="t"><img alt="top" src="../images/up.gif" /></a> <a
  24.         href="Configure.html" accesskey="n"><img alt="next"
  25.         src="../images/right.gif" /></a></p>
  26.       </td>
  27.     </tr>
  28.   </tbody>
  29. </table>
  30.  
  31. <div id="page_body">
  32. <h1><a name="What">Bookmark support in Amaya</a></h1>
  33.  
  34. <p><strong>NOTE: This is a beta version of the Annotea bookmarks
  35. implementation in Amaya. The User Interface needs more work and it only works
  36. for the moment on Linux.</strong></p>
  37.  
  38. <p>Beginning from Version 8.1, Amaya supports the <a
  39. href="http://www.w3.org/2003/07/Annotea/BookmarkSchema-20030707.html">Annotea
  40. Bookmark schema</a>. Follow the link for a better description of this RDF
  41. schema. This document describes the user interface and known bugs of its
  42. implementation inside Amaya.</p>
  43.  
  44. <p>The user interface is very similar to that found in other browsers and it
  45. allows you to do most of the same operations. One notable difference is that
  46. the Annotea Bookmarks schema uses the term <em>Topic</em> rather than
  47. <em>Folder</em>. The reason for this choice is that the organization of this
  48. kind of bookmarks os not limited to strict hierarchies, but can be extended
  49. to full graphs.</p>
  50.  
  51. <h2>Bookmark Menu</h2>
  52.  
  53. <p>The user can access the bookmarks functionality by means of the
  54. <em>Bookmarks</em> menu in the menu bar:</p>
  55.  
  56. <p style="text-align: center"><img src="../images/bmmenu.png"
  57. alt="Bookmark menu in the menu bar" border="1" /></p>
  58.  
  59. <p>The operations that this menu proposes are:</p>
  60. <ul>
  61.   <li><em>New Bookmark</em>: opens a widget for adding the current document
  62.     to the bookmarks file.</li>
  63.   <li><em>New Topic</em>: opens a widget for adding a new topic to the
  64.     bookmarks file.</li>
  65.   <li><em>View bookmarks</em>: displays the bookmarks file.</li>
  66. </ul>
  67.  
  68. <p>We will examine each of these operations in the following sections.</p>
  69.  
  70. <h2>Creating a new bookmark</h2>
  71.  
  72. <p>When you want to bookmark a given document that you're browsing, invoke
  73. the <em>New Bookmark</em> function from the menu bar. This will open the
  74. <em>Bookmark Properties</em> widget:</p>
  75.  
  76. <p style="text-align: center"><img src="../images/bmbprop.png"
  77. alt="Bookmark Properties Widget" border="1" /></p>
  78. </div>
  79.  
  80. <p>A bookmark can belong to one or more topics. The <strong>Topic
  81. Hierarchy</strong> field displays the current topics that you have and lets
  82. you select the topics where you want to classify your bookmark. For example,
  83. the above figure shows a bookmark tha tbelongs to the INRIA and W3C Topics.
  84. Note that a bookmark must always belong to a topic. Amaya will refuse to
  85. create the bookmark if this is not the case. You can create a new topic from
  86. this widget by using the <strong>New Topic</strong> button, at the bottom of
  87. the widget.</p>
  88.  
  89. <p>The <strong>Title</strong> field gives the title of the bookmark. If the
  90. document you're bookmarking is written in a markup language that Amaya
  91. understand (e.g., XHTML, HTML, ...) and if this document has recognizable
  92. title element, the value of this element will be used for this field.
  93. Otherwise, the URL of the document will be shown.</p>
  94.  
  95. <p>The <strong>Recalls</strong> field gives the URL of the document that this
  96. bookmark points to.</p>
  97.  
  98. <p>The <strong>Created</strong> and <strong>Last Modified</strong> fields
  99. give the time of creation and of last modification of the bookmark,
  100. respectively.</p>
  101.  
  102. <p>The <strong>Description</strong> field allows you to give an optional text
  103. describing the bookmark.</p>
  104.  
  105. <p>The <strong>Apply</strong> button allows you to add the bookmark to the
  106. bookmark file or, if you're modifying it, to update it.</p>
  107.  
  108. <p>The <strong>New Topic</strong> button opens the <em>Topics Properties</em>
  109. widget to let you create a new topic.</p>
  110.  
  111. <p>The <strong>Done</strong> button closes the widget and discards any
  112. changes that were not saved.</p>
  113.  
  114. <div id="page_body1">
  115. <h2>Creating a new topic</h2>
  116.  
  117. <p>When you want to create a new topic, invoke the <em>New Topic</em>
  118. function from the menu bar. This will open the Topic<em>Properties</em>
  119. widget:</p>
  120.  
  121. <p style="text-align: center"><img src="../images/bmtprop.png"
  122. alt="Topic Properties Widget" border="1" /></p>
  123. </div>
  124.  
  125. <p>In this implementqtion, topics have to have a hierarichal organization.
  126. That is, each topic has a parent topic and can have sub topics stored under
  127. it. By default, there is a root topic, called <em>Home Topic</em>, that is
  128. automatically generated. All new topics that you will be created will be
  129. stored under it.</p>
  130.  
  131. <p>The <strong>Topic Hierarchy</strong> field displays the current topics
  132. that you have and lets you choose the topic under which you want to store the
  133. new topic. For example, the figure shows the <em>W3C</em> topic that is
  134. stored under the <em>Home Topic</em><em>.</em></p>
  135.  
  136. <p>All the other fields in this widget have the same meaning as those
  137. described in the Bookmark Widget, in the precedent setion.</p>
  138.  
  139. <p>The <strong>Apply</strong> button allows you to add the topic to the
  140. bookmark file or, if you're modifying it, to update it.</p>
  141.  
  142. <p>The <strong>Done</strong> button closes the widget and discards any
  143. changes that were not saved.</p>
  144.  
  145. <div id="page_body11">
  146. <h2>Viewing your bookmarks file</h2>
  147.  
  148. <p>When you want to view and use your bookmark file, invoke the <em>View
  149. Bookmarks</em> function from the menu bar. This will open a new window
  150. displaying your bookmarks and topics:</p>
  151.  
  152. <p style="text-align: center"><img src="../images/bmview1.png"
  153. alt="Topic Properties Widget" border="2" /></p>
  154. </div>
  155.  
  156. <p></p>
  157.  
  158. <p>In the bookmark view, topics entries are prefixed with either a <img
  159. alt="collapsed topic" src="../images/closed.png" /> or a <img
  160. alt="expanded topic" src="../images/open.png" /> icon. The other entries are
  161. bookmarks. You can either activate entries by clicking on the left mouse
  162. button or view the properties of an entry by using the right mouse button. If
  163. you're viewing the properties of an entry, you can also edit them and save
  164. the modifications.</p>
  165.  
  166. <p>For a bookmark entry, the left mouse button will open a new window
  167. displaying the document that the bookmark recalls. For a topic entry, the
  168. left mouse button will either collapse or expand its contents. The <img
  169. alt="collapsed topic" src="../images/closed.png" /> icon represents a
  170. collapsed topic entry and the <img alt="expanded topic"
  171. src="../images/open.png" /> icon an expand topic entry.</p>
  172.  
  173. <p>In order to delete an entry, you have to put the cursor in the entry and
  174. select it by pressing the <code>F2</code> key:</p>
  175.  
  176. <p style="text-align: center"><img src="../images/bmview2.png"
  177. alt="Selecting a topic and its entries" border="2" /></p>
  178.  
  179. <p>Once the entry is selected, you just need to press the <em>Delete</em> key
  180. to erase it. If you select a topic entry, all of its children will be also
  181. selected and deleted with this operation. Note that for bookmarks that belong
  182. to multiple topics, deleting its entry from a topic, only destroys one RDF
  183. property that says that this bookmark belongs to that topic. In order to
  184. completely delete a bookmark that belongs to multiple topics, you will need
  185. to delete its entry in all those topics. Alternatively, you can first edit
  186. its properties and make it belong to only one topic, then delete it.</p>
  187.  
  188. <h2>For hackers</h2>
  189.  
  190. <p>The bookmarks are stored in the Amaya preferences directory under the name
  191. <em>bookmarks.rdf</em>. If you edit this file and add additional properties,
  192. they will be preserved. This is due to our using Redland for parsing and
  193. querying the RDF model. For more information, see the <a
  194. href="http://www.w3.org/2001/Annotea/">Annotea</a> project home page.</p>
  195. </body>
  196. </html>
  197.