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 / configuring_icons.html < prev    next >
Encoding:
Extensible Markup Language  |  2003-04-14  |  5.4 KB  |  160 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.     
  5. <html xmlns="http://www.w3.org/1999/xhtml">
  6. <head>
  7.   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
  8.   <title>Configuring Annotation Icons</title>
  9.   <style type="text/css">
  10.   </style>
  11.   <meta name="GENERATOR" content="amaya 5.2" />
  12.   <link href="../style.css" rel="stylesheet" type="text/css" />
  13. </head>
  14.  
  15. <body xml:lang="en" lang="en">
  16.  
  17. <table border="0" width="100%" summary="toc">
  18.   <tbody>
  19.     <tr>
  20.       <td><img alt="W3C" src="../../images/w3c_home" /> 
  21.           <img alt="Amaya" src="../../images/amaya.gif" /></td>
  22.       <td><p align="right"><a href="replying_to_annotations.html" accesskey="p">
  23.               <img alt="previous" src="../../images/left.gif" /></a> 
  24.         <a href="../Annotations.html" accesskey="t">
  25.            <img alt="top" src="../../images/up.gif" /></a> 
  26.         <a href="annotation_issues.html" accesskey="n">
  27.            <img alt="next" src="../../images/right.gif" /></a>
  28.     </p>
  29.       </td>
  30.     </tr>
  31.   </tbody>
  32. </table>
  33.  
  34. <div id="page_body">
  35. <h1>Configuring Annotation Icons</h1>
  36.  
  37. <h2>User-definable icons by Annotation type (aka "dynamic icons")</h2>
  38.  
  39. <p>
  40. As of Release 6.2, the icon used to mark the location of
  41. an annotation within an annotated document may be changed
  42. by the user.</p>
  43.  
  44. <p>
  45. In release 6.2 the icon that denotes an annotation is chosen
  46. as a property of the annotation type.  By including an RDF
  47. property of each annotation type you wish to use, you select
  48. the icon associated with annotations of that type.</p>
  49.  
  50. <p>
  51. The sample configuration that is shipped with release 6.2
  52. associates the following icons:</p>
  53.  
  54. <table>
  55.  <tr>
  56.   <td width="35"><img src="../../../amaya/advice.png" alt="Advice"/></td>
  57.   <td>Advice</td>
  58.  </tr>
  59.  
  60.  <tr>
  61.   <td width="35"><img src="../../../amaya/change.png" alt="Change"/></td>
  62.   <td>Change</td>
  63.  </tr>
  64.  
  65.  <tr>
  66.   <td width="35"><img src="../../../amaya/annot.png" alt="Comment"/></td>
  67.   <td>Comment</td>
  68.  </tr>
  69.  
  70.  <tr>
  71.   <td width="35"><img src="../../../amaya/example.png" alt="Example"/></td>
  72.   <td>Example</td>
  73.  </tr>
  74.  
  75.  <tr>
  76.   <td width="35"><img src="../../../amaya/explanation.png" alt="Explanation"/></td>
  77.   <td>Explanation</td>
  78.  </tr>
  79.  
  80.  <tr>
  81.   <td width="35"><img src="../../../amaya/question.png" alt="Question"/></td>
  82.   <td>Question</td>
  83.  </tr>
  84.  
  85.  <tr>
  86.   <td width="35"><img src="../../../amaya/seealso.png" alt="SeeAlso"/></td>
  87.   <td>SeeAlso</td>
  88.  </tr>
  89.  
  90. </table>
  91.  
  92. <p>
  93. The property name for adding annotation icons is
  94. <a href="http://www.w3.org/2001/10/typeIcon#usesIcon"
  95. >http://www.w3.org/2001/10/typeIcon#usesIcon</a>.
  96. For instance, to specify an icon named
  97. file:///home/question-icon.jpg for annotations that have type 
  98. <a href="http://www.w3.org/2000/10/annotationType#Question"
  99. >http://www.w3.org/2000/10/annotationType#Question</a>
  100. you would enter the following RDF/XML into a file that
  101. Amaya reads at startup is:</p>
  102.  
  103. <pre>
  104. <rdf:RDF
  105.    xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
  106.    xmlns:i = "http://www.w3.org/2001/10/typeIcon#">
  107. <rdf:Description rdf:about="http://www.w3.org/2000/10/annotationType#Question">
  108.   <i:usesIcon rdf:resource="file:///home/question-icon.jpg" />
  109. </rdf:Description>
  110. </rdf:RDF>
  111. </pre>
  112.  
  113. <p>
  114. The simplest way to get such RDF loaded into Amaya at startup is
  115. to include the file in the config/annot.schemas file in the Amaya
  116. program directory.  In order to preserve this file so that it will
  117. not be overwritten when you install a new version of Amaya, you
  118. should copy the config/annot.schemas file into your personal
  119. Amaya home directory; ~/.amaya/annot.schemas (on Unix systems)
  120. or /winnt/profiles/<username>/amaya/annot.schemas (on Microsoft
  121. Windows systems).  You may list as many RDF files as you want
  122. in annot.schemas.  See the comments in the file included in the
  123. Amaya kit for more details.</p>
  124.  
  125. <p>
  126. Release 6.2 includes a sample file named "typeIcon.rdf" that
  127. declares unique icons for each annotation type declared in the
  128. <a href="http://www.w3.org/2000/10/annotationType#"
  129. >http://www.w3.org/2000/10/annotationType#</a> namespace.  To experiment
  130. with user-defined icons, it may be easiest to copy this typeIcon.rdf
  131. into another directory and modify it.  Copy annot.schemas to your
  132. Amaya home directory and change the line near the end to point to
  133. your revised icon definition file.</p>
  134.  
  135. <p>
  136. To revert to the previous behavior prior to release 6.2, edit
  137. the config/annot.schemas in the Amaya installation directory and
  138. add a comment character ("#") at the beginning of the line near
  139. the end that refers to typeIcon.rdf:</p>
  140.  
  141. <pre>
  142. #user-defined icons
  143. #http://www.w3.org/2001/10/typeIcon# $THOTDIR/config/typeIcon.rdf
  144. </pre>
  145.  
  146. <p>
  147. Amaya supports JPEG, PNG, and GIF bitmap graphics formats for icon
  148. images.  In release 6.2 the icon URI may only be a file: URI; that
  149. is, the icon must appear in a local or mounted directory to Amaya.
  150. Two special forms of non-file: URIs are supported.  If the file path
  151. name starts with "$THOTDIR" or "$APP_HOME" then the corresponding
  152. Amaya installation directory or personal Amaya home directory is
  153. substituted into the pathname.</p>
  154.  
  155. </div>
  156.  
  157. </body>
  158. </html>
  159.  
  160.