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