GameStar 2005 May

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 / Annotations.html.fr < prev next >

Wrap

Extensible Markup Language | 2005-02-23 | 22.0 KB | 416 lines

<?xml version="1.0" encoding="iso-8859-1"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>Annotations</title> <meta name="GENERATOR" content="amaya 9.1, see http://www.w3.org/Amaya/" /> <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" /> <link href="style.css" rel="stylesheet" type="text/css" /> </head> <body xml:lang="fr" lang="fr"> <div> <img alt="Amaya" src="../../resources/icons/22x22/logo.png" class="logo" /> <a href="MakeBook.html.fr" accesskey="p"><img alt="previous" src="../../resources/icons/misc/left.png" /></a> <a href="Manual.html.fr" accesskey="t"><img alt="top" src="../../resources/icons/misc/up.png" /></a> <a href="Configure.html.fr" accesskey="n"><img alt="next" src="../../resources/icons/misc/right.png" /></a> </div> <ul> <li><a href="Annotations.html.fr#def">DΘfinition</a></li> <li><a href="Annotations.html.fr#Local">Annotations locales et distantes</a></li> <li><a href="Annotations.html.fr#Annotation">Menu des annotations</a></li> <li><a href="Annotations.html.fr#Configurat">Menu de configuration pour les annotations</a></li> <li><a href="Annotations.html.fr#Creating">CrΘer une annotation</a></li> <li><a href="Annotations.html.fr#Deleting1">Supprimer une annotation</a></li> <li><a href="Annotations.html.fr#Loading">Charger et afficher une annotations</a></li> <li><a href="Annotations.html.fr#Navigating">Activer des annotations</a></li> <li><a href="Annotations.html.fr#Moving">DΘplacer des annotations</a></li> <li><a href="#Threads">RΘpondre α une annotation / fils de discussion</a></li> <li><a href="Annotations.html.fr#Issues1">ProblΦmes relatifs aux annotations et aux documents modifiΘs</a></li> </ul> <div id="Annotations"> <h2><a name="L1065">Les annotations dans Amaya</a></h2> <h3 id="def">DΘfinition</h3> Une annotation est un commentaire, une note, une explication ou tout autre remarque externe qui peut Ωtre attachΘe α un document web ou α une partie de celui-ci. Comme les annotations dans Amaya sont externes au document, il est possible d'annoter n'importe quel document du web, mΩme sans avoir le droit de le modifier. D'un point de vue technique, une annotation peut Ωtre vue comme une mΘta-donnΘe puisqu'elle fournit une information supplΘmentaire sur une donnΘe existante. Dans Amaya, nous utilisons un <a href="http://www.w3.org/2000/10/annotation-ns">schΘma</a> <a href="http://www.w3.org/RDF/">RDF</a> pour dΘcrire les annotations. Les annotations peuvent Ωtre enregistrΘes localement ou sur un ou plusieurs serveur(s) d'annotations. Lorsqu'un document est chargΘ, Amaya interroge chacun de ces serveurs et recherche les annotations relatives α ce document. Chaque annotation est ensuite reprΘsentΘe par l'ic⌠ne suivante <img src="../images/annot.png" alt="Crayon representant une annotation" /> qui est ajoutΘe au document (voir figure ci-dessous). Lorsque l'utilisateur clique sur l'ic⌠ne d'annotation, le passage annotΘ est mis en Θvidence. Si l'utilisateur double-clique sur l'ic⌠ne alors le contenu de l'annotation ainsi que les autres mΘta-donnΘes lui sont prΘsentΘes dans une nouvelle fenΩtre. <img src="../images/annotationicon.png" alt="annotation icon (= pencil)" /> Une annotation possΦde plusieurs propriΘtΘsá: <ul> <li>Point de stockage: dans le systΦme de fichiers de l'utilisateur ou sur un serveur d'annotations</li> <li>Etendue : l'annotation est associΘe α un document entier ou α une fragment de celui-ci</li> <li>Type de l'annotation: 'Annotation', 'Comment', 'Query', ...</li> </ul> <h3 id="Local">Annotations locales et distantes</h3> Amaya peut sauver les annotations dans un fichier local (annotations locales) ou sur le Web (annotations distantes). Les annotations distantes sont enregistrΘes sur des serveurs d'annotations et peuvent Ωtre chargΘes ou enregistrΘes par quiconque ayant les droits d'accΦs correspondants, comme pour les autres documents HTML. Les annotations distantes sont dites partagΘes ou publiques parce qu'elles peuvent Ωtre vues par plusieurs personnes. Si vous dΘsirez installer votre propre serveur d'annotations, veuillez vous rΘfΘrer au document "<a href="http://www.w3.org/1999/02/26-modules/User/Annotations-HOWTO.html">Annotation-Server HOWTO</a>". Les annotations locales ne nΘcessitent pas l'utilisation de serveur. Elles sont enregistrΘes sous le rΘpertoire de configuration d'Amaya, dans un rΘpertoire spΘcifique appelΘ <code>annotations</code> et peuvent Ωtre visualisΘes uniquement par leur auteur (selon les droits d'accΦs en fonction). Ce rΘpertoire comporte trois sortes de fichiers: <dl> <dt>annot.index</dt> <dd>les URL associΘes aux fichiers dans lesquels les mΘta-donnΘes des annotations sont sauvegardΘes.</dd> <dt>index + random suffix</dt> <dd>un fichier contenant les mΘta-donnΘes d'une annotation relative α une URL. Les mΘta-donnΘes sont spΘcifiΘes avec RDF.</dd> <dt>annot + random suffix.html</dt> <dd>contient le corps de l'annotation enregistrΘe en XHTML.</dd> </dl> Un utilisateur peut α tout moment transformer une annotation locale en une annotation partagΘe en utilisant l'entrΘe Enregistrer une annotation du menu Annotations. Si cette commande rΘussit, l'annotation est supprimΘe localement et transfΘrΘe sur un serveur d'annotations. La section suivante dΘcrit comment dΘfinir le nom du serveur d'annotations sur lequel les annotations distantes sont enregistrΘes. <h3 id="Annotation">Menu des annotations</h3> La plupart des commandes utilisΘes pour la gestion des annotations se trouvent dans le menu d'annotations reprΘsentΘ ci dessous. <img src="../images/annotationsmenu-fr.png" alt="Annotations menu" /> <h3 id="Creating">CrΘer une annotation</h3> La version courante d'Amaya supporte deux sortes d'annotations: celles qui s'appliquent sur le document entier et celles qui s'appliquent sur une partie ou une sΘlection du document. Pour annoter un document entier, sΘlectionnez l'entrΘe Annoter le document du menu Annotations. Pour annoter une partie, placez le curseur sur la partie dΘsirΘe et sΘlectionnez l'entrΘe Annoter la sΘlection. Pour annoter la sΘlection, utilisez la mΩme entrΘe aprΦs avoir fait la sΘlection dΘsirΘe. Dans tous les cas, une fenΩtre d'annotation s'affichera (figure suivante). Le contenu de cette fenΩtre montre les mΘta-donnΘes de l'annotation α l'intΘrieur d'un cadre et le corps de l'annotation α l'extΘrieur. <img src="../images/annotationwindow.png" alt="annotation window" /> Les mΘta-donnΘes actuellement dΘfinies pour une annotation indiquent le nom de son auteur, le titre du document annotΘ (Θgalement appelΘ document source), le type de l'annotation, sa date de crΘation et la date de sa derniΦre modification. Certaines de ces mΘta-donnΘes ont des propriΘtΘs spΘcifiques. Ainsi, le champ document source est Θgalement un lien qui pointe sur le texte annotΘ. Si l'utilisateur double-clique dessus (comme pour tout lien dans Amaya) alors le document annotΘ est affichΘ en premier plan et le texte annotΘ est mis en Θvidence. La mΘta-donnΘe type de l'annotation permet α l'utilisateur de classer les annotations et de changer leur type. Un double-clic sur ce champ montre la liste des types disponibles. Nous prΘciserons plus loin comment un utilisateur peut dΘfinir son propre type d'annotation. Enfin, la mΘta-donnΘe date de derniΦre modification est automatiquement mise α jour lorsque l'annotation est sauvegardΘe. Sous l'entΩte de l'annotation se trouve le corps de celle-ci. Il montre son contenu courant et peut Ωtre ΘditΘ comme n'importe quel document HTML. Il est α noter que la version courante d'Amaya ne supporte pas les images dans le corps des annotations et que certaines des fonctionnalitΘs de celles-ci ne sont pas encore disponibles, comme la vue structure par exemple. Sauver une annotation revient α sauver n'importe quel autre document, l'utilisateur doit juste sΘlectionner l'entrΘe Sauver du menu Fichier ou cliquer sur le bouton Θquivalent ou bien activer le raccourci-clavier correspondant. Les annotations locales sont sauvΘes sous le rΘpertoire des annotations et les annotations distantes sont sauvΘes sous le serveur d'annotation correspondant, si l'utilisateur possΦde un droit d'Θcriture dessus. Pour transformer une annotation locale en une annotation publique (distante), l'utilisateur doit utiliser l'entrΘe Enregistrer les annotations, elles seront alors enregistrΘes sous le serveur dΘfini dans le menu de configuration puis, en cas de succΦs, supprimΘes du rΘpertoire local. La sauvegarde des annotations se fera alors directement sur le serveur d'annotations. Dans la version initiale des annotations, l'opΘration inverse (transfert d'une annotation distante dans le rΘpertoire local) n'est pas supportΘe . Certaines commandes accessibles dans la vue principale d'Amaya sont Θgalement disponibles pour les annotation comme par exemple le commande Imprimer qui imprime le corps de l'annotation ou la commande Recharger. <h3 id="Deleting1">DΘtruire une annotation</h3> La commande DΘtruire une annotation du menu de la fenΩtre d'annotation vous permet de supprimer celle-ci. Vous pouvez Θgalement supprimer une annotation α partir du document annotΘ en sΘlectionnant l'ic⌠ne de celle-ci puis en appelant cette commande dans le menu du document annotΘ. <h3 id="Loading">Charger et prΘsenter les annotations</h3> La commande Charger les annotations indique α Amaya de rechercher les annotations associΘes α l'URL du document chargΘ dans la vue principale. Amaya va alors rechercher les annotations correspondantes dans les serveurs d'annotations dΘfinis par le menu de Configuration. Les annotations peuvent Θgalement Ωtre chargΘes automatiquement en choisissant l'option Autoload annotations dans le menu de configuration. Dans la version actuelle des annotations, la recherche sur un serveur d'annotations retourne toutes les annotations associΘes α un document. Dans une prochaine version, il sera possible de mieux cibler la requΩte envoyΘe aux serveurs. L'entrΘe Filtre local permet α l'utilisateur de montrer ou de cacher les ic⌠nes d'annotation dans un document annotΘ pour mieux se concentrer par exemple sur ce qui l'intΘresse ou pour faciliter la lecture d'un document annotΘ. L'utilisateur peut filtrer ces ic⌠nes selon trois critΦres: le nom de l'auteur de l'annotation, le type de l'annotation et le nom du serveur d'annotations. Pour appliquer chacun de ces filtres, cliquez sur le texte correspondant pour sΘlectionner un type donnΘ d'annotation puis sur le bouton correspondant α l'action. Les commandes Montrer Tout et Cacher Tout s'appliquent sur l'ensemble des annotations. On prΘfixe chaque entrΘe du menu d'un espace (' '), d'une Θtoile ('*') et d'un tirΘ ('-') pour indiquer que toutes les annotations appartenant α une catΘgorie donnΘe sont visibles, cachΘes ou partiellement cachΘes, respectivement. Il est α noter que le menu Filtre vous montre l'Θtat courant du document au moment o∙ le filtre est invoquΘ. Si vous ajoutez des nouvelles annotations entre temps, le filtre ne les montrera pas. Il faudra appuyer sur le bouton terminer et le rappeler pour voir le nouvel Θtat. Pour chaque annotation, le nom de l'utilisateur est obtenu en concatΘnant le nom de l'auteur et le nom du serveur d'annotations sur lequel celle-ci est enregistrΘe, comme montrΘ dans la figure suivante. <img src="../images/localfilter.png" alt="local filter dialog box" /> <h3 id="Navigating">Activer des annotations</h3> Les annotations apparaissent dans la vue Liens du document annotΘ (avec les autres liens dΘfinis dans ce document) et sont symbolisΘes par la mΩme ic⌠ne que dans la vue principale. La vue Liens montre toutes les annotations du document sans tenir compte du fait qu'elles aient ΘtΘ ou non cachΘes par le menu Filtrer. Comme dans la vue principale, un simple-clic sur l'ic⌠ne met en Θvidence le partie annotΘe du document et un double-clic ouvre l'annotation. La figure ci-dessous montre un exemple de navigation d'un lien d'annotation vers un autre mΩme si l'annotation ne peut Ωtre vue par tous les utilisateurs α cause d'une indisponibilitΘ ou des caractΘristiques du support utilisΘ. <img src="../images/linkwindow.png" alt="Link window shows annotations" /> <h3 id="Moving">DΘplacer des annotations</h3> Amaya vous permet Θgalement de dΘplacer une annotation vers un autre endroit du document, par exemple pour rattacher des <a href="Annotations.html#Issues1">annotations trompeuses ou orphelines</a>. Vous pouvez dΘplacer une annotation soit vers la sΘlection courante, soit vers la valeur d'un XPointer. Actuellement, on ne peut dΘplacer des annotations que dans le document o∙ elles ont ΘtΘ crΘΘes. Pour dΘplacer une annotation vers la sΘlection courante, il faut d'abord ouvrir une fenΩtre d'annotation et sΘlectionner une partie du document annotΘ. Puis, dans la fenΩtre d'annotation, appeler le menu Annotations/Move to selection. Amaya dΘplace alors l'ic⌠ne de l'annotation vers la partie sΘlectionnΘe et considΦre l'annotation comme modifiΘe. Pour rendre ce changement effectif, vous devrez la sauver. De la mΩme maniΦre que pour la crΘation, vous pouvez dΘplacer une annotation vers la position courante du curseur sans avoir besoin de faire la sΘlection. Vous pouvez aussi mΘmoriser la position o∙ vous voulez dΘplacer une annotation, par exemple pour dΘplacer plusieurs annotations vers le mΩme endroit ou pour se dΘplacer dans la fenΩtre avant de faire la manipulation. Pour cela, faire la sΘlection (ou placer le curseur) α l'endroit dΘsirΘ puis, utiliser le menu Annotations/Sauver la sΘlection comme XPointer pour crΘer un XPointer reprΘsentant cette sΘlection. Enfin, dans la fenΩtre d'annotation, utiliser le menu Annotations/DΘplacer sur le XPointer enregistrΘ pour dΘplacer l'annotation α la nouvelle position. Comme prΘcΘdemment, vous devrez sauver l'annotation pour rendre ce changement effectif. <h3 id="Threads">RΘpondre aux annotations / fils de discussion</h3> Les annotations peuvent Ωtre considΘrΘes comme des commentaires sur des documents. La commande RΘpondre α l'annotation Θlargit l'espace de travail collaboratif en permettant aux utilisateurs de rΘpondre aux annotations des autres utilisateurs ainsi qu'aux autres rΘponses L'utilisateur peut appeler cette commande depuis la fenΩtre d'une annotation ou depuis la fenΩtre d'une rΘponse. Une nouvelle fenΩtre de rΘponse est alors ouverte. Les champs de cette fenΩtre peuvent Ωtre ΘditΘs de le mΩme maniΦre que ceux d'une fenΩtre d'annotation (voir <a href="#Creating">CrΘer une annotation</a>). Quand la rΘponse est terminΘe, l'utilisateur peut la poster sur un serveur par α la commande Enregistrer sur le serveur ou la sauver localement par la commande Fichier/Sauver. La commande Annotations/DΘtruire supprime la rΘponse. Les rΘponses peuvent Θgalement Ωtre annotΘes comme n'importe quel document comme expliquΘ dans la section <a href="#Creating">CrΘer une annotation</a>. <h2>Interface utilisateur</h2> <img alt="An annotation with a discussion thread" src="../images/threads.png" /> Toutes les rΘponses relatives α une mΩme annotation sont affichΘes en dessous de celle-ci, dans une section "fil". Chaque ΘlΘment du fil donne la date de la rΘponse, son auteur et son titre. Le contenu de chacune des rΘponses est accessible en double-cliquant sur la rΘponse dans le fil. La rΘponse sΘlectionnΘe est mise en sur-brillance et prΘsentΘe dans une nouvelle fenΩtre de rΘponse. Lorsqu'une autre rΘponse est sΘlectionnΘe, la mΩme fenΩtre de rΘponse est utilisΘe. <h2>ProblΦmes connus: fils incomplets</h2> Il n'y a pas encore de contr⌠le pour dΘterminer quelle rΘponse devrait Ωtre postΘe. Dans l'absolu, il ne devrait pas Ωtre possible de poster une rΘponse α une rΘponse sur un autre serveur que la rΘponse elle-mΩme. De mΩme, si vous supprimez une rΘponse vous devriez supprimer toutes les rΘponses se rapportant α l'annotation. Sans cela, vous pouvez avoir des fragments du fil qui ne peuvent Ωtre correctement rattachΘs α celui-ci. Par exemple, soit R1 une rΘponse α l'annotation A1 et R2 une rΘponse α R1. Si vous postez R1 et sauvez localement R2 et si vous visualisez A1 en chargeant uniquement les annotations locales, alors seule R2 sera visible. A ce niveau, Amaya ne sait pas que R1 existe et suppose que R2 a perdu sa rΘponse "mΦre". On identifie ces fils "orphelins" en plaτant devant un point d'interrogation. Si par la suite Amaya trouve de nouveaux ΘlΘments du fil, par exemple en chargeant R1, il les triera correctement. Dans notre exemple, la rΘponse R2 deviendra fille de R1, comme attendu. </div> <div id="Issues"> <h3 id="Issues1">ProblΦmes relatifs aux annotations et aux documents modifiΘs</h3> Si vous utilisez les annotations sur des documents dont le contenu peut Ωtre modifiΘ, deux catΘgories de problΦmes peuvent survenir: les annotations orphelines et les annotations trompeuses. Avant d'aller plus loin sur ces problΦmes, nous allons d'abord dΘcrire comment Amaya relie les annotations aux documents annotΘs. Pour cela, Amaya utilise le mΘcanisme <a href="http://www.w3.org/XML/Linking">XPointer</a>. Les XPointers reposent sur la structure du document. Pour construire un XPointer, par exemple pour une sΘlection, on part du premier point de la sΘlection et on remonte α travers la structure du document jusqu'α trouver la racine de celui-ci. Si un ΘlΘment possΦde un attribut ID, on arrΩte la recherche et on considΦre que le dΘbut du XPointer est cet ΘlΘment. Par exemple, en regardant le source HTML de cette documentation, on s'aperτoit que la section courante est α l'intΘrieur d'un ΘlΘment DIV, lequel possΦde un attribut ID avec la valeur "Issues". Voici un extrait du code source: <pre> <div id="Issues"> <h3>>ProblΦmes sur ....</h3>> Si vous utilisez ... Pour cela, Amaya utilise le mΘcanisme XPointer... ... </div></pre> Et voici le XPointer qui pointe sur le second paragraphe: <code>xpointer(id("Issues")/p[2])</code> Le XPointer ci-dessus pointe sur le second ΘlΘment <code>p</code> α partir de l'ΘlΘment parent qui possΦde l'attribut ID avec la valeur "Issues". L'utilisation de l'attribut ID permet α l'auteur du document de dΘplacer la totalitΘ de cette section n'importe o∙ dans le document sans avoir besoin de remettre α jour le Xpointer correspondant. Ce dernier de dΘpend pas des ΘlΘments qui prΘcΦdent cette section. Une annotation est dite orpheline lorsqu'elle ne peut plus Ωtre rattachΘe au document, c'est α dire quand le Xpointer ne trouve plus l'ΘlΘment correspondant dans la structure du document. Cela arrive notamment quand la structure est modifiΘe. Par exemple, le Xpointer prΘcΘdent ne pourrait plus retrouver l'ΘlΘment correspondant si l'on supprimait l'attribut ID de celui-ci. Amaya avertit l'utilisateur s'il dΘtecte une annotation orpheline au chargement. Les annotations orphelines sont visibles dans la vue Liens du document et sont symbolisΘes par l'ic⌠ne des annotations sur laquelle est superposΘ un point d'interrogation <img src="../images/annotorp.png" alt="Orphan annotation icon" />. Une annotation est dite trompeuse lorsqu'elle ne pointe pas sur la bonne partie du document. En reprenant notre exemple, nous pouvons crΘer une annotation trompeuse en intervertissant le premier et le second paragraphe. Le Xpointer continuera de pointer vers le second paragraphe bien qu'il devrait pointer dΘsormais sur le premier. Ce problΦme est encore plus frΘquent lorsque vous annotez un texte qui peut changer. Dans sa version actuelle, Amaya n'avertit pas l'utilisateur des annotations trompeuses. Une prochaine version l'avertira de la possibilitΘ d'une annotation d'Ωtre trompeuse. Comment Θviter ces problΦmes ? Si vous Ωtes l'auteur du document, utilisez les attributs ID aux endroits stratΘgiques, par exemple pour les ΘlΘments DIV. Amaya vous permet d'associer ou de retirer automatiquement un attribut ID en sΘlectionnant l'entrΘe Ajouter/Retirer des attributs ID du menu Liens. Dans notre exemple, on peut Θviter le problΦme des annotations trompeuses en ajoutant un attribut ID au second paragraphe: <pre> Pour cela, Amaya utilise...</pre> Un XPointer qui pointe sur ce paragraphe est alors <code>xpointer(id("Amaya"))</code> Ainsi, ce Xpointer pointera toujours sur le mΩme paragraphe, sans se soucier de la position de celui-ci dans la structure du document. </div> </body> </html>