Scénarios d'usage et guide d'utilisation

Transcription

1 Scénarios d'usage et guide d'utilisation Copyright Sopinspace Ce guide est soumis aux termes de la licence Creative Commons By-NC-SA ( Co-ment est une marque déposée de Philippe Aigrain. Rédaction du guide : Julie Ducrocq. 1

2 Table des matières A.Usages et domaines d'application de co-ment...5 A.I.SCENARIOS D'USAGE...5 A.I.a.Annotation collaborative d'un texte existant...5 A.I.b.Ecriture collaborative (petit groupe de rédacteurs, ensemble plus vaste de commentateurs)...6 A.I.c.Réactions d'un enseignant, lecteur ou éditeur sur brouillon ou manuscrit (mémoire, livre)...7 A.I.d.Interfaces de lecture...8 A.II.DOMAINES D'APPLICATION...9 A.II.a.Education littéraire et humanités numériques...9 A.II.b.Processus éditoriaux...10 A.II.c.Processus législatifs et programmatiques...11 A.II.d.Analyse juridique et politique...12 A.II.e.Licences et contrats...13 A.II.f.Communication (communiqués de presse, prises de position, lettres ouvertes, tribunes)...14 B.Manuel d'utilisation...15 B.I.ESPACE DE TRAVAIL...17 B.I.a.Débuts sur l'espace de travail...17 B.I.a.i.Se connecter à l'espace de travail...17 B.I.a.ii.Configurer l'espace de travail...18 Paramètres généraux...18 Paramètres d'apparence...19 B.I.a.iii.Editer votre profil utilisateur...19 B.I.a.iv.Modifier votre mot de passe...20 B.I.a.v.Se déconnecter de l'espace de travail...20 B.I.b.Gestion des utilisateurs...20 B.I.b.i.Consulter la liste des utilisateurs...20 B.I.b.ii.Ajouter un nouvel utilisateur à l'espace de travail...21 B.I.b.iii.Ajouter des utilisateurs en masse...21 B.I.b.iv.Autoriser les utilisateurs à s'enregistrer sur l'espace de travail...22 B.I.b.v.Envoyer une invitation à un nouvel utilisateur...22 B.I.b.vi.Editer le profil d'un utilisateur...22 B.I.b.vii.Activer/Désactiver l'accès d'un utilisateur à l'espace de travail...23 B.I.c.Gestion des rôles des utilisateurs...23 B.I.c.i.Choisir le rôle d'un utilisateur...23 Le gestionnaire...24 L'éditeur...24 Le modérateur...24 Le commentateur...24 L'observateur...24 Aucun rôle (-----)...24 B.I.c.ii.Assigner un rôle à un utilisateur sur l'espace de travail...25 B.I.c.iii.Assigner un rôle à un utilisateur sur un texte...25 B.I.c.iv.Définir le rôle des utilisateurs anonymes...26 B.I.c.v.Choisir un modèle de rôles...26 B.I.d.Gestion des textes...27 B.I.d.i.Consulter la liste des textes co-ment

3 B.I.d.ii.Actions possibles depuis la liste de textes...27 B.I.d.iii.Rendre un texte public...28 B.I.e.Suivi de l'activité...28 B.I.e.i.Consulter le tableau de bord...28 B.I.e.ii.S'abonner au flux public...29 B.I.e.iii.S'abonner au flux privé...29 B.I.e.iv.S'abonner aux notifications par B.II.CREATION D'UN TEXTE CO-MENT...31 B.II.a.Rédaction d'un texte...31 B.II.b.Chargement d'un texte...31 B.II.c.Import d'un texte co-menté...32 B.II.d.Choix du format de texte...33 B.II.d.i.Format HTML...33 B.II.d.ii.Format Markdown (version Pandoc)...33 B.II.d.iii.Format RST...33 B.II.d.iv.Format Wikimedia...33 B.II.e.Paramétrages : modération et catégories...33 B.II.e.i.Paramétrer les catégories...34 B.II.e.ii.Modérer les commentaires...34 Modération a posteriori...35 Modération a priori...35 B.III.TRAVAIL SUR UN TEXTE CO-MENT...36 B.III.a.Constitution d'un groupe de travail...36 B.III.b.Présentation de la barre d'outils...36 B.III.c.Annotation du texte...37 B.III.c.i.Ajouter un nouveau commentaire...37 B.III.c.ii.Modifier un commentaire...38 B.III.c.iii.Supprimer un commentaire...38 B.III.c.iv.Rédiger un commentaire en langage Markdown (version Pandoc)...38 B.III.d.Discussion des commentaires...38 B.III.d.i.Répondre à un commentaire...39 B.III.d.ii.Renvoyer à un autre commentaire...39 B.III.e.Affichage et parcours des commentaires...39 B.III.e.i.Afficher les commentaires...39 B.III.e.ii.Filtrer les commentaires...39 B.III.e.iii.Naviguer dans les commentaires...39 B.III.f.Edition du texte...40 B.III.f.i.Modifier un texte co-ment...40 B.III.f.ii.Créer une nouvelle version du texte...40 B.III.f.iii.Conserver/Détacher les commentaires de l'ancienne version...40 B.III.g.Suivi des différentes versions d'un texte...40 B.III.g.i.Consulter la liste des versions...41 B.III.g.ii.Comparer deux versions...41 B.III.g.iii.Revenir à une version antérieure...42 B.III.h.Suivi de l'activité sur le texte...42 B.III.h.i.S'abonner au flux public du texte...42 B.III.h.ii.S'abonner au flux privé du texte...42 B.III.h.iii.S'abonner aux notifications du texte par mail...42 B.III.i.Partage de l'actualité de votre texte sur les réseaux sociaux...43 B.IV.EXPORT/IMPRESSION D'UN TEXTE CO-MENTÉ

4 B.IV.a.Encapsulation...44 B.IV.b.Impression...44 B.IV.b.i.Commentaires...44 B.IV.b.ii.Format...45 B.IV.b.iii.Rendu de la portée des commentaires...45 B.IV.c.Export...45 C.Rappels des éléments principaux de la syntaxe Markdown version Pandoc

5 A. Usages et domaines d'application de co-ment A.I. SCENARIOS D'USAGE A.I.a. Annotation collaborative d'un texte existant Co-ment permet l'annotation collaborative d'un texte existant. Il suffit pour cela de charger un texte depuis votre ordinateur ou de le saisir directement sur votre espace de travail. Constituez ensuite un groupe d'utilisateurs que vous inviterez à venir annoter le texte sur votre plateforme coment. Comment utiliser co-ment? Mettre en ligne le texte que vous souhaitez soumettre à commentaires. Vous pouvez copiercoller un texte, charger un fichier document depuis votre poste de travail ou saisir directement le texte dans le formulaire d'édition de l'espace de travail (voir B.II). Choisir le format de votre texte (voir B.II.d) et le remettre éventuellement en forme. Si besoin, créer des catégories de commentaires. Grâce aux codes couleur associés à chaque catégorie, vous pourrez facilement classer ou filtrer les annotations des contributeurs (voir B.II.e.i) Enregistrer sur votre espace de travail les utilisateurs qui pourront commenter votre texte (voir B.I.b.iii). Leur assigner un rôle : vous définirez ainsi les droits dont ils disposeront sur le texte : observation, commentaire, modération, édition ou gestion (voir B.I.c.i et B.I.c.iii) Si vous souhaitez élargir le cercle des commentateurs, rendre le texte public. Tous les internautes pourront ainsi commenter votre texte sans s'enregistrer sur l'espace de travail (voir B.I.d.iii). Définir le type de modération a priori ou a posteriori appliquée aux commentaires (voir B.II.e.ii). Suivre le travail d'annotation collective grâce au tableau de bord, aux notifications par et aux flux RSS privé et public de l'espace de travail (voir B.III.h). Pour finir, imprimer ou exporter votre texte avec les commentaires (B.IV) Un exemple L'éditeur enotated classics utilise co-ment pour la publication numérique de classiques de la littérature annotés (ebook). Le travail d'annotation est confié à des spécialistes qui travaillent collaborativement et à distance sur un même espace de travail co-ment. Une fois le roman édité sous la forme de livre numérique, les lecteurs accèdent à ces commentaires sous la forme de notes de bas de page. 5

6 Livres numériques annotés édités par enotated classics A.I.b. Ecriture collaborative (petit groupe de rédacteurs, ensemble plus vaste de commentateurs) co-ment permet l'écriture collaborative d'un texte qui sera soumis par la suite à l'appréciation de commentateurs. Vous devez pour cela constituer un petit groupe de rédacteurs et élaborer une première version de votre texte. Mis en ligne sur l'espace de travail co-ment, le document peut alors être annoté par les utilisateurs sélectionnés. Vous poursuivez ensuite le travail de rédaction en tenant compte des remarques du groupe de commentateurs. Comment utiliser co-ment? Elaborer une première ébauche du texte avec un groupe restreint de rédacteurs. Mettre en ligne la première version du texte sur l'espace de travail. Vous avez le choix entre charger le fichier document, copier-coller le texte ou le saisir directement dans le formulaire d'édition (voir B.II) Choisir le format de votre texte (voir B.II.d) et le remettre éventuellement en forme. Si besoin, créer des catégories de commentaires. Grâce aux codes couleur associés à chaque catégorie, vous pourrez facilement classer ou filtrer les annotations des contributeurs (voir B.II.e.i) Inviter sur l'espace de travail les utilisateurs qui pourront commenter votre texte (voir B.I.b.iii) et leur assigner un rôle (voir B.I.c.i). Ce rôle définira les droits dont disposera l'utilisateur sur le texte. Si vous souhaitez élargir le cercle des commentateurs, rendre le texte public. Tous les internautes pourront ainsi commenter votre texte sans s'enregistrer sur l'espace de travail (voir B.I.d.iii). Définir le type de modération a priori ou a posteriori appliquée aux commentaires (voir B.II.e.ii). Suivre le travail d'annotation collective grâce au tableau de bord, aux notifications par 6

7 et aux flux RSS privé et public de l'espace de travail (voir B.III.h). Une fois le processus d'annotation achevé, apporter les modifications souhaitées à votre première version en l'éditant sur l'espace de travail puis créer une nouvelle version de votre document (voir B.III.f). Si nécessaire, inviter vos commentateurs à annoter la nouvelle version de votre document. Les phases d'annotation et d'édition peuvent ainsi se poursuivre jusqu'à ce que la version finale de votre texte soit établie. Un exemple El Partido del Futuro, mouvement politique espagnol créé en janvier 2013, a utilisé co-ment pour l'écriture de son programme Democratia y punto. Le processus d'élaboration de ce programme s'est déroulé en plusieurs étapes. Le mouvement en a rédigé une première version après un débat citoyen. Cette version a ensuite été mise ligne et soumise aux commentaires des internautes via co-ment. La version définitive élaborée à l'issue de cette phase d'annotation est désormais consultable sur le site du Partido del futuro, Annotation du programme Democratia y punto par les internautes (mars 2013) A.I.c. Réactions d'un enseignant, lecteur ou éditeur sur brouillon ou manuscrit (mémoire, livre) co-ment est également un outil adapté aux organisations pédagogiques ou éditoriales souhaitant soumettre un travail à l'appréciation d'un commentateur : lecteur/correcteur, éditeur ou encore enseignant. Le travail d'annotation achevé, le texte peut être imprimé ou exporté avec les commentaires. Comment utiliser co-ment? Charger sur l'espace de travail le fichier document du texte à commenter. Vous pouvez également copier-coller le texte dans le formulaire d'édition (voir B.II) 7

8 Choisir le format du texte (voir B.II.d) et le remettre éventuellement en forme. Si besoin, créer des catégories de commentaires. Grâce aux codes couleur associés à chaque catégorie, vous pourrez ainsi facilement classer ou filtrer les commentaires. (voir B.II.e.i) Si vous n'êtes pas en charge du travail d'annotation, enregistrer et inviter le commentateur sur l'espace de travail. Lui assigner ensuite un rôle en fonction des droits que vous souhaitez lui attribuer sur le texte (voir B.I.c.i). Le travail d'annotation achevé, exporter ou imprimer le texte avec les commentaires (voir B.IV). Vous pourrez ainsi éventuellement faire parvenir le texte commenté à son auteur. Si le texe annoté doit ensuite être modifié, l'éditer dans l'espace de travail et en créer une nouvelle version (voir B.III.f). L'utilisateur en charge de l'édition devra nécessairement avoir un rôle d'éditeur ou de gestionnaire. A.I.d. Interfaces de lecture co-ment peut enfin être utilisé comme interface de lecture sur internet. En intégrant co-ment à un CMS, une plateforme de diffusion peut mettre en ligne des textes immédiatement annotables par les internautes. L'utilisation de co-ment comme interface présente l'avantage de lire les commentaires dans la marge, chaque commentaire étant directement relié au passage annoté. Son intégration à une page web offre donc une alternative aux commentaires traditionnellement postés en bas de page et classés chronologiquement. 8

9 A.II. DOMAINES D'APPLICATION A.II.a. Education littéraire et humanités numériques Les usages éducatifs de co-ment comptent parmi les plus remarquables. Ils se sont développés en particulier pour l'enseignement de la langue principale et de la littérature dans l'éducation secondaire et supérieure. Nous avons soutenu plusieurs pionniers de l'enseignement centrés sur les textes en les aidant à utiliser co-ment. Il s'agit le plus souvent d'annotation pure. co-ment est notamment utilisé par des groupes d'enseignants pour préparer les cours et pour le travail en classe. co-ment est également utilisé dans des universités pour le travail d analyse et d annotation de textes. Exemple de travail d'annotation en classe sur un texte littéraire Joseph Scotese, professeur à la Whitney Young Magnet High School (Illinois, USA), a utilisé coment dans le cadre de travaux d'annotation collaborative de textes littéraires avec ses élèves. Ce travail en classe numérique consiste à inviter les élèves, disposant chacun d'un ordinateur, à annoter les passages de leur choix et à réagir aux commentaires des autres élèves. Ce travail d'annotation collaborative a été réalisé au sein d'une classe de lycée sur un texte de Shakespeare. L'intensité du surlignage permet de distinguer facilement les passages du texte les plus discutés par les 9

10 élèves. A.II.b. Processus éditoriaux L'outil d'annotation et d'écriture collaborative co-ment est particulièrement adapté aux processus éditoriaux. Il peut être utilisé pour la relecture, la correction ou la rédaction collective de textes destinés à l'édition. Dans ce dernier cas, un petit groupe de rédacteur établit une première version du texte qui est ensuite révisée à l'issue d'une phase d'annotation. co-ment a été adopté dans le cadre de processus éditoriaux aussi variés que : l'édition institutionnelle, notamment par la plateforme de partage de connaissances Capacity4dev de la Commission européenne ; l'édition de livres numériques annotés, pour l'éditeur enotated classics spécialisé dans l'édition critique de classiques de la littérature ; l'édition de manuels techniques ; et la traduction d'ouvrages. Exemple de l'utilisation de co-ment pour la traduction de manuels techniques par la société Diptik Diptik est une agence de rédaction technique spécialisée en conception et mise à jour de notices d'instructions (installation, utilisation, maintenance) de machines et produits industriels. Elle utilise co-ment pour valider les traductions de ses notices techniques. Chaque notice ayant fait l'objet d'une traduction est chargée sur l'espace de travail co-ment. Elle est ensuite accessible au rédacteur initial de la notice, à son traducteur, au relecteur et au constructeur. Ce travail collaboratif de validation permet à Diptik de s'assurer de la qualité de la traduction et de sa cohérence avec le document de départ. 10

11 A.II.c. Processus législatifs et programmatiques co-ment a été utilisé pour le travail législatif en France, au parlement européen et au Brésil. Le Partido del futuro, jeune mouvement politique espagnol fondé en 2013, a récemment utilisé co-ment pour élaborer son programme Democratia y punto avec la participation des internautes. Ce type d usage a émergé dans des groupes de la société civile qui soumettaient des textes en cours de préparation aux commentaires du public. Aujourd hui, des parlementaires eux-mêmes interagissent avec le public pendant que des propositions de loi et d autres textes législatifs (résolutions, par exemple) sont en cours de préparation ou de délibération. Exemple de la préparation de la proposition de loi sur la Neutralité du Net par le député socialiste Christian Paul Un remarquable exercice collaboratif a été conduit début 2010 par le député socialiste Christian Paul pour la préparation d'une proposition de loi sur la Neutralité du Net. Plus de 200 commentaires ont été soumis par des citoyens concernés et des experts. Le groupe socialiste de l'assemblée Nationale a adopté la proposition de loi le 24 novembre Celle-ci a été débattue mais n'a finalement pas été adoptée. La possibilité qu'offre co-ment de comparer les différentes versions d'un texte permet ici d'analyser les modifications survenues entre la version initiale du texte et la rédaction finale de la 11

12 proposition de loi adoptée par le député Christian Paul. A.II.d. Analyse juridique et politique co-ment est un outil particulièrement adapté à l'analyse juridique et politique de documents tels que les textes ou projets de lois. Il a été utilisé à de nombreuses reprises par des organisations pour l'analyse critique collective de textes de lois et la proposition d'amendements. co-ment a également prouvé son utilité dans le cadre de démarches institutionnelles d'analyse juridique telle que le projet DEMOTIS. Exemple du projet DEMOTIS de corpus annoté dans le cadre de la conception des systèmes d'informations personnelles de santé co-ment a été utilisé pour l analyse collaborative du cadre juridique applicable aux informations personnelles de santé. Dans le projet DEMOTIS, financé par l Agence Nationale de la Recherche (ANR), juristes et informaticiens ont annoté le vaste corpus de textes qui devaient être pris en compte dans la conception des systèmes d informations personnelles de santé. Ce travail collaboratif a abouti à la publication d un corpus annoté. Dans le cadre du projet DEMOTIS, juristes et informaticiens ont été mobilisés pour annoter collaborativement et à distance un corpus de texte définissant le cadre juridique applicable aux 12

13 informations personnelles de santé. A.II.e. Licences et contrats La rédaction, la révision des licences et plus généralement des codes de conduite, chartes et contrats sont un domaine d application clé pour co-ment. Les licences de logiciels libres et de contenus libres sont de véritables «constitutions» des biens communs informationnels. Leur rédaction et leur révision donnent lieu à des processus de gouvernance innovants. co-ment a été utilisé par l Open Knowledge Foundation pour ses Open Data Commons licences et par Creative Commons pour divers projets. La communauté OpenSuse a également utilisé co-ment pour élaborer son document de Vision et Stratégie. Exemple de l'élaboration collective de la Mozilla Public License (MPL) co-ment a été utilisé par la Mozilla Foundation comme outil de commentaires publics pour le processus de révision de la Mozilla Public License. L'élaboration de la MPL 2.0 s'est étalée sur 21 mois. Ce processus incluait une phase de commentaires par le public de la précendente version de la MPL. Divers acteurs se sont mobilisés à cette occasion pour annoter le document. Utilisateurs de la MPL, avocats ou encore membres de la communité open source tels que la Free Software Foundation et l'open Source Initiative ont participé au travail d'annotation dont est issue la nouvelle version de la Mozilla Public License. L'encapsulation de co-ment sur la page de la Mozilla Foundation et l'ouverture des commentaires au public a permis à de nombreux internautes de participer à l'élaboration de la nouvelle version de la Mozilla Public License. 13

14 A.II.f. Communication (communiqués de presse, prises de position, lettres ouvertes, tribunes) co-ment est devenu un outil privilégié pour de nombreux groupes, associations ou initiatives pour la préparation de lettres ouvertes, de prises de positions, de communiqués de presse ou de chartes. Certains groupes font le choix de travailler dès le départ «à ciel ouvert» en rendant les textes en cours d'élaboration visibles et commentables par tous. Dans la plupart des cas, une première phase d'élaboration par un petit groupe à lieu «en privé» suivie d'une ouverture plus large aux commentaires du public. Ce fonctionnement a permis dans certains cas la production de dizaines de versions en 48 heures, chacune recevant jusqu'à des centaines de commentaires. Exemple de l'élaboration du plan d'action pour la réforme du copyright et la culture au XXIe siècle A l'issue du Free Culture Forum 2012, quatre organisations se sont réunies afin d'élaborer une première version d'un plan d'action pour la réforme du copyright et l'accompagnement du developpement de la culture au XXIe siècle. Les propositions de ces organisations ont été regroupées au sein d'un même document puis soumises aux commentaires des internautes. Co-ment permet d'inviter un groupe plus ou moins vaste de commentateurs à participer à l'élaboration de documents. Cet outil d'annotation rend possible une synergie entre des commentaires massifs et une rédaction collective. 14

15 B. Manuel d'utilisation REMARQUES GENERALES Lors de certains changements de configuration de l'espace de travail, il peut arriver que l'effet de ces changements ne soit pas visible immédiatement du fait de la mémorisation des pages dans le cache du serveur Web. Si cela se produit, attendre quelques minutes et réactualiser le chargement de la page dans le navigateur Web. Vous disposez déjà d'un espace de travail co-ment ou vous souhaitez bénéficier des fonctionnalités de cet outil d'annotation et d'écriture collaborative. Les différents cas de figure possibles sont les suivants : Formule d'essai (48 heures) Le site vous propose de bénéficier gratuitement pendant 48 heures de l'accès à une instance co-ment pour tester l'outil. Créez un compte, téléchargez des textes et invitez des utilisateurs à les commenter. A l'issue de cette période d'essai, co-ment vous contactera par mail pour vous proposer de basculer sur un abonnement professionnel. Tous les travaux que vous avez débutés lors de votre session d'essai seront conservés et transférés sur votre instance co-ment pro. Abonnement pro L'abonnement pro vous permet de bénéficier d'un espace de travail co-ment accessible pendant toute la durée de votre abonnement. Vous pouvez y gérer jusqu'à 500 utilisateurs enregistrés et 500 textes. Vous bénéficiez par ailleurs d'un service support par (voir les termes d'usages sur le site Vous pouvez à tout moment choisir d'installer le logiciel COMT. Vous pourrez alors y transférer la base de données de votre instance co-ment pro : vous conserverez l'ensemble de vos utilisateurs et de vos travaux. Installation du logiciel co-ment est un service web basé sur le logiciel libre COMT. L'installation du logiciel COMT permet d'utiliser co-ment sans recourir à nos services. Le logiciel donne accès à un espace de travail identique à celui fourni aux abonnés pro. Accédez au logiciel en vous rendant sur le site La seule contrainte imposée aux utilisateurs du logiciel est la restriction de l'usage de la marque co-ment dans le cadre d'une utilisation commerciale de l'outil (voir les termes d'usage sur le site Intégration de co-ment à un CMS Dès lors que vous avez souscrit un abonnement ou que vous avez installé le logiciel, vous pouvez intégrer votre instance co-ment à un système de gestion de contenu (CMS), notamment Drupal. Les utilisateurs et gestionnaires d'un site Drupal peuvent ainsi bénéficier des fonctionnalités co-ment depuis leur interface grâce à l'api et le module Drupal co-ment ( 15

16 Encapsulation Tout détenteur d'une instance co-ment peut par ailleurs rendre un texte co-ment accessible aux internautes sur n'importe quelle page web grâce à l'encapsulation. Les internautes pourront ainsi consulter vos textes et les commenter en accédant à toutes les fonctionnalités d'annotation. (voir section B.IV.a du guide). Votre instance co-ment est disponible en plusieurs langues. Changez-en en cliquant sur les liens présents en bas de votre interface. Le lien «contact» accessible également depuis l'espace de travail et l'interface de connexion permet aux utilisateurs d'entrer en contact avec l'administrateur principal de l'instance. 16

17 B.I. ESPACE DE TRAVAIL Les 5 onglets de votre espace de travail présents en page d'accueil Tableau de bord, Textes, Utilisateurs, Paramètres et Suivi vous permettent d'accèder aisément à toutes les fonctionnalités de l'outil co-ment. Revenez à tout moment sur cette page d'accueil en cliquant sur le lien «Accueil» présent en haut de page. A noter que l'accès à certaines fonctionnalités et donc l'apparence de l'espace de travail dépendent du rôle assigné à l'utilisateur (voir section B.I.c.i). Les captures d'écran visibles dans ce manuel sont celles de l'espace de travail d'un gestionnaire, soit l'utilisateur disposant des droits les plus étendus. B.I.a. Débuts sur l'espace de travail Vous venez de créer votre nouvel espace de travail. Connectez-vous, éditez votre profil et découvrez les différentes options de personnalisation que vous offre co-ment. B.I.a.i. Se connecter à l'espace de travail Pour vous rendre sur votre espace de travail co-ment, utilisez l'adresse internet choisie lors de votre inscription ou cliquez sur le lien envoyé sur votre boîte mail à l'issue de cette inscription. Vous accédez alors directement à l'interface de connexion. Renseignez votre nom d'utilisateur et votre mot de passe dans les champs prévus à cet effet, puis cliquez sur le bouton «Se connecter» Si vous avez oublié votre mot de passe, cliquez sur le lien «Mot de passe oublié?». Indiquez l'adresse mail renseignée lors de votre enregistrement et validez la réinitialisation de votre mot de passe. Un mail vous est automatiquement envoyé. Cliquez sur le lien qu'il contient, indiquez votre nouveau mot de passe et validez-le. 17

18 B.I.a.ii. Configurer l'espace de travail Vous pouvez configurer et personnaliser votre espace de travail. Pour cela, rendez-vous sur l'onglet «Paramètres» ou cliquez sur le lien «Configurer l'espace de travail» situé dans la rubrique «Actions» de votre tableau de bord. Paramètres généraux Dans les paramètres généraux, vous avez la possibilité de : choisir le nom de votre espace de travail qui apparaitra en haut de page ; choisir un slogan qui apparaitra sous le nom de votre espace de travail ; autoriser les utilisateurs à s'enregistrer directement dans l'espace de travail (voir section B.I.b.iv) ; choisir de modérer l'enregistrement des nouveaux utilisateurs sur l'espace de travail (voir section B.I.b.iv); choisir d'utiliser le modèle de rôles «générique» (recommandé dans la plupart des cas) ou le modèle de rôles professeur-élève, aujourd'hui mal dénommé «classe (éducation)» (voir section B.I.c.v), définir des catégories pour les commentaires (voir section B.II.e.i). Cliquez sur le bouton «Enregistrer» pour valider les nouveaux paramètres. 18

19 Paramètres d'apparence Dans les paramètres d'apparence, vous avez la possibilité de: de choisir un logo pour votre espace de travail à partir d'un fichier téléchargeable depuis votre poste de travail ; d'ajouter des règles de feuilles de style au format CSS (cette fonctionnalité s'adresse uniquement aux utilisateurs disposant d'une maîtrise avancée d'html5 et des feuilles de style) ; de personnaliser la police de caractères ; de personnaliser la police de caractères pour les titres. (NB : les polices proposées par défaut sur l'outil co-ment ont été sélectionnées pour optimiser la lisibilité de vos textes. Nous vous conseillons donc de les modifier uniquement en cas de besoin). Cliquez sur le bouton «Enregistrer» pour valider les nouveaux paramètres. B.I.a.iii. Editer votre profil utilisateur Vous pouvez accéder à votre profil utilisateur en cliquant sur le lien «Editer votre profil» dans la rubrique «Actions» de votre tableau de bord ou sur le lien «Profil» situé en haut de page. Complétez ou mettez à jour votre profil en renseignant les informations suivantes : votre adresse mail (obligatoire) ; vos nom et prénom ; autoriser ou non les autres utilisateurs de l'espace de travail à vous contacter par mail ; la langue de préférence (obligatoire) les tags (mots-clés) qui vous seront associés. Ces tags permettront ensuite le filtrage des utilisateurs (voir section B.I.b.ii) Cliquez sur le bouton «Enregistrer» pour valider votre nouveau profil. 19

20 B.I.a.iv. Modifier votre mot de passe Pour modifier votre mot de passe, cliquez sur le lien «Mot de passe» situé en haut du formulaire de votre page de profil (voir section B.I.a.iii). Renseignez votre ancien mot de passe, puis votre nouveau mot de passe. Une fois votre nouveau mot de passe confirmé, cliquez sur «Enregistrer» pour valider sa création. B.I.a.v. Se déconnecter de l'espace de travail Pour vous déconnecter de l'espace de travail, cliquez sur le lien «déconnecter» situé en haut à droite de l'espace de travail. Vous revenez alors automatiquement à l'interface de connexion (voir section B.I.a.i). B.I.b. Gestion des utilisateurs Constituez facilement un groupe de travail autour d un ensemble de textes. Invitez vos collaborateurs, envoyez-leur une invitation, éditez leur profil et assignez leur un rôle. Vous pouvez à tout moment gérer leur accès aux textes et à l'espace de travail. B.I.b.i. Consulter la liste des utilisateurs La liste des utilisateurs enregistrés sur l'espace de travail est accessible en cliquant sur l'onglet «Utilisateurs». Le chiffre affiché entre parenthèses dans l'onglet indique le nombre de ces utilisateurs. Les utilisateurs sont classés par ordre alphabétique. Vous pouvez également les afficher par mail, rôle ou date d'entrée sur l'espace de travail en cliquant sur les titres de colonne. Pour chaque utilisateur, sont mentionnés : les mots-clés renseignés lors de l'édition du profil, une adresse mail, la date d'entrée dans l'espace de travail, le rôle assigné par le(s) gestionnaire(s) de l'espace de travail, l'activité de la dernière semaine (graphique). 20

21 Vous pouvez filtrer les utilisateurs de l'espace de travail par mots-clés. Choisissez pour cela un motclé dans la liste déroulante située au-dessus de la liste des utilisateurs. Vous pouvez également cliquer directement sur les mots-clés affichés sous le nom des utilisateurs pour afficher tous les utilisateurs associés à ces mots-clés. B.I.b.ii. Ajouter un nouvel utilisateur à l'espace de travail Pour enregistrer un nouvel utilisateur, cliquez sur le lien «Inviter un utilisateur» dans la rubrique «Actions» de votre tableau de bord. Vous pouvez également vous rendre sur l'onglet «Utilisateurs» et cliquer sur le lien «Ajouter un utilisateur». Remplissez ensuite le formulaire en précisant : l'adresse mail de l'utilisateur que vous souhaitez inviter (obligatoire) ; ses nom et prénom ; la langue de préférence (obligatoire) ; le rôle de ce nouvel utilisateur sur l'espace de travail (voir section B.I.c.i) ; les tags (ou mots-clés) à associer à cet utilisateur. Vous pouvez également rédiger un message. Il sera repris dans l' d'invitation envoyé automatiquement au nouvel utilisateur après validation de l'enregistrement. N'oubliez pas de terminer votre message par un retour à la ligne B.I.b.iii. Ajouter des utilisateurs en masse Vous pouvez également envoyer une invitation groupée à plusieurs utilisateurs. Pour cela, rendezvous sur l'onglet «Utilisateurs» puis cliquez sur le lien «Ajouter des utilisateurs en masse». Remplissez ensuite le formulaire en indiquant : l'adresse mail des utilisateurs que vous souhaitez inviter (obligatoire). Séparez les adresses avec une virgule ou un point-virgule. Vous pouvez aussi revenir à la ligne pour chaque nouvelle adresse. La langue de préférence (obligatoire) ; 21

22 les tags (ou mots-clés) à associer au groupe d'utilisateurs invités ; le rôle attribué à l'ensemble de ces nouveaux utilisateurs (voir section B.I.c.i). Vous pouvez rédiger un message. Il sera repris dans l' d'invitation envoyé automatiquement aux nouveaux utilisateurs après validation de l'enregistrement. B.I.b.iv. Autoriser les utilisateurs à s'enregistrer sur l'espace de travail Vous pouvez autoriser les utilisateurs à s'enregistrer eux-mêmes sur l'espace de travail. Il leur suffit alors d'accéder à l'interface de connexion grâce à l'adresse internet de l'espace de travail, et de cliquer sur le lien «s'enregistrer». Le futur utilisateur doit ensuite renseigner son adresse mail (obligatoire), ses nom et prénom et la langue de préférence, puis valider ces informations. Un mail lui est automatiquement envoyé. Cliquer sur le lien qu'il contient lui permet d'accèder à une nouvelle fenêtre dans laquelle il doit indiquer son nom d'utilisateur et son mot de passe. Son compte est alors activé : il peut ensuite accéder à l'espace de travail. A noter que l'utilisateur s'enregistrant sur l'espace de travail ne dispose d'aucun rôle sur cet espace et les textes qu'il contient. Un rôle devra lui être assigné par un gestionnaire afin qu'il puisse observer ou participer aux travaux d'annotation. L'option «modération de l'espace de travail» peut être sélectionnée dans l'onglet «Paramètres». Elle permet aux gestionnaires d'être informés par mail de l'enregistrement de tout nouvel utilisateur. B.I.b.v. Envoyer une invitation à un nouvel utilisateur Vous pouvez à tout moment envoyer une nouvelle invitation à rejoindre votre espace de travail à un utilisateur déjà enregistré (une première invitation est automatiquement envoyée à l'enregistrement d'un nouvel utilisateur). Pour cela, rendez-vous sur la liste des utilisateurs consultable dans l'onglet «Utilisateurs» et cliquez sur le lien «(Ré-)envoyer l'invitation» qui apparaît en survolant le nom de l'utilisateur avec votre souris. B.I.b.vi. Editer le profil d'un utilisateur Pour éditer le profil d'un utilisateur, rendez-vous sur la liste des utilisateurs dans l'onglet «Utilisateurs». Cliquez directement sur le nom de l'utilisateur dont vous souhaitez éditer le profil ou survoler avec la souris son nom puis cliquez sur le lien «éditer» qui apparaît en dessous. 22

23 Vous pouvez alors compléter ou modifier les informations relatives à l'utilisateur. La démarche est identique à celle décrite dans la section B.I.a.iii. La case «accès désactivé» vous permet dans le cas présent de couper l'accès de l'utilisateur à l'espace de travail (voir section suivante). A noter que chaque utilisateur, même celui ne disposant d'aucun rôle, peut éditer son propre profil. B.I.b.vii. Activer/Désactiver l'accès d'un utilisateur à l'espace de travail Pour désactiver l'accès d'un utilisateur à l'espace de travail, rendez-vous sur la liste des utilisateurs dans l'onglet «Utilisateurs». Survolez avec la souris le nom de l'utilisateur dont vous souhaitez désactiver l'accès puis cliquez sur le lien «désactiver l'accès» qui apparaît en-dessous. Vous pouvez également désactiver l'accès d'un utilisateur via son profil, en cochant la case prévue à cet effet (voir section précédente). Cliquez sur le lien «afficher les utilisateurs désactivés» en haut de la liste des utilisateurs pour que les utilisateurs que vous avez désactivés apparaissent dans la liste. Vous pouvez à tout moment rétablir l'accès à l'espace de travail d'un utilisateur désactivé en cliquant sur le lien «activer l'accès» qui apparaît lorsque vous survolez son nom avec votre souris. La liste déroulante «Actions multiples» vous permet d'activer ou de désactiver l'accès de plusieurs utilisateurs à la fois. Pour cela, sélectionnez les utilisateurs en cochant la case située devant leur nom et sélectionnez l'action «activer l'accès» ou «désactiver l'accès» de la liste déroulante. Cliquez ensuite sur le bouton «Appliquer» pour valider les modifications. B.I.c. Gestion des rôles des utilisateurs Assignez aux utilisateurs un rôle particulier sur l'espace de travail: observateur, commentateur, modérateur, éditeur ou gestionnaire. Pour chaque texte, modifiez si vous le souhaitez le rôle attribué à un utilisateur pour élargir ou restreindre ses droits. B.I.c.i. Choisir le rôle d'un utilisateur A chaque utilisateur enregistré est associé un rôle qui définit ses droits et ses possibilités d'action 23

24 dans l'espace de travail et sur les textes. Ce rôle est défini par le gestionnaire et peut être modifié à tout moment. Par défaut, le nouvel utilisateur ne dispose d'aucun rôle sur la plateforme et sur les textes. Le gestionnaire Il dispose des droits les plus étendus sur l'espace de travail et ses textes. Il peut : paramétrer l'espace de travail ; suivre l'activité de l'espace de travail, des textes et des utilisateurs sur le tableau de bord; gérer l'ensemble des utilisateurs de l'espace de travail (ajout, désactivation, édition de profil, choix des rôles) ; gérer l'ensemble des textes de l'espace de travail (créer, éditer, commenter, modérer les commentaires, supprimer). L'éditeur L'éditeur est un utilisateur disposant de droits étendus sur les texte. Il peut : accéder à tous les textes de l'espace de travail ; créer, commenter, éditer et supprimer les textes ; éditer, supprimer et modérer les commentaires ; supprimer les textes. Le modérateur Le modérateur peut participer aux travaux d'annotation et agir sur les commentaires des autres utilisateurs. Il peut : accéder à tous les textes de l'espace de travail ; commenter les textes ; éditer/supprimer/modérer les commentaires des autres utilisateurs. Le commentateur Le commentateur a des droits qui lui permettent d'annoter les textes de l'espace de travail. Il peut : accéder à tous les textes de l'espace de travail ; commenter les textes ; éditer et supprimer ses propres commentaires ; consulter les commentaires des autres utilisateurs. L'observateur Ce rôle permet aux utilisateurs de consulter les travaux d'annotation en cours. Il ne leur permet toutefois pas d'y prendre part. Un observateur peut : accéder à tous les textes de l'espace de travail lire l'ensemble des commentaires rattachés à un texte Aucun rôle (-----) L'utilisateur ne dispose d'aucun rôle tant que le gestionnaire ne lui en a pas attribué un. Sans rôle, 24

25 l'utilisateur enregistré peut uniquement accéder aux textes publics avec un statut d'observateur et contacter le gestionnaire principal via le lien «contact» situé en pied de page. B.I.c.ii. Assigner un rôle à un utilisateur sur l'espace de travail Vous pouvez assigner un rôle à un nouvel utilisateur via son profil ou la colonne rôle de la liste des utilisateurs. Dans les deux cas, sélectionnez dans la liste déroulante le rôle souhaité et validez votre choix en cliquant sur le bouton «Enregistrer». Pour assigner un même rôle à plusieurs utilisateurs à la fois, cochez la case située devant le nom des utilisateurs et choisissez dans la liste déroulante «Actions multiples» le rôle que vous souhaitez leur attribuer. Cliquez sur le bouton «Valider» pour enregistrer les modifications. Vous pouvez modifier le rôle assigné aux utilisateurs à tout moment en reproduisant cette même démarche. B.I.c.iii. Assigner un rôle à un utilisateur sur un texte co-ment vous permet d'assigner aux utilisateurs des rôles spécifiques sur un texte. Vous pouvez ainsi pour un texte donné restreindre ou étendre les droits dont dispose l'utilisateur sur l'espace de travail. Pour tous les autres textes, les droits de l'utilisateur resteront ceux associés au rôle assigné sur l'espace de travail. Pour définir les droits d'un utilisateur sur un texte, rendez-vous sur le texte en question en cliquant sur son titre dans l'onglet «Textes». Une fois le texte chargé, cliquez sur l'onglet «Utilisateurs». Vous pouvez également accéder directement à la liste des utilisateurs d'un texte en cliquant sur le lien «utilisateurs» qui apparaît lorsque vous survolez le titre d'un texte avec la souris. Dans la colonne «rôle sur le texte», choisissez ensuite le rôle voulu dans la liste déroulante et cliquez sur le bouton «Enregistrer». Pour assigner un même rôle à plusieurs utilisateurs à la fois, cochez la case située devant le nom des utilisateurs et choisissez dans la liste déroulante «Actions multiples» le rôle que vous souhaitez leur attribuer. Cliquez sur le bouton «Valider» pour enregistrer les modifications. En fonction du rôle choisi, les droits dont disposera l'utilisateur sur le texte sont ceux décrits dans la section B.I.c.i. 25

26 B.I.c.iv. Définir le rôle des utilisateurs anonymes Les utilisateurs anonymes sont des utilisateurs qui ne sont pas enregistrés sur l'espace de travail. Vous pouvez toutefois leur donner accès aux textes de l'espace de travail en leur attribuant un rôle d'observateur ou de commentateur. Dès lors qu'un rôle est attribué aux utilisateurs anonymes, vos textes deviennent publics et sont accessibles depuis l'interface de connexion de votre espace de travail. Tout visiteur accédant à l'interface peut alors cliquer sur le titre d'un texte pour y accéder, le consulter et le commenter en fonction du rôle attribué aux utilisateurs anonymes. Pour assigner un rôle aux utilisateurs anonymes, rendez-vous sur l'onglet «Utilisateurs» puis sélectionnez le rôle souhaité dans la liste déroulante située en bas de la liste. Validez ensuite votre choix en cliquant sur le bouton «Enregistrer». En attribuant aucun rôle aux utilisateurs anonymes, vous conservez vos textes privés et en interdisez l'accès aux visiteurs. Si vous souhaitez ne rendre que certains textes publics, n'attribuez aucun rôle aux utilisateurs anonymes sur l'espace de travail. Rendez-vous sur les textes que vous voulez rendre accessibles aux visiteurs et cliquez ensuite sur l'onglet «Utilisateurs» du texte. Vous pouvez alors assigner un rôle aux utilisateurs anonymes. Les droits octroyés aux utilisateurs anonymes ne le seront que pour le texte en question. B.I.c.v. Choisir un modèle de rôles Dans les paramètres généraux modifiables dans l'onglet «Paramètres», vous avez la possibilité de configurer le modèle de rôles. Le modèle de rôles «générique» est recommandé pour tous les cas d'annotation collaborative. Il offre la possibilité aux gestionnaires d'assigner les rôles décrits en section B.I.c.i. Un autre modèle, qui vise à permettre des échanges privés entre un professeur et chaque élève individuel, peut être sélectionné : le modèle de rôles professeur-élève, aujourd'hui mal dénommé «classe (éducation)» (voir section B.I.c.v). Trois rôles sont alors disponibles : professeur, élève et élève individuel. Le rôle de professeur correspond à celui de gestionnaire dans le modèle générique. Cet utilisateur dispose des droits les plus étendus sur les textes et l'espace de travail. Le rôle d'élève permet à l'utilisateur de commenter un texte et de voir les commentaires des autres élèves et du professeur. 26

27 Le rôle d'élève individuel permet à l'utilisateur de commenter un texte et d'intéragir avec le professeur. Ses commentaires et ses échanges avec le professeur restent privés. Les autres élèves n'y ont pas accès. De la même manière, l'élève individuel ne peut lire les commentaires des autres élèves ou élèves individuels. B.I.d. Gestion des textes B.I.d.i. Consulter la liste des textes co-ment La liste des textes enregistrés dans l'espace de travail est consultable en cliquant sur l'onglet «Textes» de l'interface. Le chiffre indiqué entre parenthèses dans l'onglet correspond au nombre de textes disponibles. Pour accéder à un texte, il vous suffit de cliquer sur son titre. Les textes sont classés selon leur date de dernière modification. Vous pouvez également les classer par ordre alphabétique en cliquant sur le titre de la colonne «texte». Enfin, il est possible de filtrer les textes de la liste en fonction des mots-clés que vous leur avez attribués. Sélectionnez pour cela le mot-clé souhaité dans la liste déroulante située au-dessus de la liste des textes. Vous pouvez également cliquer directement sur un mot-clé situé sous le titre d'un texte pour afficher tous les textes associés à ce mot-clé. Pour chaque texte sont spécifiés : le titre l'auteur la date de dernière modification le nombre de commentaires l'activité de la dernière semaine (graphique) B.I.d.ii. Actions possibles depuis la liste de textes De nombreuses actions sont possibles depuis la liste de textes de votre espace de travail. Survolez le titre d'un texte avec votre souris, les liens qui apparaissent en dessous vous permettent : d'accéder directement au texte ; 27

28 d'éditer le texte (voir section B.III.f) ; de supprimer le texte ; d'accéder à la liste des utilisateurs du texte, et de leur assigner ensuite des rôles sur le texte en question (voir section B.I.c.iii) ; d'accèder aux paramètres du textes pour définir les catégories et le type de modération (voir section B.II.e). B.I.d.iii. Rendre un texte public Vos textes sont par défaut privés. Ils ne sont accessibles qu'aux utilisateurs enregistrés sur l'espace de travail disposant d'un rôle. Vous pouvez toutefois rendre ces textes publics. Ils seront dès lors accessibles à tous les utilisateurs ainsi qu'aux visiteurs (ou utilisateurs anonymes). Pour rendre un texte public, cliquez sur «utilisateurs» puis assignez un rôle aux utilisateurs anonymes (voir section B.I.c.iv). B.I.e. Suivi de l'activité Vous visualisez l activité de votre espace de travail à différents niveaux (global, par texte, par membre) et à différentes échelles (jour, semaine ou mois). Vous pouvez également vous abonner aux flux privé et public ainsi qu'aux notifications par . B.I.e.i. Consulter le tableau de bord Les gestionnaires peuvent suivre l'activité de l'espace de travail sur l'onglet «Tableau de bord». Ce tableau de bord permet de prendre rapidement connaissance : des derniers commentaires faits sur les textes de l'espace de travail ; des textes récents avec le nombre de commentaires attachés, le nombre de versions et la date de dernière modification ; de l'activité sur l'espace de travail (accès et commentaires) par mois, semaine ou jour (graphique). La rubrique «Activités» liste toutes les notifications relatives aux textes, aux utilisateurs et aux commentaires, de la plus récente à la plus ancienne. Vous pouvez cocher ou décocher les différents types d'activité pour ne faire apparaître que les notifications qui vous intéressent. 28

29 B.I.e.ii. S'abonner au flux public Vous pouvez vous abonner au flux public de l'espace de travail en vous rendant sur l'onglet «Suivi». Vous serez alors informé de toutes les dernières modifications apportées aux textes publics de l'espace de travail (pour rendre un texte public, voir section B.I.c.iv). Tous les utilisateurs enregistrés sur l'espace de travail, quel que soit leur rôle, ont accès à ce flux. Le flux public est associé à une adresse internet : vous pouvez la transmettre à tous ceux que vous souhaitez tenir informés de l'activité de vos textes publics, même ceux ne disposant pas d'accès à votre plateforme co-ment. B.I.e.iii. S'abonner au flux privé Vous pouvez vous abonner au flux privé de l'espace de travail. Vous devez dans un premier temps l'activer en vous rendant sur l'onglet «Suivi». Abonnez-vous : vous serez alors notifié de l'activité de tous les textes de l'espace de travail (textes, utilisateurs, commentaires). Seuls les gestionnaires disposent de l'adresse du flux privé. Vous pouvez ensuite la transmettre à d'autres utilisateurs que vous voulez maintenir informés de l'activité sur l'espace de travail. Ne rendez pas ce flux accessible aux personnes non membres de votre espace de travail à moins que vous ne vouliez les tenir au fait de ce qui s'y passe à l'intérieur. Vous pouvez si nécessaire modifier l'adresse de votre flux privé. Il suffit pour cela de cliquer sur le bouton «Réinitialiser l'adresse du flux privé» dans la rubrique flux de l'onglet «Suivi». B.I.e.iv. S'abonner aux notifications par Vous pouvez recevoir par les notifications de l'espace de travail ainsi que les notifications concernant vos commentaires et les fils de discussion auxquels vous avez participé. Pour cela, cochez les cases prévues à cet effet dans l'onglet «Suivi». 29

30 Ces notifications seront envoyées à l'adresse indiquée lors de votre enregistrement sur l'espace de travail. Vous pouvez à tout moment modifier cette adresse en éditant votre profil (voir section B.I.a.iii). 30

31 B.II. CREATION D'UN TEXTE CO-MENT B.II.a. Rédaction d'un texte Pour rédiger un texte, cliquez sur le lien «créer un texte» situé en haut de page ou dans la rubrique «Actions» de votre tableau de bord. Vous trouverez également ce lien en haut de la liste des textes de l'espace de travail (onglet «Textes»). Vous accédez alors au formulaire d'édition. Renseignez le titre de votre texte et son format (voir section B.II.d). Vous pouvez ensuite rédiger votre texte dans la fenêtre prévue à cet effet. Agrandissez cette fenêtre en cliquant avec votre souris sur l'angle situé en bas à droite. Vous pouvez également créer un texte en procédant au copier-coller d'un fichier ou d'une page web. Si vous copiez-collez une page web, veillez à sélectionner le format html dans la liste déroulante. Vous pouvez associer des tags (mots-clés) à votre nouveau texte. Ces tags vous permettront par la suite, dans l'onglet «Textes», de filtrer les textes de votre espace de travail. B.II.b. Chargement d'un texte Pour charger un texte sur votre plateforme co-ment depuis votre poste de travail, cliquez dans un premier temps sur le lien «charger un texte» qui se trouve en haut de page, dans la rubrique «Actions» de votre tableau de bord et en haut de votre liste de textes (onglet «Textes»). Renseignez ensuite le titre du texte à charger, son format (voir section B.II.d), et les tags (mots-clés) à y associer. Cliquez ensuite sur le bouton «Parcourir» et sélectionnez dans l'explorateur de fichiers le texte que vous souhaitez charger sur votre espace de travail. Validez pour finir le 31

32 chargement en cliquant sur le bouton «Enregistrer». Les formats de texte importables sur co-ment (et les formats de destination recommandés) sont les suivants : Texte (.txt) Le format de destination markdown est recommandé. Html (.html) Si l'import au format de destination html ne fonctionne pas, choisissez le format markdown. Nous vous recommandons toutefois d'afficher vos fichiers.html dans votre navigateur et de créer un texte html en procédant à un copier-coller de la page web (voir section B.II.a). Microsoft word (.doc) Le format de destination html est recommandé. Open document (.odt) Le format de destination html est recommandé. Markdown (.mkd) Le format de destination markdown est recommandé. Latex (.tex) Le format de destination markdown est recommandé. Attention, seule une partie de latex est supportée par le convertisseur utilisé. A noter que co-ment ne prend pas en charge les textes au format pdf. B.II.c. Import d'un texte co-menté Vous pouvez importer sur votre espace de travail un texte déjà annoté sur co-ment. Ce texte doit avoir été préalablement exporté en format XML (voir section B.II.d et B.IV.a). Pour procéder à l'import, cliquez sur le lien «importer un texte co-menté» qui se trouve en haut de page, dans la rubrique «Actions» de votre tableau de bord et en haut de votre liste de textes (onglet «Textes»). Cliquez sur le bouton «Parcourir» et sélectionnez le texte co-menté en format XML dans l'explorateur de fichiers. Cliquez pour finir sur le bouton «Enregistrer» pour valider l'import du texte. 32

33 B.II.d. Choix du format de texte Lorsque vous créez ou chargez un texte, co-ment vous donne à ce jour le choix entre 3 formats : HTML, Markdown (recommandé pour les textes entièrement rédigé sur co-ment) ou RST. Ce format sous-jacent apparaît lorsque vous éditez votre texte. C'est également sous ce format que votre texte est stocké dans la base de données. Lorsque vous souhaitez consulter et annoter un texte de votre espace de travail, et ce quel que soit le format choisi, votre texte est automatiquement converti en HTML. B.II.d.i. Format HTML Ce format est celui adopté par co-ment pour visualiser les textes de votre espace de travail. Vous pouvez opter également pour HTML comme format sous-jacent lors de la rédaction ou du chargement d'un texte sur la plateforme. Les outils proposés pour mettre en forme le texte sont proches de ceux d'un traitement de texte. Vous avez par ailleurs la possibilité d'écrire directement en HTML en cliquant sur le bouton «source» en haut à gauche de la barre d'outils. B.II.d.ii. Format Markdown (version Pandoc) Les formats Markdown et RST sont tous deux des formats de wiki. Le format Markdown proposé par co-ment utilise la version Pandoc. Il s'agit du format par ailleurs utilisé pour les commentaires des textes co-ment sur la plateforme (voir section B.III.c.iv). Dans le formulaire d'édition proposé lors de la création d'un texte co-ment, une barre d'outils est disponible pour aider à la mise en forme de votre texte (liste à puces, insertion d'url...). Pour explorer toutes les possibilités offertes par le langage Mardown (version Pandoc), nous vous recommandons de consulter la fiche mise à votre disposition en annexe de ce guide. B.II.d.iii. Format RST Le format RST (Re-Rtructured Text) est très proche du format Markdown. Il s'adresse aux utilisateurs souhaitant charger un texte en format RST et à ceux maîtrisant déjà ce langage. B.II.d.iv. Format Wikimedia Le support du format Wikimedia est en cours de développement. B.II.e. Paramétrages : modération et catégories Vous venez de créez votre texte. Avant de débuter le travail d'annotation, vous pouvez paramétrer plusieurs catégories de commentaires. Vous pouvez également choisir le type de modération a 33

34 priori ou a posteriori qui sera appliqué aux commentaires. B.II.e.i. Paramétrer les catégories Vous pouvez définir jusqu'à cinq catégories de commentaires pour vos textes. Chaque catégorie est associée à un intitulé et à une couleur. Lorsque l'utilisateur annote un texte, il peut ensuite choisir de catégoriser son commentaire. Un trait de la couleur de la catégorie choisie apparaîtra alors dans la marge, le long du paragraphe contenant le commentaire. Les catégories peuvent être définies pour l'ensemble des textes de l'espace de travail ou pour un texte. Dans le premier cas, cliquez sur l'onglet «Paramètres» de l'espace de travail. Pour créer des catégories pour un texte en particulier, rendez-vous sur le texte puis sur l'onglet «Paramètres». Vous pouvez accéder directement aux paramètres d'un texte en survolant son titre avec la souris et en cliquant sur le lien «paramètres» (onglet «Textes»). Pour définir une catégorie, il suffit de renseigner son intitulé. Vous n'êtes pas contraint de les définir dans l'ordre proposé. Vous pouvez choisir vos catégories en fonction des couleurs proposées. Les catégories définies apparaîtront ensuite dans une liste déroulante accessible aux utilisateurs dans la fenêtre d'édition des nouveaux commentaires. B.II.e.ii. Modérer les commentaires Pour chaque texte, vous pouvez choisir de modérer a priori ou a posteriori les commentaires. La modération a posteriori est sélectionnée par défaut pour tout nouveau texte. Le type de modération pour un texte peut être modifié à tout moment. Rendez-vous pour cela sur le texte en question puis sur l'onglet «Paramètres». Vous pouvez également accéder directement aux paramètres depuis la liste des textes (onglet «Textes) en cliquant sur le lien «paramètres» qui apparaît lorsque vous survolez le titre du texte avec votre souris. Pour finir, cochez ou décochez la case «Modération a posteriori?». 34

35 Modération a posteriori En choissisant la modération a posteriori, vous rendez les commentaires des utilisateurs visibles dès leur création. Les gestionnaires, éditeurs et modérateurs ont toutefois la possibilité, après leur publication, de les mettre en attente ou de les modérer. Dans ces deux cas, les commentaires ne seront plus visibles par les autres utilisateurs. Pour modifier le statut d'un commentaire, cliquez sur le statut «validé» qui apparaît en vert dans la fenêtre du commentaire. Vous pouvez alors définir un nouveau statut : «en attente» ou «modéré». Modération a priori La modération a priori s'applique dès que la case «Modération a posteriori?» est décochée dans l'onglet «Paramètres» du texte. Les nouveaux commentaires sont alors automatiquement mis «en attente». Pour être visibles par tous les utilisateurs, ces commentaires devront être validés par un utilisateur disposant d'un droit de modération (gestionnaire, éditeur ou modérateur, voir section B.I.c.i). Pour modifier le statut d'un commentaire en attente, vous devez cliquer sur le statut «en attente» qui apparaît en orange dans la fenêtre du commentaire. Vous pouvez ensuite choisir de modérer ou de valider le commentaire. Les éditeurs et les modérateurs sont informés de la présence de commentaires en attente par une fenêtre dédiée dans leur tableau de bord. Ils peuvent également être tenus informés des derniers commentaires par le biais du flux privé de l'espace de travail ou du texte (voir section B.I.e.iii). 35

36 B.III. TRAVAIL SUR UN TEXTE CO-MENT B.III.a. Constitution d'un groupe de travail Pour constituer un groupe de travail autour d'un texte co-ment, rendez-vous sur le texte en question en cliquant sur son titre (onglet «Textes»), puis sur l'onglet «Utilisateurs». Choisissez ensuite les utilisateurs qui auront accès au texte et attribuez leur un rôle (voir section B.I.c.i). Si vous souhaitez conserver votre texte privé, veillez à n'attribuer aucun rôle aux utilisateurs anonymes. Dans le cas contraire, votre texte serait accessible par tous depuis l'interface de connexion de votre espace de travail (voir section B.I.c.iv). B.III.b. Présentation de la barre d'outils Lorsque vous ouvrez un texte dans votre espace de travail, vous disposez en haut de page d'une barre d'outils qui vous donnent accès aux informations et fonctionnalités suivantes : Nombre de discussions (en haut à gauche de la barre d'outils). Parcours des discussions : l'utilisateur peut parcourir les discussions en cours sur le texte. Ce parcours s'opère par "emplacement" (dans l'ordre du texte) ou par "modification" (du commentaire le plus récent au plus ancien). Pour aller d'un commentaire à l'autre, utiliser les boutons et (voir section B.III.e.iii). : affiche tous les commentaires. : affiche les commentaires détachés (lorsque le passage commenté a été supprimé ou soumis à modification). : aligne les commentaires dans la marge à gauche pour faciliter la lecture du texte. : affiche la table des matières (si le texte comporte des titres). : imprime le texte (avec ou sans les commentaires en fonction des options d'affichage sélectionnées au moment de l'impression). : exporte le texte commenté. Plusieurs formats possibles: pdf, html, sdt, epub, doc : abonne au flux public du texte. Le flux RSS permet à l'utilisateur de s'informer des dernières modifications apportées au texte. En dessous de la barre d'icône, un curseur vous permet de régler la largeur de la marge dans laquelle apparaîssent les commentaires. Déroulez la barre d'outils pour avoir accès aux fonctionnalités avancées. Il suffit pour cela de cliquer sur la «poignée» représentée par le triangle sous la barre d'outils. Vous accédez alors aux onglets et aux fonctionnalités suivantes : 36

37 «Filtrer les commentaires» : vous pouvez filtrer les commentaires du texte par état, auteur, date ou tag. L'outil de recherche permet de faire apparaître dans le texte les passages dont les commentaires contiennent le mot ou l'expression exacte renseignés (voir section B.III.e.ii). «Préférences» : le réglage des animations agit sur la vitesse d'apparition des commentaires et de déroulé des fils de discussion. «Préférences pour le texte» : choisissez un nouveau style dans la liste déroulante pour changer la classe de polices de votre texte. B.III.c. Annotation du texte Vous venez de créer votre texte co-ment. Vous pouvez maintenant procéder au travail d'annotation. Sélectionnez des passages du texte, commentez-les. Vous pouvez modifier la portée ou le contenu de vos commentaires à tout moment. A noter que seuls les gestionnaires, les éditeurs et les modérateurs peuvent modifier ou supprimer le commentaire d'autres utilisateurs. B.III.c.i. Ajouter un nouveau commentaire A l'aide de votre souris, sélectionnez dans le texte le passage à commenter puis cliquez sur le bouton jaune «+ commentaires» en haut à gauche de la fenêtre. Le formulaire d'édition du nouveau commentaire s'ouvre alors dans la marge. Ce formulaire reprend sur fond noir le passage sélectionné. Renseignez le titre de votre commentaire, son contenu, puis les tags (mots-clés) à y associer. Les tags permettront par la suite de filtrer les commentaires (voir section B.III.e.ii). Si des catégories ont été paramétrées préalablement dans l'espace de travail ou pour le texte, une liste déroulante permet de sélectionner la catégorie à associer à votre commentaire. Un trait de la couleur correspondant à la catégorie définie apparaîtra alors dans la marge le long du paragraphe contenant le passage commenté. (voir section B.II.e.i). Cliquez sur le bouton «Sauver» pour enregistrer votre commentaire. Le passage annoté et le commentaire apparaîssent alors en bleu. 37

38 B.III.c.ii. Modifier un commentaire Faites apparaître dans la marge le commentaire à modifier. Cliquez ensuite sur le lien «éditer», sous le titre du commentaire, pour accéder au formulaire d'édition. Apportez ensuite au commentaire les modifications voulues. Si vous souhaitez modifier la portée du commentaire, cochez la case prévue à cette effet en haut de la fenêtre. Vous pouvez alors sélectionner un nouveau passage dans le texte. Attention, l'ensemble du fil de discussion sera associé au nouveau passage sélectionné. Cliquez enfin sur le bouton «Sauver» pour enregistrer les changements. A noter que le nom et l'adresse mail du commentateur initial apparaissant dans la fenêtre du commentaire resteront inchangés, même si un autre utilisateur est à l'origine des modifications apportées au commentaire. B.III.c.iii. Supprimer un commentaire Pour supprimer un commentaire, cliquez sur le lien «supprimer» présent sous son titre et confirmer la suppression. La suppression d'un commentaire n'impactera pas les autres commentaires du fil de discussion. B.III.c.iv. Rédiger un commentaire en langage Markdown (version Pandoc) co-ment utilise la version Pandoc du format Markdown pour le format des commentaires. Pour exploiter toutes les possibilités de mise en forme que vous offre ce langage (liste à puces, url, note de bas de page,...), consultez la fiche mise à disposition en annexe de ce guide. B.III.d. Discussion des commentaires Vous pouvez interagir avec les autres utilisateurs en faisant référence à leurs commentaires ou en répondant directement à un commentaire. 38

39 B.III.d.i. Répondre à un commentaire Pour répondre à un commentaire, cliquez sur le lien «réponse» en bas à droite de sa fenêtre puis renseignez le formulaire d'édition. Votre réponse apparaît alors sous le commentaire avec une légère indentation. L'ensemble des réponses à un commentaire constitue un fil de discussion. La couleur du passage annoté varie en intensité (du jaune au rouge) en fonction du nombre de commentaires et de réponses aux commentaires rattachés à ce même passage. B.III.d.ii. Renvoyer à un autre commentaire Vous pouvez, dans vos commentaires, créer un lien vers un autre commentaire. L'utilisateur cliquant sur ce lien sera alors immédiatement renvoyé au commentaire auquel vous avez fait référence. Vous devez dans un premier temps récupérer le lien permanent vers le commentaire. Pour cela, survolez avec votre souris le titre du commentaire auquel vous souhaitez renvoyer. Cliquez avec le bouton gauche de votre souris sur l'icône et copier l'adresse du lien. Créez ensuite un lien vers ce commentaire dans votre commentaire en utilisant le format suivant : [texte du lien](adresse du lien). B.III.e. Affichage et parcours des commentaires Pour consulter les annotations d'un texte, co-ment vous offre plusieurs possibilités : afficher les commentaires ou fils de discussion un par un ou en totalité, les filtrer ou naviguer dans les commentaires grâce aux fonctionnalités disponibles dans la barre d'outils. B.III.e.i. Afficher les commentaires Cliquez sur un passage annoté du texte pour afficher le commentaire ou le fil de discussion associé. Vous pouvez également afficher la totalité des commentaires dans la marge en cliquant sur l'icône de la barre d'outil. Pour savoir à quel passage se rattache un commentaire, cliquez sur le commentaire : le commentaire et le passage du texte annoté apparaîtront alors en bleu. B.III.e.ii. Filtrer les commentaires Vous pouvez filtrer les commentaires par tags, auteur, date, état ou catégories (si vous en avez défini, voir section B.II.e.i). Déroulez pour cela la barre d'outil et sélectionnez le filtre que vous souhaitez appliquer aux commentaires en utilisant les listes déroulantes. A noter que vous ne pouvez utiliser qu'un seul filtre à la fois. Vous pouvez également rechercher des commentaires contenant un mot ou une expression exacte en utilisant le champ situé à droite dans l'onglet. Cliquez ensuite sur le bouton «rechercher». Seuls les passages annotés dont les commentaires contiennent le mot ou l'expression choisis apparaissent alors dans le texte. Pour procéder à un nouveau filtrage, n'oubliez pas de cliquer sur le bouton «réinitialiser». B.III.e.iii. Naviguer dans les commentaires Naviguez dans les commentaires grâce à la fonction de parcours des annotations proposée dans la barre d'outil. Choisissez dans la liste déroulante si vous souhaitez parcourir les commentaires par emplacement ou par modification : Parcourir les commentaires par emplacement vous permet de lire les commentaires dans 39

40 l'ordre du texte (soit de haut en bas sur votre écran). Parcourir les commentaires par modification vous permet de lire les commentaires en fonction de leur date de modification, du plus ancien au plus récent. Attention, la date affichée dans la fenêtre du commentaire est celle de la création du commentaire et non de sa dernière modification. Utilisez les flèches bleues pour vous déplacer dans le texte. B.III.f. Edition du texte Les gestionnaires et les éditeurs peuvent éditer un texte pour intégrer par exemple des propositions de modification reçues en commentaire. co-ment vous permet de créer ensuite une nouvelle version de votre texte avec la possibilité de conserver les commentaires affectés ou non par les modifications. B.III.f.i. Modifier un texte co-ment Pour modifier un texte, cliquez sur l'onglet «Editer». Vous accédez alors au formulaire d'édition du texte. Si vous pouvez modifier le titre et le corps du texte, vous ne pouvez en revanche en modifier le format qui reste celui défini lors de sa création. Le champ «note» vous permet de commenter brièvement les changements réalisés sur le texte. Ces indications apparaîtront ensuite dans l'onglet «Versions» à côté de la nouvelle version du texte. B.III.f.ii. Créer une nouvelle version du texte Par défaut, co-ment crée une nouvelle version de votre texte. Cela vous permet à tout moment de consulter ou de revenir à une version précédente (voir section B.III.g). Si vous ne souhaitez pas créer de nouvelle version de votre texte, décochez la case «Nouvelle version». Attention, aucun retour à l'ancienne version ne sera alors possible. B.III.f.iii. Conserver/Détacher les commentaires de l'ancienne version Par défaut, co-ment conserve tous les commentaires publiés avant la création d'une nouvelle version du texte. Les commentaires associés à des passages du texte ayant subi des modifications sont alors détachés. Ils restent consultables par la suite. Vous pouvez toutefois choisir de : ne conserver aucun des commentaires de la précédente version. Décochez pour cela les cases «conserver les commentaires» et «détacher les commentaires». Ne conserver que les commentaires associés à des passages qui n'ont pas été iaffectés par vos modifications. Décochez pour cela la case «détacher les commentaires». Ne conserver que les commentaires associés aux passages ayant subi des modifications. Décochez pour cela la case «conserver les commentaires». B.III.g. Suivi des différentes versions d'un texte co-ment vous permet de gérer le versionning de vos textes. Consultez les différentes versions d'un texte et comparez les versions deux à deux. A tout moment, vous pouvez revenir à une version antérieure de votre texte. 40

41 B.III.g.i. Consulter la liste des versions Cliquer sur l'onglet «Versions» vous permet d'accèder à la liste des différentes versions du texte. Le nombre entre parenthèses dans l'onglet vous indique le nombre de versions existantes de ce texte. Dans l'onglet, retrouvez pour chaque version : son titre son classement (la version #1 correspondant à la plus ancienne) les indications laissées par l'auteur de la nouvelle version l'auteur de la nouvelle version la date de création le nombre de commentaires En passant la souris sur le titre d'une version, vous accèdez à plusieurs liens vous permettant : de voir la version en question de la comparer à la version précédente de revenir à cette version B.III.g.ii. Comparer deux versions Sélectionnez les deux versions que vous souhaitez comparer en cliquant sur les boutons situés devant leur titre. Cliquez ensuite sur le bouton vert «Comparer les versions sélectionnées». Dans l'interface vers laquelle vous êtes dirigé, les deux versions apparaissent côte à côte. La version la plus ancienne est située à gauche de l'écran. Les modifications apportées d'une version à l'autre apparaîssent en rouge dans le texte. Dans la version ancienne, il s'agit des éléments ayant été supprimés, et dans la plus récente des éléments ayant été rajoutés au texte. Les liens situés en haut des deux versions vous permettent de revenir à la liste des versions ou d'accéder directement à l'une ou l'autre des versions comparées. 41

42 B.III.g.iii. Revenir à une version antérieure Vous pouvez à tout moment revenir à une version antérieure de votre texte. Cliquez pour cela sur le lien «revenir à cette version» qui apparaît sous le titre de la version en question lorsque vous le survolez avec votre souris. co-ment crée alors une nouvelle version de votre texte sur la base de la version sélectionnée. B.III.h. Suivi de l'activité sur le texte Pour être alerté des contributions ou modifications apportées à un texte, vous disposez d un flux RSS et d une alerte par mail. B.III.h.i. S'abonner au flux public du texte Vous pouvez vous abonner au flux public du texte en vous rendant sur l'onglet «Suivi». Vous serez alors informé de toutes les dernières modifications apportées au texte et de tous les derniers commentaires publiés. Tous les utilisateurs ayant accès au texte, quel que soit leur rôle, ont également accès à ce flux. Le flux public est associé à une adresse internet (url): vous pouvez la transmettre à tous ceux que vous souhaitez tenir informés de l'activité sur le texte, même ceux ne disposant pas d'un accès à votre espace de travail co-ment. B.III.h.ii. S'abonner au flux privé du texte Les gestionnaires peuvent s'abonner au flux privé du texte. Vous devez dans un premier temps l'activer en vous rendant sur l'onglet «Suivi». Abonnez-vous : vous serez alors notifié de l'activité du texte. Contrairement au flux public, le flux privé vous tient également informé des suppressions de commentaires (les commentaires ajoutés puis supprimés n'apparaîssent pas dans le flux public). Seuls les gestionnaires disposent de l'adresse du flux privé. Vous pouvez ensuite la transmettre à d'autres utilisateurs que vous voulez maintenir informés de l'activité sur le texte. Vous pouvez si nécessaire modifier l'adresse de votre flux privé. Il suffit pour cela de cliquer sur le bouton «Réinitialiser l'adresse du flux privé» dans la rubrique flux de l'onglet «Suivi». B.III.h.iii. S'abonner aux notifications du texte par mail Vous pouvez recevoir par les notifications du texte. Pour cela, cochez les cases prévues à cet effet dans l'onglet «Suivi». Ces notifications seront envoyées à l'adresse indiquée lors de votre enregistrement sur l'espace de travail. Vous pouvez à tout moment modifier cette adresse en éditant votre profil (voir 42

43 section B.I.a.iii). B.III.i. Partage de l'actualité de votre texte sur les réseaux sociaux Cette fonctionnalité est en cours de refonte pour ajouter de nouvelles formes de partage. 43

44 B.IV. EXPORT/IMPRESSION D'UN TEXTE CO-MENTÉ B.IV.a. Encapsulation Vous pouvez encapsuler un texte co-ment sur un site internet. Les internautes auront ainsi la possibilité d'annoter votre texte à l aide de co-ment tout en restant sur votre site. Un morceau de code HTML à copier sur le site est fourni dans ce but pour chaque texte. Dans votre espace de travail, affichez le texte à encapsuler. Cliquez ensuite sur l'onglet «Encapsulation» pour accéder au code HTML à copier sur votre site. A noter que l'encapsulation d'un texte n'est possible que pour les seuls gestionnaires de l'espace de travail ou du texte. Attention, pour pouvoir être accessible depuis votre site, le texte doit être public. Vous devez donc, avant l'encapsulation, veiller à assigner un rôle aux utilisateurs anonymes (voir section B.I.c.iv). Le rôle de commentateur devra leur être attribué si vous souhaitez que les internautes puissent commenter votre texte. B.IV.b. Impression Affichez le texte que vous souhaitez imprimer puis cliquez sur l'icône situé à droite de la barre d'outil. Plusieurs options sont alors possibles en matière de commentaires, de format et de rendu de la portée des commentaires. B.IV.b.i. Commentaires Choisissez dans la première liste déroulante les commentaires qui apparaîtront à l'impression. Vous pouvez choisir d'imprimer votre texte : avec l'ensemble des commentaires des utilisateurs ; sans aucun commentaire ; avec les commentaires que vous avez préalablement filtrés (voir section B.III.e.ii). A noter que si un commentaire filtré s'inscrit dans un fil de discussion, l'ensemble du fil de discussion apparaîtra à l'impression. Les commentaires apparaîtront en bas de page. Retrouvez les passages auxquels ils sont rattachés grâce aux numéros qui leur sont associés. 44