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