home *** CD-ROM | disk | FTP | other *** search
/ PC World 2002 September / PCWorld_2002-09_cd.bin / Komunik / amaya / 9x / amaya-Win98-6.2.exe / _SETUP.1 / Annotations.html.fr < prev    next >
Encoding:
Extensible Markup Language  |  2002-06-11  |  25.9 KB  |  486 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.   <title>Annotations</title>
  7.   <meta name="GENERATOR" content="amaya 5.3, see http://www.w3.org/Amaya/" />
  8.   <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
  9. </head>
  10.  
  11. <body xml:lang="fr" lang="fr">
  12.  
  13. <table border="0" summary="toc">
  14.   <tbody>
  15.     <tr>
  16.       <td><img alt="W3C" src="../images/w3c_home" /> <img alt="Amaya"
  17.         src="../images/amaya.gif" /></td>
  18.       <td><p><a href="MakeBook.html.fr" accesskey="p"><img alt="previous"
  19.         src="../images/left.gif" /></a> <a href="Manual.html.fr"
  20.         accesskey="t"><img alt="top" src="../images/up.gif" /></a> <a
  21.         href="Configure.html.fr" accesskey="n"><img alt="next"
  22.         src="../images/right.gif" /></a></p>
  23.       </td>
  24.     </tr>
  25.   </tbody>
  26. </table>
  27. <ul>
  28.   <li><a href="Annotations.html.fr#def">DΘfinition</a></li>
  29.   <li><a href="Annotations.html.fr#Local">Annotations locales et
  30.   distantes</a></li>
  31.   <li><a href="Annotations.html.fr#Annotation">Menu des annotations</a></li>
  32.   <li><a href="Annotations.html.fr#Configurat">Menu de configuration pour les
  33.     annotations</a></li>
  34.   <li><a href="Annotations.html.fr#Creating">CrΘer une annotation</a></li>
  35.   <li><a href="Annotations.html.fr#Deleting1">Supprimer une
  36.   annotation</a></li>
  37.   <li><a href="Annotations.html.fr#Loading">Charger et afficher une
  38.     annotations</a></li>
  39.   <li><a href="Annotations.html.fr#Navigating">Activer des
  40.   annotations</a></li>
  41.   <li><a href="Annotations.html.fr#Moving">DΘplacer des annotations</a></li>
  42.   <li><a href="#Threads">RΘpondre α une annotation / fils de
  43.   discussion</a></li>
  44.   <li><a href="Annotations.html.fr#Issues1">ProblΦmes relatifs aux
  45.     annotations et aux documents modifiΘs</a></li>
  46. </ul>
  47.  
  48. <div id="Annotations">
  49. <h2><a name="L1065">Les annotations dans Amaya</a></h2>
  50.  
  51. <h3 id="def">DΘfinition</h3>
  52.  
  53. <p>Une annotation est un commentaire, une note, une explication ou tout autre
  54. remarque externe qui peut Ωtre attachΘe α un document web ou α une partie de
  55. celui-ci. Comme les annotations dans Amaya sont externes au document, il est
  56. possible d'annoter n'importe quel document du web, mΩme sans avoir le droit
  57. de le modifier. D'un point de vue technique, une annotation peut Ωtre vue
  58. comme une mΘta-donnΘe puisqu'elle fournit une information supplΘmentaire sur
  59. une donnΘe existante. Dans Amaya, nous utilisons un <a
  60. href="http://www.w3.org/2000/10/annotation-ns">schΘma</a> <a
  61. href="http://www.w3.org/RDF/">RDF</a> pour dΘcrire les annotations.</p>
  62.  
  63. <p>Les annotations peuvent Ωtre enregistrΘes localement ou sur un ou
  64. plusieurs <strong>serveur(s) d'annotations</strong>. Lorsqu'un document est
  65. chargΘ, Amaya interroge chacun de ces serveurs et recherche les annotations
  66. relatives α ce document. Chaque annotation est ensuite reprΘsentΘe par
  67. l'ic⌠ne suivante <img src="../images/annot.png"
  68. alt="Crayon representant une annotation" /> qui est ajoutΘe au document (voir
  69. figure ci-dessous). Lorsque l'utilisateur clique sur l'ic⌠ne d'annotation, le
  70. passage annotΘ est mis en Θvidence. Si l'utilisateur double-clique sur
  71. l'ic⌠ne alors le contenu de l'annotation ainsi que les autres mΘta-donnΘes
  72. lui sont prΘsentΘes dans une nouvelle fenΩtre.</p>
  73.  
  74. <p style="text-align: center"><img src="../images/annotationicon.png"
  75. alt="annotation icon (= pencil)" /></p>
  76.  
  77. <p>Une annotation possΦde plusieurs propriΘtΘsá:</p>
  78. <ul>
  79.   <li>Point de stockage: dans le systΦme de fichiers de l'utilisateur ou sur
  80.     un serveur d'annotations</li>
  81.   <li>Etendue : l'annotation est associΘe α un document entier ou α une
  82.     fragment de celui-ci</li>
  83.   <li>Type de l'annotation: 'Annotation', 'Comment', 'Query', ...</li>
  84. </ul>
  85.  
  86. <h3 id="Local">Annotations locales et distantes</h3>
  87.  
  88. <p>Amaya peut sauver les annotations dans un fichier local (annotations
  89. locales) ou sur le Web (annotations distantes). Les <strong>annotations
  90. distantes</strong> sont enregistrΘes sur des serveurs d'annotations et
  91. peuvent Ωtre chargΘes ou enregistrΘes par quiconque ayant les droits d'accΦs
  92. correspondants, comme pour les autres documents HTML. Les annotations
  93. distantes sont dites <strong>partagΘes</strong> ou <strong>publiques</strong>
  94. parce qu'elles peuvent Ωtre vues par plusieurs personnes. Si vous dΘsirez
  95. installer votre propre serveur d'annotations, veuillez vous rΘfΘrer au
  96. document "<a
  97. href="http://www.w3.org/1999/02/26-modules/User/Annotations-HOWTO.html">Annotation-Server
  98. HOWTO</a>".</p>
  99.  
  100. <p>Les <strong>annotations locales</strong> ne nΘcessitent pas l'utilisation
  101. de serveur. Elles sont enregistrΘes sous le repΘrtoire de configuration
  102. d'Amaya, dans un rΘpertoire spΘcifique appelΘ <code>annotations</code> et
  103. peuvent Ωtre visualisΘes uniquement par leur auteur (selon les droits d'accΦs
  104. en fonction). Ce rΘpertoire comporte trois sortes de fichiers:</p>
  105. <dl>
  106.   <dt><strong>annot.index</strong></dt>
  107.     <dd>les URL associΘes aux fichiers dans lesquels les mΘta-donnΘes des
  108.       annotations sont sauvegardΘes.</dd>
  109.   <dt><strong>index + random suffix</strong></dt>
  110.     <dd>un fichier contenant les meta-donnΘes d'une annotation relative α une
  111.       URL. Les meta-donnΘes sont spΘcifiΘes avec RDF.</dd>
  112.   <dt><strong>annot + random suffix.html</strong></dt>
  113.     <dd>contient le corps de l'annotation enregistrΘe en XHTML.</dd>
  114. </dl>
  115.  
  116. <p>Un utilisateur peut α tout moment transformer une annotation locale en une
  117. annotation partagΘe en utilisant l'entrΘe <strong>Enregistrer une
  118. annotation</strong> du menu <strong>Annotations</strong>. Si cette commande
  119. rΘussit, l'annotation est supprimΘe localement et transfΘrΘe sur un serveur
  120. d'annotations. La section suivante dΘcrit comment dΘfinir le nom du serveur
  121. d'annotations sur lequel les annotations distantes sont enregistrΘes.</p>
  122.  
  123. <h3 id="Annotation">Menu des annotations</h3>
  124.  
  125. <p>La plupart des commandes utilisΘes pour la gestion des annotations se
  126. trouvent dans le menu d'annotations reprΘsentΘ ci dessous.</p>
  127.  
  128. <p style="text-align: center"><img src="../images/annotationsmenu--fr.png"
  129. alt="Annotations menu" /></p>
  130.  
  131. <h3 id="Configurat">Menu de configuration pour les annotations</h3>
  132.  
  133. <p>Ce menu est appelΘ α partir de l'entrΘe <strong>Configuration</strong>. La
  134. figure suivante montre la version Windows de ce menu. La version Unix a une
  135. interface utilisateur lΘgΦrement diffΘrente mais offre les mΩmes
  136. fonctionnalitΘs.</p>
  137.  
  138. <p style="text-align: center"><img src="../images/configurebox.png"
  139. alt="configuration dialog box" /></p>
  140.  
  141. <p></p>
  142. <dl>
  143.   <dt><strong>Nom de l'utilisateur (Annotation user)</strong></dt>
  144.     <dd>Ce champ est associΘ α chaque nouvelle annotation et dΘfinit
  145.       l'<strong>auteur</strong> de l'annotation. Par dΘfaut, Amaya utilise le
  146.       nom de connexion pour construire la mΘta-donnΘe auteur. Le champ
  147.       "Annotation user" permet α un utilisateur de remplacer ce nom par un
  148.       nom plus significatif comme par exemple, changer le nom
  149.       <code>u1723242</code> en <code>marja</code>.</dd>
  150.   <dt><strong>Serveurs d'Annotations (Annotation servers)</strong></dt>
  151.     <dd>Ce champ dΘfinit les serveurs d'annotations α interroger lorsque
  152.       Amaya cherche une annotation. Vous pouvez spΘcifier un ou plusieurs
  153.       serveurs. Le nom de serveur <strong>localhost</strong> est rΘservΘ, il
  154.       indique α Amaya de chercher localement les annotations. Cela ne
  155.       signifie pas que l'on utilise un serveur pour les annotations locale,
  156.       pour cela il faudrait donner l'URL complΦte de celui-ci. Sous Unix, les
  157.       serveurs d'annotations sont spΘcifiΘs α la suite, sΘparΘs par un
  158.       espace. Sous Windows, ils sont spΘcifiΘs les uns aprΦs les autres et
  159.       sΘparΘs par la touche <code>Return</code>. Par dΘfaut, ce champ est
  160.       initialisΘ avec <code>localhost</code>. 
  161.       <p><em>ASTUCE</em>: Vous pouvez inhiber la consultation d'un serveur
  162.       d'annotations en prΘfixant l'URL du serveur avec le caractΦre '-'.</p>
  163.     </dd>
  164.   <dt><strong>Chargement automatique des annotations locales et distantes
  165.   (Autoload annotations)</strong></dt>
  166.     <dd>Ces options indiquent α Amaya de rechercher automatiquement ou non
  167.       les annotations lorsqu'une nouvelle URL est chargΘe. Si elles ne sont
  168.       pas positionnΘes alors l'utilisateur doit explicitement sΘlectionner
  169.       l'entrΘe <strong>Charger les annotations</strong> pour visualiser
  170.       celles-ci. Il peut y avoir un certain dΘlai lorsque Amaya charge les
  171.       annotations distantes, ce dΘlai Θtant du α la rΘsolution du nom DNS des
  172.       serveurs d'annotations. Par dΘfaut, ces options sont dΘsactivΘes.</dd>
  173.   <dt><strong>DΘsactiver le chargement automatique des annotations
  174.   distantes</strong></dt>
  175.     <dd>Lorsque cette option est activΘe, Amaya rΘinitialise l'option
  176.       <code>Chargement automatique des annotations distantes</code> au
  177.       dΘmarrage. Cela est trΦs utile si vous travaillez en mode dΘconnectΘ de
  178.       temps en temps et que vous voulez continuer α charger automatiquement
  179.       les annotations locales tout en rechargeant les annotations distantes
  180.       lorsque vous Ωtes connectΘs.</dd>
  181.   <dt><strong>Serveur de publication des annotations (Annotation Post
  182.   Server)</strong></dt>
  183.     <dd>Ce champ dΘfinit le serveur sur lequel les annotations sont
  184.       enregistrΘes. Les annotations locales sont toujours sauvegardΘes dans
  185.       un rΘpertoire local, sans tenir compte de ce champ. Par dΘfaut, il est
  186.       vide. Il est α noter que le serveur sur lequel les annotations
  187.       distantes sont enregistrΘes n'est pas nΘcessairement inclus dans la
  188.       liste des serveurs interrogΘs; pour cela, vous devez rentrer son nom
  189.       dans chacun des deux champs, dans l'ordre que vous voulez.</dd>
  190. </dl>
  191.  
  192. <h3 id="Creating">CrΘer une annotation</h3>
  193.  
  194. <p>La version courante d'Amaya supporte deux sortes d'annotations: celles qui
  195. s'appliquent sur le document entier et celles qui s'appliquent sur une partie
  196. ou une sΘlection du document. Pour annoter un document entier, sΘlectionnez
  197. l'entrΘe <strong>Annoter le document</strong> du menu
  198. <strong>Annotations</strong>. Pour annoter une partie, placez le curseur sur
  199. la partie dΘsirΘe et sΘlectionnez l'entrΘe <strong>Annoter la
  200. sΘlection</strong>. Pour annoter la sΘlection, utilisez la mΩme entrΘe aprΦs
  201. avoir fait la sΘlection dΘsirΘe. Dans tous les cas, une fenΩtre d'annotation
  202. s'affichera (figure suivante). Le contenu de cette fenΩtre montre les
  203. mΘta-donnΘes de l'annotation α l'intΘrieur d'un cadre et le
  204. <strong>corps</strong> de l'annotation α l'extΘrieur.</p>
  205.  
  206. <p style="text-align: center"><img src="../images/annotationwindow.png"
  207. alt="annotation window" /></p>
  208.  
  209. <p></p>
  210.  
  211. <p>Les mΘta-donnΘes actuellement dΘfinies pour une annotation indiquent le
  212. <strong>nom de son auteur</strong>, le <strong>titre du document
  213. annotΘ</strong> (Θgalement appelΘ document source), le <strong>type de
  214. l'annotation</strong>, sa <strong>date de crΘation</strong> et la
  215. <strong>date de sa derniΦre modification</strong>. Certaines de ces
  216. mΘta-donnΘes ont des propriΘtΘs spΘcifiques. Ainsi, le champ <strong>document
  217. source</strong> est Θgalement un lien qui pointe sur le texte annotΘ. Si
  218. l'utilisateur double-clique dessus (comme pour tout lien dans Amaya) alors le
  219. document annotΘ est affichΘ en premier plan et le texte annotΘ est mis en
  220. Θvidence. La mΘta-donnΘe <strong>type de l'annotation</strong> permet α
  221. l'utilisateur de classer les annotations et de changer leur type. Un
  222. double-clic sur ce champ montre la liste des types disponibles. Nous
  223. prΘciserons plus loin comment un utilisateur peut dΘfinir son propre type
  224. d'annotation. Enfin, la mΘta-donnΘe <strong>date de derniΦre
  225. modification</strong> est automatiquement mise α jour lorsque l'annotation
  226. est sauvegardΘe.</p>
  227.  
  228. <p>Sous l'entΩte de l'annotation se trouve le <strong>corps</strong> de
  229. celle-ci. Il montre son contenu courant et peut Ωtre ΘditΘ comme n'importe
  230. quel document HTML. Il est α noter que la version courante d'Amaya ne
  231. supporte pas les images dans le corps des annotations et que certaines des
  232. fonctionnalitΘs de celles-ci ne sont pas encore disponibles, comme la vue
  233. structure par exemple.</p>
  234.  
  235. <p>Sauver une annotation revient α sauver n'importe quel autre document,
  236. l'utilisateur doit juste sΘlectionner l'entrΘe <strong>Sauver</strong> du
  237. menu <strong>Fichier</strong> ou cliquer sur le bouton Θquivalent ou bien
  238. activer le raccourci-clavier correspondant. Les annotations locales sont
  239. sauvΘes sous le rΘpertoire des annotations et les annotations distantes sont
  240. sauvΘes sous le serveur d'annotation correspondant, si l'utilisateur possΦde
  241. un droit d'Θcriture dessus. Pour transformer une annotation locale en une
  242. annotation publique (distante), l'utilisateur doit utiliser l'entrΘe
  243. <strong>Enregistrer les annotations</strong>, elles seront alors enregistrΘes
  244. sous le serveur dΘfini dans le menu de configuration puis, en cas de succΦs,
  245. supprimΘes du rΘpertoire local. La sauvegarde des annotations se fera alors
  246. directement sur le serveur d'annotations. Dans la version initiale des
  247. annotations, l'opΘration inverse (transfert d'une annotation distante dans le
  248. rΘpertoire local) n'est pas supportΘe .</p>
  249.  
  250. <p>Certaines commandes accessibles dans la vue principale d'Amaya sont
  251. Θgalement disponibles pour les annotation comme par exemple le commande
  252. <strong>Imprimer</strong> qui imprime le corps de l'annotation ou la commande
  253. <strong>Recharger</strong>.</p>
  254.  
  255. <h3 id="Deleting1">DΘtruire une annotation</h3>
  256.  
  257. <p>La commande <strong>DΘtruire une annotation</strong> du menu de la fenΩtre
  258. d'annotation vous permet de supprimer celle-ci. Vous pouvez Θgalement
  259. supprimer une annotation α partir du document annotΘ en sΘlectionnant l'ic⌠ne
  260. de celle-ci puis en appelant cette commande dans le menu du document
  261. annotΘ.</p>
  262.  
  263. <h3 id="Loading">Charger et prΘsenter les annotations</h3>
  264.  
  265. <p>La commande <strong>Charger les annotations</strong> indique α Amaya de
  266. rechercher les annotations associΘes α l'URL du document chargΘ dans la vue
  267. principale. Amaya va alors rechercher les annotations correspondantes dans
  268. les serveurs d'annotations dΘfinis par le <strong>menu de
  269. Configuration</strong>. Les annotations peuvent Θgalement Ωtre chargΘes
  270. automatiquement en choisissant l'option <strong>Autoload annotations</strong>
  271. dans le menu de configuration. Dans la version actuelle des annotations, la
  272. recherche sur un serveur d'annotations retourne <strong>toutes</strong> les
  273. annotations associΘes α un document. Dans une prochaine version, il sera
  274. possible de mieux cibler la requΩte envoyΘe aux serveurs.</p>
  275.  
  276. <p>L'entrΘe <strong>Filtre local</strong> permet α l'utilisateur de montrer
  277. ou de cacher les ic⌠nes d'annotation dans un document annotΘ pour mieux se
  278. concentrer par exemple sur ce qui l'intΘresse ou pour faciliter la lecture
  279. d'un document annotΘ. L'utilisateur peut filtrer ces ic⌠nes selon trois
  280. critΦres: le <strong>nom de l'auteur</strong> de l'annotation, le
  281. <strong>type</strong> de l'annotation et le <strong>nom du serveur</strong>
  282. d'annotations. Pour appliquer chacun de ces filtres, cliquez sur le texte
  283. correspondant pour sΘlectionner un type donnΘ d'annotation puis sur le bouton
  284. correspondant α l'action. Les commandes <strong>Montrer Tout</strong> et
  285. <strong>Cacher Tout</strong> s'appliquent sur l'ensemble des annotations. On
  286. prefixe chaque entrΘe du menu d'un espace (' '), d'une Θtoile ('*') et d'un
  287. tirΘ ('-') pour indiquer que toutes les annotations appartenant α une
  288. catΘgorie donnΘe sont visibles, cachΘes ou partiellement cachΘes,
  289. respectivement.</p>
  290.  
  291. <p>Il est α noter que le menu Filtre vous montre l'Θtat courant du document
  292. au moment o∙ le filtre est invoquΘ. Si vous ajoutez des nouvelles annotations
  293. entre temps, le filtre ne les montrera pas. Il faudra appuyer sur le bouton
  294. terminer et le rappeler pour voir le nouvel Θtat.</p>
  295.  
  296. <p>Pour chaque annotation, le nom de l'utilisateur est obtenu en concatΘnant
  297. le nom de l'auteur et le nom du serveur d'annotations sur lequel celle-ci est
  298. enregistrΘe, comme montrΘ dans la figure suivante.</p>
  299.  
  300. <p></p>
  301.  
  302. <p style="text-align: center"><img src="../images/localfilter.png"
  303. alt="local filter dialog box" /></p>
  304.  
  305. <h3 id="Navigating">Activer des annotations</h3>
  306.  
  307. <p>Les annotations apparaissent dans la vue <strong>Liens</strong> du
  308. document annotΘ (avec les autres liens dΘfinis dans ce document) et sont
  309. symbolisΘes par la mΩme ic⌠ne que dans la vue principale. La vue Liens montre
  310. toutes les annotations du document sans tenir compte du fait qu'elles aient
  311. ΘtΘ ou non cachΘes par le menu <strong>Filtrer</strong>. Comme dans la vue
  312. principale, un simple-clic sur l'ic⌠ne met en Θvidence le partie annotΘe du
  313. document et un double-clic ouvre l'annotation. La figure ci-dessous montre un
  314. exemple de navigation d'un lien d'annotation vers un autre mΩme si
  315. l'annotation ne peut Ωtre vue par tous les utilisateurs α cause d'une
  316. indisponibilitΘ ou des caractΘristiques du support utilisΘ.</p>
  317.  
  318. <p style="text-align: center"><img src="../images/linkwindow.png"
  319. alt="Link window shows annotations" /></p>
  320.  
  321. <h3 id="Moving">DΘplacer des annotations</h3>
  322.  
  323. <p>Amaya vous permet Θgalement de deplacer une annotation vers un autre
  324. endroit du document, par exemple pour rattacher des <a
  325. href="Annotations.html#Issues1">annotations trompeuses ou orphelines</a>.
  326. Vous pouvez dΘplacer une annotation soit vers la sΘlection courante, soit
  327. vers la valeur d'un XPointer. Actuellemnt, on ne peut dΘplacer des
  328. annotations que dans le document o∙ elles ont ΘtΘ crΘΘes.</p>
  329.  
  330. <p>Pour dΘplacer une annotation vers la sΘlection courante, il faut dßbord
  331. ouvrir une fenΩtre d'annotation et sΘlectionner une partie du document
  332. annotΘ. Puis, dans la fenΩtre d'annotation, appeler le menu
  333. <strong>Annotations/Move to selection</strong>. Amaya dΘplace alors l'ic⌠ne
  334. de l'annotation vers la partie sΘlectionnΘe et considΦre l'annotation comme
  335. modifiΘe. Pour rendre ce changement effectif, vous devrez la sauver. De la
  336. mΩme maniΦre que pour la crΘation, vous pouvez dΘplacer une annotation vers
  337. la position courante du curseur sans avoir besoin de faire la sΘlection.</p>
  338.  
  339. <p>Pous pouvez aussi mΘmoriser la position o∙ vous voulez dΘplacer une
  340. annotation, par exemple pour dΘplacer plusieurs annotations vers le mΩme
  341. endroit ou pour se dΘplacer dans la fenΩtre avant de faire la manipulation.
  342. Pour cela, faire la sΘlection (ou placer le curseur) α l'endroit dΘsirΘ puis,
  343. utiliser le menu <strong>Link/Store link as XPointer</strong> pour crΘer un
  344. XPointer reprΘsentant cette sΘlection. Enfin, dans la fenΩtre d'annotation,
  345. utiliser le menu <strong>Annotations/Move to stored XPointer</strong> pour
  346. dΘplacer l'annotation α la nouvelle position. Comme prΘcΘdemment, vous devrez
  347. sauver l'annotation pour rendre ce changement effectif.</p>
  348.  
  349. <h3 id="Threads">RΘpondre aux annotations / fils de discussion</h3>
  350.  
  351. <p>Les annotations peuvent Ωtre considΘrΘes comme des commentaires sur des
  352. documents. La commande <strong>RΘpondre α l'annotation</strong> Θlargit
  353. l'espace de travail collaboratif en permettant aux utilisateurs de rΘpondre
  354. aux annotations des autres utilisateurs ainsi qu'aux autres rΘponses</p>
  355.  
  356. <p>L'utilisateur peut appeler cette commande depuis la fenΩtre d'une
  357. annotation ou depuis la fenΩtre d'une rΘponse. Une nouvelle fenΩtre de
  358. rΘponse est alors ouverte. Les champs de cette fenΩtre peuvent Ωtre ΘditΘs de
  359. le mΩme maniΦre que ceux d'une fenΩtre d'annotation (voir <a
  360. href="#Creating">CrΘer une annotation</a>).</p>
  361.  
  362. <p>Quand la rΘponse est terminΘe, l'utilisateur peut la poster sur un serveur
  363. par α la commande <strong>Enregistrer sur le serveur</strong> ou la sauver
  364. localement par la commande <strong>Fichier / Sauver</strong>. La commande
  365. <strong>Annotations / DΘtruire</strong> supprime la rΘponse.</p>
  366.  
  367. <p>Les rΘponses peuvent Θgalement Ωtre annotΘes comme n'importe quel document
  368. comme expliquΘ dans la section <a href="#Creating">CrΘer une
  369. annotation</a>.</p>
  370.  
  371. <h2>Interface utilisateur</h2>
  372.  
  373. <p><img alt="An annotation with a discussion thread"
  374. src="../images/threads.png" /></p>
  375.  
  376. <p>Toutes les rΘponses relatives α une mΩme annotation sont affichΘes en
  377. dessous de celle-ci, dans une section "fil". Chaque ΘlΘment du fil donne la
  378. date de la rΘponse, son auteur et son titre. Le contenu de chacune des
  379. rΘponses est accessible en double-cliquant sur la rΘponse dans le fil. La
  380. rΘponse sΘlectionnΘe est mise en sur-brillance et prΘsentΘe dans une nouvelle
  381. fenΩtre de rΘponse. Lorsqu'une autre rΘponse est sΘlectionnΘe, la mΩme
  382. fenΩtre de rΘponse est utilisΘe.</p>
  383.  
  384. <h2>ProblΦmes connus: fils incomplets</h2>
  385.  
  386. <p>Il n'y a pas encore de contr⌠le pour dΘterminer quelle rΘponse devrait
  387. Ωtre postΘe. Dans l'absolu, il ne devrait pas Ωtre possible de poster une
  388. rΘponse α une rΘponse sur un autre serveur que la rΘponse elle-mΩme. De mΩme,
  389. si vous supprimez une rΘponse vous devriez supprimer toutes les rΘponses se
  390. rapportant α l'annotation. Sans cela, vous pouvez avoir des fragments du fil
  391. qui ne peuvent Ωtre correctement rattachΘs α celui-ci. Par exemple, soit R1
  392. une rΘponse α l'annotation A1 et R2 une rΘponse α R1. Si vous postez R1 et
  393. sauvez localement R2 et si vous visualisez A1 en chargeant uniquement les
  394. annotations locales, alors seule R2 sera visible. A ce niveau, Amaya ne sait
  395. pas que R1 existe et suppose que R2 a perdu sa rΘponse "mΦre". On identifie
  396. ces fils "orphelins" en plaτant devant un point d'interrogation. Si par la
  397. suite Amaya trouve de nouveaux ΘlΘments du fil, par exemple en chargeant R1,
  398. il les triera correctement. Dans notre exemple, la rΘponse R2 deviendra fille
  399. de R1, comme attendu.</p>
  400. </div>
  401.  
  402. <div id="Issues">
  403. <h3 id="Issues1">ProblΦmes relatifs aux annotations et aux documents
  404. modifiΘs</h3>
  405.  
  406. <p>Si vous utilisez les annotations sur des documents dont le contenu peut
  407. Ωtre modifiΘ, deux catΘgories de problΦmes peuvent survenir: les
  408. <strong>annotations orphelines</strong> et les <strong>annotations
  409. trompeuses.</strong> Avant d'aller plus loin sur ces problΦmes, nous allons
  410. d'abord dΘcrire comment Amaya relie les annotations aux documents annotΘs.</p>
  411.  
  412. <p>Pour cela, Amaya utilise le mΘcanisme <strong><a
  413. href="http://www.w3.org/XML/Linking">XPointer</a></strong>. Les XPointers
  414. reposent sur la structure du document. Pour construire un XPointer, par
  415. exemple pour une sΘlection, on part du premier point de la sΘlection et on
  416. remonte α travers la structure du document jusqu'α trouver la racine de
  417. celui-ci. Si un ΘlΘment possΦde un attribut ID, on arrΩte la recherche et on
  418. considΦre que le dΘbut du XPointer est cet ΘlΘment. Par exemple, en regardant
  419. le source HTML de cette documentation, on s'aperτoit que la section courante
  420. est α l'intΘrieur d'un ΘlΘment DIV, lequel possΦde un attribut ID avec la
  421. valeur "Issues". Voici un extrait du code source:</p>
  422. <pre>  <div id="Issues">
  423.   <h3>>ProblΦmes sur ....</h3>>
  424.   <p>Si vous utilisez ...</p>
  425.   <p>Pour cela, Amaya utilise le mΘcanisme <strong>XPointer</strong>...</p>
  426.   ...
  427.   </div></pre>
  428.  
  429. <p>Et voici le XPointer qui pointe sur le second paragraphe:</p>
  430.  
  431. <p style="text-align: center"><code>xpointer(id("Issues")/p[2])</code></p>
  432.  
  433. <p>Le XPointer ci-dessus pointe sur le second ΘlΘment <code>p</code> α partir
  434. de l'ΘlΘment parent qui possΦde l'attribut ID avec la valeur "Issues".
  435. L'utilisation de l'attribut ID permet α l'auteur du document de dΘplacer la
  436. totalitΘ de cette section n'importe o∙ dans le document sans avoir besoin de
  437. remettre α jour le Xpointer correspondant. Ce dernier de dΘpend pas des
  438. ΘlΘments qui prΘcΦdent cette section.</p>
  439.  
  440. <p>Une annotation est dite <strong>orpheline</strong> lorsqu'elle ne peut
  441. plus Ωtre rattachΘe au document, c'est α dire quand le Xpointer ne trouve
  442. plus l'ΘlΘment correspondant dans la structure du document. Cela arrive
  443. notamment quand la structure est modifiΘe. Par exemple, le Xpointer prΘcΘdent
  444. ne pourrait plus retrouver l'ΘlΘment correspondant si l'on supprimait
  445. l'attribut ID de celui-ci. Amaya avertit l'utilisateur s'il dΘtecte une
  446. annotation orpheline au chargement. Les annotations orphelines sont visibles
  447. dans la vue <strong>Liens</strong> du document et sont symbolisΘes par
  448. l'ic⌠ne des annotations sur laquelle est superposΘ un point d'interrogation
  449. <img src="../images/annotorp.png" alt="Orphan annotation icon" />.</p>
  450.  
  451. <p>Une annotation est dite <strong>trompeuse</strong> lorsqu'elle ne pointe
  452. pas sur la bonne partie du document. En reprenant notre exemple, nous pouvons
  453. crΘer une annotation trompeuse en intervertissant le premier et le second
  454. paragraphe. Le Xpointer continuera de pointer vers le second paragraphe bien
  455. qu'il devrait pointer dΘsormais sur le premier. Ce problΦme est encore plus
  456. frΘquent lorsque vous annotez un texte qui peut changer. Dans sa version
  457. actuelle, Amaya n'avertit pas l'utilisateur des annotations trompeuses. Une
  458. prochaine version l'avertira de la possibilitΘ d'une annotation d'Ωtre
  459. trompeuse.</p>
  460.  
  461. <p>Comment Θviter ces problΦmes ?</p>
  462.  
  463. <p>Si vous Ωtes l'auteur du document, utilisez les attributs ID aux endroits
  464. stratΘgiques, par exemple pour les ΘlΘments DIV. Amaya vous permet d'associer
  465. ou de retirer automatiquement un attribut ID en sΘlectionnant l'entrΘe
  466. <strong>Ajouter/Retirer des attributs ID</strong> du menu
  467. <strong>SpΘcial</strong>. Dans notre exemple, on peut Θviter le problΦme des
  468. annotations trompeuses en ajoutant un attribut ID au second paragraphe:</p>
  469. <pre>  <p id="Amaya">Pour cela, Amaya utilise...</p></pre>
  470.  
  471. <p>Un XPointer qui pointe sur ce paragraphe est alors</p>
  472.  
  473. <p style="text-align: center"><code>xpointer(id("Amaya"))</code></p>
  474.  
  475. <p>Ainsi, ce Xpointer pointera toujours sur le mΩme paragraphe, sans se
  476. soucier de la position de celui-ci dans la structure du document.</p>
  477. </div>
  478.  
  479. <p><a href="MakeBook.html.fr"><img alt="previous" src="../images/left.gif"
  480. /></a> <a href="Manual.html.fr"><img alt="top" src="../images/up.gif" /></a>
  481. <a href="Configure.html.fr"><img alt="next" src="../images/right.gif"
  482. /></a></p>
  483. <hr />
  484. </body>
  485. </html>
  486.