Home

Manuel d`installation et d`utilisation de la plateforme ()

1. E 1788 p5 2 ne E Alen on oha Alengon a 1789 5 2 on Allemagne 4 i 1779 p5 1 M 1780 p5 2 i 1783 p5 2 J 2 Allemagne a Allemagne ce 1787 p5 1 ies Alsace 5 io 1775 p5 1 EL toponymes H T Afrique 1 i Alen on 7 encon lt placeName emagne lt geogNams GH H Auch 5 amp Supprimer les r f rences sans occurences 1 Joindre les r f rences 4 Supprimer les r f rences Afficher au format HTML Cet index liste toutes les r f rences du fichier g n ral ouvert Ce sont des occurrences du fichier g n ral ayant un identifiant Ces r f rences ont des ic nes bleu clair exception faite des r f rences qui ne sont utilis es dans aucun fichier particulier Ces r f rences sont des r f rences mortes et ont des ic nes rouges Elles ne sont pas supprim es automatiquement car elles peuvent encore contenir des informations C est l utilisateur de les supprimer manuellement Les r f rences non mortes contiennent les fichiers dans lesquels elles sont utilis es Ces fichiers ont des ic nes vertes Chacun de ces l ments contient la liste des occurrences dans ce fichier l Les occurrences dans les fichiers particuliers ont des ic nes bleu fonc es Pour chaque n ud de l arbre le nombre d enfants est indiqu Un clic droit sur une r f rence propose sa suppression Sa suppression entra ne celle de toutes les r f
2. 7 a i Alen on Dans un index de fichier particulier Bigorre Bj Alen on un clic droit sur une occurrence propose a Role ET plusieurs options d externalisation Boulonnois 1 Nouvelle r f rence externaliser avec une nouvelle r f rence ou Alen on mee gay i Bourgogne 5 lier avec la r f rence d un l ment existant Autre proposition Bresse proche Amge Bretagne Angoumois lier avec la r f rence d un autre l ment Dans le premier cas une r f rence unique est cr e dans le fichier externe et le contenu ou une partie du contenu est copi Dans les trois cas l occurrence dans le fichier particulier est associ e avec une r f rence un attribut de r f rencement est ajout Pour prendre en compte les modifications il faut alors enregistrer les modifications du fichier externe et du fichier particulier Ctrl S La balise de l occurrence du fichier particulier se voit alors automatiquement ajouter un attribut de r f rence Exemple Avant eset RS ee ele ETS VS geoghName ana toponymes umlfbassespyre gt Basses Pyren es lt geogName gt Apr s Le contenu de la balise ne change pas La valeur de l attribut de r f rence ici toponymes xml bassespyre indique dans quel fichier l l ment a t externalis suivit d un et de l identifiant de l l ment dans le fichier externe Dans le cas d une r f rence existante l identifiant est celu
3. Nom du projet nouveau projet v Utiliser l emplacement par d faut Sources du projet Selectionnez l archive contenant les fichiers de configuration du projet Facultatif Parcourir A Terminer Annuler Pour les afficher il suffit de cliquer sur M Navigateur ED Pa la petite fl che en haut a droite du navigateur alas puis de s lectionner Filtres puis Ez imillefeuille 710 https s S lectionner un jeu de documents D s lectionner tout pour d sactiver les Eley documents 700 D s lectionner le jeu de documents S H E almanachs 700 3 Je documents acti filtres ou S lectionner tout pour les EG images t r activer puis validez adresses xml 650 e nA attributionsaml6 P Filtres fonctions xml 676 T Lier l diteur A peronnesxml 623 Outre le dossier documents un projet Millefeuille contient un fichier de configuration config xml un dossier validation qui contient les d finitions de dialecte XML DTD ou Sch mas un dossier stylesheets qui contient les feuilles de style XSLT n cessaires aux index et aux visualisations un dossier defaultContents qui contient des fichiers type qui seront copi s lors de la cr ation d un nouveau fichier et enfin un dossier classes qui contient les extensions du plugin ou les visualisations avanc es La configuration d un projet est expliqu e dans la partie VIII du ma
4. diteur permet en fait de copier toutes les modifications effectu es par lautre personne que l on veut garder et de supprimer ou modifier nos modifications en ditant le texte dans l diteur Une fois que le fichier local a t modifi pour prendre en compte le travail des deux personnes on peut ensuite l envoyer n oubliez pas d enregistrer avant Pour cela cliquez avec le bouton droit sur le fichier puis cliquez sur Remplacer et valider dans le menu BS EE 2 Une barre de boutons en haut de l diteur de comparaison permet notamment de naviguer dans le fichier de copier les modifications d un c t ou de l autre et d afficher l anc tre commun aux deux fichiers derni re version commune Enfin la perspective de synchronisation a une troisi me fen tre qui permet d afficher l historique d un fichier Cet historique peut tre obtenu en cliquant avec le bouton droit sur un fichier dans le navigateur puis sur Afficher historique des ressources L historique est souvent long a r cup rer soyez patient Pour revenir la perspective Millefeuille cliquez sur le bouton repr sentant une petite fen tre avec un jaune en Fy of Millefeuille haut a droite de l cran puis cliquez sur Autre Choisissez la perspective Millefeuille Le bouton gt gt droite du nom de la perspective permet de s lectionner plus rapidement les perspectives r cemmen
5. recherchera tous les l ments lt head gt ne contenant que du texte titres Remplacer Rechercher La fen tre de recherche est accessible grace es sed au menu Editer puis Rechercher Remplacer Pour utiliser des expressions r guli res il faut ermer a a cocher expressions r guli res B Recherche Le deuxi me permet de UP Recherche d un fichier B Recherche Java 97 Recherche de plug in rechercher des mots ou des expressions Contenant le texte r guli res dans un ensemble de fichiers Sea Saas Cette boite de dialogue de recherche est accessible par le menu Rechercher Masques de noms de fichiers Il faut bien faire attention xml X Choisir d effectuer la recherche dans l onglet Recherche d un fichier Les autres onglets tant des fonctionnalit s Espace de travail Ressources s lectionn es Projets englobants d Eclipse non utilis es par la Jeu de documents Choisir plateforme On peut ensuite choisir de rechercher uniquement dans certains fichiers gr ce aux boutons radio Port e Les masques sont s par s par des virgules n importe quelle cha ne tout caract re Consid rer les ressources d riv es 2 Personnaliser Remplacer Rechercher Annuler VIL2 Raccourcis clavier Eclipse dispose de nombreux raccourcis clavier Les raccourcis clavier classiques tel que CTRL
6. 1 0 encoding UTF 8 gt a nes DO d SYSTEM validation services dtd e gt millefeuille 855 gforge al Fendi aa ji mais j saone a sh lt T ins http tei c I 1 lang gt 5 amp gt documents 851 p p www tei c org ns xm ang fr lt teiHeader gt HE gt almanachs 851 keien H E images 723 Rae m services lt titleStmt gt adresses xml 847 lt title gt titre du fichier lt title gt attributions xml 850 lt principal gt Denise Ogilvie lt principal gt LL fonctions xml 847 lt titleStmt gt gt personnes xml 850 lt publicationStmt gt services xml 847 lt authority gt Archives nationales lt address gt table xml 847 lt addrLine gt rue des Francs Bourgeois 75004 toponymes xml 847 PARIS lt addrLine gt lt address gt lt authority gt a manuel odt 826 lt publicationStmt gt lt seriesStmt gt lt p gt lt p gt lt seriesStmt gt lt sourceDesc gt lt biblStruct gt lt monogr gt lt title gt titre de la source lt title gt lt imprint gt lt publisher gt imprimeur lt publisher gt lt date gt date d dition lt date gt lt pubPlace gt lt address gt lt addrLine gt adresse de l imprimeur lt addrLine gt lt address gt lt lt note gt note ventuelle lt note gt lt imprint gt lt monogr gt lt biblStruct gt lt sourceDesc gt lt fileDesc gt lt encodingDesc gt id 4 ul b ur diteur affichage html Infovis 29 IX FAQ
7. Quel est le lien entre Eclipse et la plateforme Millefeuille La plateforme est Eclipse auquel sont ajout es de nouvelles fonctionnalit s C est pour cela qu il n y a qu un seul dossier d installation et qu un seul raccourci sur le bureau ceux d Eclipse et par cons quent ceux de la plateforme J ai install la plateforme mais elle ne d marre pas ou il y a un message d erreur d s son lancement La plateforme n cessite une machine virtuelle Java jour minimum Java 1 4 Java 6 conseill pour fonctionner Cette machine virtuelle est gratuite et disponible en t l chargement sur http www java com fr Mon espace de travail ne comporte pas les trois fen tres indiqu es Navigateur Editeur Index ou elles sont d plac es V rifiez d abord que la perspective Millefeuille est s lectionn e Pour cela regardez en haut droite de l cran si le bouton qui affiche la perspective actuelle mentionne bien Millefeuille Si ce n est E e Millefeuille pas le cas cliquez sur le bouton repr sentant une petite fen tre avec un jaune puis cliquez sur Autre Choisissez la perspective Millefeuille Le bouton gt gt droite du nom de la perspective permet de s lectionner plus rapidement les perspectives r cemment utilis es Si cela ne r gle pas votre probleme r initialisez la perspective Millefeuille en cliquant avec le bouton droit sur le bouton Millefeuil
8. crire cette classe mais des comp tences informatiques assez pouss es sont n cessaires d veloppement Java Un module a d j t d velopp et est fourni avec la plateforme Il s agit d un affichage au format HTML Web Ce module applique une feuille de style XSLT au document en cours d dition et affiche le r sultat dans l onglet associ Cette feuille de style doit tre plac e dans le dossier stylesheets du projet La balise lt visualization gt ajouter dans le fichier de configuration poss de un attribut visualizationClass pour renseigner le nom de la classe de la visualisation ou de l affichage Pour l affichage HTML cet attribut doit avoir la valeur fr inria aviz millefeuille core visualization XSLT Visualization 28 La balise lt visualization gt accepte deux sous balises lt params gt qui contient une liste de param tres balise lt param gt lt jars gt qui contient une liste de biblioth que logicielle utiliser balise lt jar gt pour int grer des modules programmes tiers Ces biblioth ques logicielles sont placer dans le r pertoire classes du projet Chaque balise lt param gt a un attribut name qui correspond au nom du param tre et contient un texte qui correspond la valeur du param tre Pour l affichage HTML il faut renseigner obligatoirement le param tre name qui est le nom de l onglet associ ainsi que le param tre styl
9. velopp e par F licien Fran ois tudiant en informatique pendant un stage d t de 4 mois Ce stage s est d roul au sein de l quipe AVIZ dirig e par Jean Daniel Fekete Directeur de recherche l INRIA Denise Ogilvie Conservateur en chef du patrimoine aux Archives Nationales ainsi que Nicole Brondel et Nicole Dufournaud ont particip activement la r ussite de ce projet La plateforme a t d velopp e sous forme d un plugin a Eclipse Eclipse est une plateforme de d veloppement et d dition bien connu dans le milieu du d veloppement informatique Elle poss de de nombreuses fonctionnalit s pour le travail sur des documents XML de fa on coop rative Le plugin d velopp ajoute des fonctionnalit s d aide l dition d affichage et permet l enrichissement en information des documents encod s en XML ainsi que la navigation dans les fichiers gr ce a un syst me d index Le plugin est enti rement configurable et extensible d autres projets d encodage au format XML I 2 Eclipse IDE Eclipse est un environnement de d veloppement int gr extensible universel et polyvalent permettant potentiellement de cr er des projets de d veloppement mettant en uvre n importe quel langage de programmation Eclipse IDE est donc l origine un outil destin aux d veloppeurs logiciels et d veloppeurs web La sp cificit d Eclipse vient du fait de son architecture totalement d velopp e autour de la notion de plugin
10. 725 dufournaud Les fichiers peuvent avoir trois types d ic ne Une ic ne avec une fl che grise orient e vers la droite Cela signifie que le fichier a t modifi en local par vous depuis le dernier commit Si vos modifications sont correctes il convient de faire un Commit sur ce fichier Pour cela cliquez avec le bouton droit sur le fichier puis cliquez sur Validez dans le menu Une ic ne avec une fl che bleue orient e vers la gauche Cela signifie que le fichier a t modifi par quelqu un d autre depuis votre derni re mise jour Autrement dit la version du fichier sur le serveur SVN est plus r cente que votre version Il faut dans ce cas mettre jour le fichier Pour cela cliquez avec le bouton droit sur le fichier puis cliquez sur Mettre jour dans le menu Une ic ne avec une double fl che rouge Cela signifie que le fichier est en conflit avec la version du serveur SVN Cela peut tre caus par l une des raisons cit es ci dessus Partie VI 4 Vous avez probablement modifi le fichier en m me temps qu une autre personne Il faut donc r soudre le conflit Plusieurs options s offrent vous Soit vous d cidez que votre version est la bonne et le travail effectu par l autre personne sera perdu ou archiv plut t Pour cela cliquez avec le bouton droit sur le fichier puis cliquez sur Remplacer et valider dans le menu Soit vous d cidez que le travail ef
11. appel s feuilles de style XSLT car ils permettent d ajouter la forme au fond des fichiers XML Subversion SVN Voir chapitre 4 32 XPath Xpath est un langage simple qui permet d exprimer des chemins pour s lectionner des l ments ou groupes d l ments dans un document XML projet Un projet est un ensemble de fichiers qui sont li s un m me travail ou un m me but ainsi qu une m me configuration du plugin millefeuille espace de travail L espace de travail correspond l emplacement sur votre disque dur ou sont stock s les fichiers de vos projets Cet emplacement est visible et navigable dans le navigateur navigateur ou explorateur Le navigateur est la fen tre qui permet de naviguer dans l espace de travail de fa on assez similaire l explorateur de Windows filtre Un filtre permet de n afficher qu une partie des l ments d une liste liste de fichiers liste d occurrence concat nation La concat nation de deux chaines de caract res correspond la jointure de ces deux chaines Exemple la concat nation de le petit chat et de est mort donne le petit chat est mort chaine de caract re Une chaine de caract re est le nom informatique d un texte Il s agit en effet d une suite de caract res synchronisation La synchronisation de deux ressources correspond en fait la comparaison de ces deux ressources dans le but de les rendre identique
12. entity If the Document already includes a cover text for the same cover previously added by you or by arrangement made by the same entity you are acting on behalf of you may not add another but you may replace the old one on explicit permission from the previous publisher that added the old one The author s and publisher s of the Document do not by this License give permission to use their names for publicity for or to assert or imply endorsement of any Modified Version 5 COMBINING DOCUMENTS You may combine the Document with other documents released under this License under the terms defined in section 4 above for modified versions provided that you include in the combination all of the Invariant Sections of all of the original documents unmodified and list them all as Invariant Sections of your combined work in its license notice and that you preserve all their Warranty Disclaimers The combined work need only contain one copy of this License and multiple identical Invariant Sections may be replaced with a single copy If there are multiple Invariant Sections with the same name but different contents make the title of each such section unique by adding at the end of it in parentheses the name of the original author or publisher of that section if known or else a unique number Make the same adjustment to the section titles in the list of Invariant Sections in the license notice of the combined work In the combination you mus
13. of the Document well before redistributing any large number of copies to give them a chance to provide you with an updated version of the Document 4 MODIFICATIONS You may copy and distribute a Modified Version of the Document under the conditions of sections 2 and 3 above provided that you release the Modified Version under precisely this License with the Modified Version filling the role of the Document thus licensing distribution and modification of the Modified Version to whoever possesses a copy of it In addition you must do these things in the Modified Version A Use in the Title Page and on the covers if any a title distinct from that of the Document and from those of previous versions which should if there were any be listed in the History section of the Document You may use the same title as a previous version if the original publisher Of that version gives permission B List on the Title Page as authors one or more persons or entities responsible for authorship of the modifications in the Modified Version together with at 35 least five of the principal authors of the Document all of its principal authors if it has fewer than five unless they release you from this requirement C State on the Title page the name of the publisher of the Modified Version as the publisher D Preserve all the copyright notices of the Document E Add an appropriate copyright notice for your modifications adjacent to the other copyr
14. parce qu il b n ficie du support de la fondation Eclipse VI 1 Partage d un projet Il faut d abord cr er et envoyer le projet sur le serveur SVN Apres avoir cr et configur le projet Millefeuille un clic droit sur le projet dans le navigateur permet d afficher le menu contextuel Dans le menu quipe d di aux syst mes de gestion de version s lectionnez Partager le projet puis choisir SVN Il existe aussi le choix Partager Projets dans le menu quipe Il s agit en fait d un raccourci qui permet d arriver au formulaire suivant sans passer par l cran de choix du syst me CVS ou SVN L cran de cr ation d un nouveau r f rentiel ou d p t repository en anglais ou serveur SVN s affiche Par cr ation J entends notification Eclipse de l adresse du serveur SVN En effet le serveur SVN doit d j exister et fonctionner pour proc der cette tape Il est assez ardu de mettre en place et configurer un serveur SVN Heureusement beaucoup de sites forges h bergent gratuitement des projets informatiques et fournissent un serveur SVN C est le cas de la forge de l INRIA http gforge inria fr ou de Sourceforge http www sourceforge net r R server depuis SVN Entrer les informations de l emplacement du r f rentiel SVN D finissez les informations de l emplacement du r f rentiel Vous pouvez sp cifier Cette tape perme
15. tres sont corrects Subclipse se connecte au serveur SVN et affiche la liste des dossiers des projets pr sents sur le serveur SVN S lectionnez le dossier qui correspond au projet que vous voulez importer puis cliquez sur Terminer r S R server en tant que R server en tant que S lectionner l emplacement du projet Vous pouvez soit utiliser l emplacement par d faut de l espace et l Ensemble de Fonctionnement ou choisir d autres Tapez le nom de l Ensemble de Fonctionnement si vous voulez le cr er Emplacement V Utiliser l emplacement par d faut de l espace de travail C Users Moi S lectionner l Ensemble de Fonctionnement lt Ensemble de Fonctionnement par d faut gt lt Pr c dent Suivant gt Annuler Le dernier cran permet de SVN choisir l emplacement local sur le TE P l disque dur o le projet doit tre copi Par d faut l emplacement est celui de l espace de travail d Eclipse choisi lors du premier lancement d Eclipse Il est possible de choisir un autre emplacement en d cochant la case Lorsque vous avez fini cliquez sur Terminer pour lancer le t l chargement des fichiers du projet 18 FE R server en tant que L cran suivant permet de R server en tant que Vous pouvez r server la ressource de r f rentiel choisie en utilisant diff rentes m hodes S lectionnez la m hode de r servation que vous voulez utiliser Chois
16. 1800anVI17991800 p5 xml 606 1801 anIX18001801 p5 xml 606 1810 p5 xml 606 1811 p5 xml 606 bad 4 1813 p5 xml 606 i 1814 p5 xml 544 1816 p5 xml 606 a 4 1817 p5 xml 606 1820 p5 xml 599 1822 p5 xml 599 4 1830 p5 xml 606 1831 p5 xml 606 io La 1832 p5 xml 606 H S images 616 ae 4 adresses xml 650 h 4 attributions xml 623 a gt fonctions xml 676 Ainsi le nom du projet se voit ralong avec l adresse ou le label si on lui en a associ un du serveur SVN Ensuite les noms du projet des dossiers et des fichiers sont suivis par leur num ro de version correspondant Plus pr cis ment c est le num ro de version qu avait le fichier lors de la derni re mise jour effectu e Enfin les fichiers qui ont t modifi s localement sont pr c d s par le caract re gt Cela veut dire que j ai modifi ces fichiers et que je n ai pas encore envoy les modifications sur le serveur SVN Les dossiers qui contiennent des fichiers qui ont t modifi s sont eux aussi pr c d s par cette indication Ainsi juste en regardant si le projet est pr c d par gt on peut savoir si on a bien envoy toutes les modifications effectu es A Vinverse il n y a pas d indicateur qui permet de savoir si la version actuelle est a jour par rapport la version du serveur SVN Il faut donc penser r guli rement a mettre jour Vint gralit du projet 19 VI 4 Commandes principal
17. C pour copier CTRL V pour coller ou CTRL S pour enregistrer fonctionnent Les raccourcis claviers sont indiqu s c t de la fonctionnalit laquelle elle est associ e dans les menus Dans l diteur CTRL ESPACE permet d afficher les propositions de compl tion de balises ou d attributs Ce raccourci est souvent plus rapide pour afficher la liste que de taper le caract re lt De plus c est ma connaissance le seul moyen d avoir une proposition d attributs 25 VII Configuration du plugin VUI 1 Configuration d un projet La configuration d un projet Millefeuille se fait en ditant le fichier de configuration de projet config xml situ a la racine du projet Ce fichier est cach par d faut Pour l afficher il suffit de cliquer sur ts Navigateur 22 gt T ai la petite fl che en haut droite du navigateur AS puis de s lectionner Filtres puis Ex Millefeuille 710 https S lectionner un jeu de documents D s lectionner tout pour d sactiver les ce opera ie DE iad capi euman fi almanachs jel 44 rents acti filtres ou S lectionner tout pour les h images 616 r activer enfin validez adresses xml 650 Li attributions xml 6 Fp Filtres fonctionsxmi676 Z Lier l diteur dress i personnesxmi623 TI Outre le dossier documents un projet Millefeuille contient le fichier de configuration config xml un dossier validation qui co
18. F licien FRANCOIS 21 mars 2008 Plateforme Millefeuille Manuel Copyright c 2007 2008 F licien FRANCOIS Permission is granted to copy distribute and or modify this document under the terms of the GNU Free Documentation License Version 1 2 or any later version published by the Free Software Foundation with no Invariant Sections no Front Cover Texts and no Back Cover Texts A copy of the license is included in the section entitled Licence Remerciements Je tiens remercier Nicole Dufournaud pour ses conseils et corrections sur le manuel Denise Ogilvie et Nicole Brondel pour leur investissement dans le projet Millefeuille ainsi que Jean Daniel Fekete pour son encadrement lors du d veloppement de la plateforme Sommaire I Pr sentation de la plateforme 4 I 1 Le projet Millefeuille 4 I 2 Eclipse IDE 4 I 3 Le plugin Millefeuille 5 1 4 Subversion SVN 5 II Installation et mise en route 5 II 1 Installation de la plateforme 5 II 2 Mises jour du plugin Millefeuille 6 II 3 Premier lancement d Eclipse 6 III Le navigateur 7 II 1 Fonctionnalit s du navigateur 7 I 2 Cr ation d un projet 8 IIL 3 Cr ation d un nouveau fichier Millefeuille 9 IV L diteur XML 9 IV 1 Aides l dition 9 IV 2 Affichages ou visualisations 11 IV 3 Affichage et navigation dans la structure du document 11 V Les index 12 V 1 Index des fichiers particuliers 12 V 2 Externalisation 13 V 3 Index g n raux dans les fichiers e
19. a comparaison des fichiers distants avec les fichiers locaux Il y a trois mani res d acc der cette perspective soit suite un conflit lors d un commit Il faut cliquer sur le bouton gauche du nom de la perspective courante Millefeuille puis cliquer sur Autre Choisissez la perspective Synchronisation de l quipe Le bouton gt gt droite du nom de la perspective permet de s lectionner plus rapidement les perspectives r cemment utilis es FY ci Millefeuille soit en cliquant avec le bouton droit de la souris sur le projet ou toute autre ressource du projet fichier ou dossier menu Equipe puis Synchroniser avec le r f rentiel Dans certains cas une confirmation peut tre demand e pour passer la perspective cliquez sur 22 oui et ventuellement cochez m moriser ma d cision La perspective de Synchronisation de l quipe s ouvre alors Dans la fen tre de gauche est affich e une sorte du navigateur dans lequel ne sont affich s que les fichiers diff rents de la version du serveur SVN EU Synchronisation 2 SVN rmillefeuille 50 F JL ae E F 7 Eq 4 lt 3 iis Le millefeuille Ey documents a fonctions xml 820 felicien _ personnes xml 817 nbrondel toponymes xml 820 felicien g Fa documents almanachs set Sa 1779 xml 820 felicien M 1788 xml 820 felicien e 1830 p5 xml
20. al to that recorded in other gt extent compl tion des balises permet de SON nie te roesit faciliter encodage en proposant lt gt publicationStmt Mode te comin nate su lorsque le caract re lt est tap lt gt sourceDese une liste des balises autoris es dans le contexte du document avec une courte description en anglais Lorsqu une balise est s lectionn e elle est crite et ferm e automatiquement dans le document o5 xml 606 18 lt seriesStmt lt gt titleStmt 10 IV 2 Affichages ou visualisations 2 1791 pSxml 2 imi Le plugin a Millefeuille permet de NACH Er lt 7 visualiser un document ALMANACH ROYAL 1791 XML rapidement gr ce format lectronique des onglets situ s en bas de diteur Le Copyright c 2007 by Archives Nationales premier onglet est 2 utilisez ce document pour une publication pri re de r f rencer l URL l diteur XML les ocument If you use this document for a publication please reference this URL se ani Pon des affichages ou ALMANACH visualisations ROYAL Les affichages peuvent a A 2 ER MIMOUINE tre synchronis s avec wn ie ate aes INE l diteur c est le cas des epee Fou affichages au format P RESENTE g web r alis s gr ce des A SA MAJESTE feuilles de style XSLT Pour la premi re fois en 1699 lors du passage de T IT Ty 7 ETT l diteur l affichage il PAR LAURENT D HOURY EDITEUR est positio
21. aract riser la balise type particularit Un attribut est contenu dans l ouverture d une balise lt nombalise nomAttributi valeurAttributl nomAttribut2 valeurAttribut2 gt XML XML est un langage g n rique qui permet de structurer des textes et des informations grace des balises Il facilite l analyse s mantique automatis des documents encod s dans ce format plugin Un plugin est une extension d un logiciel Il se greffe sur ce logiciel pour lui ajouter de nouvelles fonctionnalit s plateforme Une plateforme logicielle est un ensemble d outils qui combin s permettent d effectuer un travail visualisation Une visualisation est un programme qui re oit des donn es et effectue des traitements statistiques calculs rendu pour afficher des r sultats exploitables Dans le cas du plugin millefeuille il peut aussi s agir d un programme qui permet l dition du document affichage Le mot affichage ou affichage HTML est ici utilis pour d signer la visualisation qui est fournie avec le plugin Il s agit d un petit programme qui applique une feuille de style XSLT au document XML pour le transformer en HTML et l afficher a l cran Eclipse Voir chapitre 2 XSLT XSLT est un langage de type XML Il permet de d finir des transformations effectuer sur un document XML pour obtenir un document HTML page web et permettre son affichage Les fichiers XSLT sont
22. but folder sous r pertoire de documents associ aux fichiers de ce type Tous les fichiers de ce type devront tre dans ce r pertoire Par d faut cet attribut est vide S il est renseign le r pertoire doit aussi tre cr l attribut unique qui doit avoir la valeur true si le fichier associ est unique C est le cas des fichiers utilis s pour l externalisation des index Si cet attribut est renseign le fichier doit tre cr manuellement l attribut fileName il s agit du nom de fichier par d faut qui sera utilis lors de la cr ation d un nouveau fichier de ce type Lorsque le fichier est unique il s agit imp rativement du nom de ce fichier l attribut defaultContent nom du fichier utiliser comme mod le lors de la cr ation d un 26 nouveau fichier de ce type Le fichier associ doit tre mis dans le dossier defaultContent du projet Cet attribut n est renseigner que si l attribut unique n est pas true Le type d un fichier est identifi gr ce son DOCTYPE d finition de sa DTD Chaque type de fichier est donc associ une ou plusieurs DTD grace a la sous balise lt doctype gt L attribut systemlId permet d indiquer le nom du fichier de DTD Le fichier associ est a placer dans le r pertoire validation du projet Ce DOCTYPE sert d identifiant au type de fichier m me si plusieurs types d
23. cense or distribute the Document except as expressly provided for under this License Any other attempt to copy modify sublicense or distribute the Document is void and will automatically terminate your rights under this License However parties who have received copies or rights from you under this License will not have their licenses terminated so long as such parties remain in full compliance 10 FUTURE REVISIONS OF THIS LICENSE The Free Software Foundation may publish new revised versions of the GNU Free Documentation License from time to time Such new versions will be similar in spirit to the present version but may differ in detail to address new problems or concerns See http www gnu org copyleft Each version of the License is given a distinguishing version number If the Document specifies that a particular numbered version of this License or any later version applies to it you have the option of following the terms and conditions either of that specified version or of any later version that has been published not as a draft by the Free Software Foundation If the Document does not specify a version number of this License you may choose any version ever published not as a draft by the Free Software Foundation X
24. ct Pour tre d tect comme appartenant a un type de fichier un fichier doit contenir en ent te une d claration de DTD DOCTYPE qui ressemble a ceci et correspond a son type de fichier ici fonctions dtd lt xml version 1 0 encoding UTF amp gt lt 1 DOCTYPE TEI SYSTEM validation personnes dtd gt VIIL 2 Cr ation d un index L ajout d un index a un type de fichier se fait dans le fichier de configuration gr ce la balise lt index gt plac e dans la balise lt fileType gt La balise lt index gt dispose de dix attributs lL attribut name son nom JLattribut color la couleur de fond de l index parmi les valeurs suivantes red orange yellow green blue purple grey white brown Les attributs sourceXPath extXPath et tag qui indiquent la ou les balises a indexer attribut tag et o les chercher attributs sourceXPath et extXPath Ceci est exprim gr ce au langage XPath La concat nation de sourceXPath et de tag constitue l expression XPath qui est valu e pour g n rer l index dans les fichiers particuliers extXPath constitue l expression XPath qui est valu e pour savoir a quel 27 endroit un l ment de l index doit tre externalis dans le fichier externe La concat nation de extXPath avec tag constitue l expression XPath qui est valu e pour g n rer l index dans le fichier exte
25. cument If the Cover Text requirement of section 3 is applicable to these copies of the Document then if the Document is less than one half of the entire aggregate the Document s Cover Texts may be placed on covers that bracket the Document within the aggregate or the electronic equivalent of covers if the Document is in electronic form Otherwise they must appear on printed covers that bracket the whole aggregate 8 TRANSLATION Translation is considered a kind of modification so you may distribute translations of the Document under the terms of section 4 Replacing Invariant Sections with translations requires special permission from their copyright holders but you may include translations of some or all Invariant Sections in addition to the original versions of these Invariant Sections You may include a translation of this License and all the license notices in the Document and any Warranty Disclaimers provided that you also include the original English version of this License and the original versions of those notices and disclaimers In case of a disagreement between the translation and the original version of this License or a notice or disclaimer the original version will prevail If a section in the Document is Entitled Acknowledgements Dedications or History the requirement section 4 to Preserve its Title section 1 will typically require changing the actual title 9 TERMINATION You may not copy modify subli
26. dans l diteur XML et que ces index soient configur s dans le fichier de configuration du projet Index adresses toponymes attributions fc x Structure BEL groupement d occurences Alen on 2 M Alen ong occurence La ff Alen on externalis e Angoumois 19 occurence non E Aunis 4 externalis e Ausch Auch 1 Ausch Auch Auvergne 1 basse Marche e mi Chaque index s affiche dans un onglet diff rent sous la forme d un arbre Par d faut l index n est pas calcul et l arbre n est pas d pli L index est calcul automatiquement lorsque l arbre est d pli en cliquant sur le symbole C est pour cela que l affichage de l arbre peut prendre un certain temps selon la taille du fichier et le nombre d occurrences Une ic ne de couleur bleu fonc correspond une occurrence de l index dans le fichier particulier Ex Almanach Une ic ne de couleur bleu clair correspond a un regroupement d occurrences li es une m me r f rence dans le fichier externe correspondant cet index Cela signifie que toutes les occurrences ic nes bleu fonc es regroup es dessous cet l ment correspondent une m me entit Par exemple plusieurs occurrences d un m me lieu sous un ou plusieurs noms difi rents peuvent tre regroup es gr ce l externalisation Les occurrences peuvent tre tri es par ordre alphab tique par d faut ou par ordre d occurrence en cliquant avec l
27. de nouvelles fonctionnalit s ajout es au plugin Millefeuille une nouvelle version est publi e sur le site http millefeuille gforge inria fr Pour disposer de ces am liorations 1l faut mettre jour la plateforme d j install e Pour cela 1l faut t l charger le plugin seul version installeur pour Windows ou archive pour les autres syst mes d exploitation et l installer pour la version installeur ou l extraire pour la version archive dans le dossier d installation de la plateforme Lors de l extraction il est probable qu il vous soit demand de remplacer les fichiers existants avec la nouvelle version Il faut bien entendu r pondre oui pour tous les fichiers II 3 Premier lancement d Eclipse Au premier lancement d Eclipse il vous sera demand de choisir votre Espace de travail ou Workspace C est dans ce dossier que sont stock s tous vos projets et les fichiers des projets L emplacement propos par d faut peut convenir Eclipse fonctionne avec un syst me de perspectives qui sont g n ralement associ es un type de projet 1l est possible que la perspective s lectionn e par d faut ne soit pas la perspective Millefeuille mais une autre par exemple la perspective Java destin e au d veloppement d applications Java Si ce n est pas le cas cliquez sur l ic ne a c t cliquez sur Autre puis E e Millefeuille ms E 87 Java s lectionnez Millefeuille dans
28. e bouton droit sur l index sur le sommet de l arbre Un double clic sur ce sommet permet de plier ou d plier totalement l arbre Un champ texte permet de filtrer des occurrences Il suffit de rentrer un ou des mots et de cliquer sur le bouton filtrer Seules les occurrences qui contiennent tous les mots peut importe l ordre la casse ou les accents seront affich es Pour revenir l tat initial il suffit d effacer les mots recherch s et de cliquer de nouveau sur filtrer 12 V 2 Externalisation L externalisation consiste copier des informations d un fichier particulier dans un fichier g n ral commun du projet Cela permet de lier ces informations entre elles Du point de vue de l affichage des index cela consiste associer une occurrence bleu fonc une r f rence externe qui peut tre commune plusieurs occurrences y compris des occurrences de fichiers diff rents Dans l arbre cette occurrence se retrouve regroup e avec ventuellement d autres occurrences sous une seule r f rence Cette externalisation permet aussi de pouvoir ajouter des informations sur un l ment une personne par exemple sans dupliquer l information pour chaque occurrence et surtout sans modifier le fichier particulier qui doit rester le plus proche possible de la source En effet une fois l externalisation r alis e on peut ajouter autant de contenu que l on veut dans ce fichier externe Berri eee eae
29. e bureau pour lancer la plateforme est alors cr Pour les autre versions il suffit d extraire l archive dans le r pertoire de votre choix c Program files par exemple pour Windows Pour lancer la plateforme il faut lancer l ex cutable eclipse exe eclipse sous Linux ou MacOs du dossier eclipse Pour les versions Linux et MacOs le plugin SubVersive permettant d utiliser SVN n est pas install La proc dure suivre est indiqu e a adresse suivante http www polarion org index php page installation amp project subversive Enfin la plateforme Millefeuille tant plus gourmande en ressources que l utilisation pr vue par Eclipse il est conseill de modifier la m moire vive allou e Eclipse pour son fonctionnement Cette manipulation peut viter des erreurs de type Java Heap Space Il suffit d diter avec un diteur de texte le fichier de configuration eclipse ini pr sent dans le dossier Eclipse La valeur qui suit Xms est la quantit de m moire allou e Eclipse son d marrage 40m par d faut Elle peut tre fix e sans probl me 64m La valeur qui suit Xmx est la quantit de m moire maximum allou e Eclipse 256m par d faut Il est pr f rable de la modifier 512m voire 1024m si la quantit de m moire vive install e sur l ordinateur le permet II 2 Mises jour du plugin Millefeuille Lorsque des bugs sont corrig s ou
30. e fichiers utilisent le m me dialecte XML la m me DTD il faut dupliquer le fichier de DTD pour chaque type de fichiers Enfin les index et affichages sont associ s a un type de fichier Tous les fichiers d tect s comme appartenant a un type de fichier disposeront des m mes index et des m mes affichages lt xml version 1 0 encoding UIF amp 8 7 gt lt project name num risation d almanach gt lt description gt projet des archives nationales lt description gt path id documents projectPath documents f gt lt path id classes projectPath classes f gt path id stylesheets projectPath stylesheets gt h id validation projectPath validation gt th id defaultContents projectPath defaultContents gt lt fileType id 1l name almanach fileName Almanach xml defaultContent almanach zml folder almanachs gt doctype svstemld almanach ps dtd gt lt doctype svstemld almanach dtd gt lt l d finition des indexs et des affichages gt lt FileType gt lt fileType id F 2 name personnes unique true fileName personnes xml folder gt doctype svstemld personnes dtd gt lt l d finition des indexs et des affichages gt lt fileType gt fileType id f 3 name adresses unique true fileName adresses xml folder gt lt doctype systemid adresses dtd gt lt l d finition des indexs et des affichages gt lt fileType gt lt proje
31. entiel Utiliser disposition de projet unique Utiliser disposition de projet multiple avec le nom de racine sp cifi millefeuille Utiliser les dispositions recommand s par SVN troncs branches et tiquettes L emplacement des fichiers du projet sur le r f rentiel sera diff rent en d pendant du type de disposition s lectionn Vous pouvez voir ci dessous l emplacement des prochains fichiers amp https scm gforge inria fr svn millefeuille trunk millefeuille lt Pr c dent Suivant gt Annuler FE Assistant Partager Projet Entrer un commentaire SVN Partager projet millefeuille dans https scm gforge inria fr svn millefeuille Choisir un commentaire ou un mod le pr c demment crit v Launch the Commit Dialog for the shared resources lt Pr c dent Suivant gt Terminer Annuler Ecrire le commentaire de Commettre pour l op ration Partager Projet VI 2 Importation d un projet L cran suivant permet de choisir le nom du dossier qui sera associ au projet sur le serveur SVN ainsi que la structure a donner au d p t Choisissez utiliser le nom du projet et Utiliser le Motif de l emplacement du r f rentiel puis cliquez sur suivant Le dernier cran permet d associer un commentaire a la cr ation du projet sur le SVN Le syst me SVN permet d associer un commentaire a toutes les actions qui ser
32. es Les deux commandes les plus fr quemment utilis es sont mise jour update et commit toutes deux accessibles via le menu contextuel bouton droit du navigateur puis menu quipe Mise jour permet de r cup rer la derni re version du projet La mise jour est effectu e uniquement sur la ressource s lectionn e lors du clic droit pour ouvrir le menu Commit permet d envoyer les modifications effectu es en local sur le serveur SVN L action porte uniquement sur la ressource s lectionn e lors du clic droit A chaque nouveau Commit la version associ e au projet est incr ment e de un Tous les fichiers envoy s lors de cet envoi sont eux aussi marqu s avec ce num ro de version Les fichiers qui n ont pas t modifi s gardent leur num ro de version pr c dent S Valider Entrer un commentaire Vous pouvez sp cifier un nouveau message ou choisir le message pr c dent Les SV N commentaires vides sont accept s mais en crivant un message de commentaire aidera d autres personnes comprendre les changements Comment Choisir un commentaire ou un mod le pr c demment crit 5 Vv Keep Locks Paste selected names Resource Content Properties V millefeuille documents almanachs 1788 p5 xml Modifi V millefeuille documents almanachs 1789 p5 xml Modifi 7 millefeuille documents almanachs 1790 p5 xml Modifi 7 millefeui
33. es are designated as being those of Invariant Sections in the notice that says that the Document is released under this License If a section does not fit the above definition of Secondary then it is not allowed to be designated as Invariant The Document may contain zero Invariant Sections If the Document does not identify any Invariant Sections then there are none The Cover Texts are certain short passages of text that are listed as Front Cover Texts or Back Cover Texts in the notice that says that the Document is released under this License A Front Cover Text may be at most 5 words and a Back Cover Text may be at most 25 words A Transparent copy of the Document means a machine readable copy represented in a format whose specification is available to the general public that is suitable for revising the document straightforwardly with generic text editors or for images composed of pixels generic paint programs or for drawings some widely available drawing editor and that is suitable for input to text formatters or for automatic translation to a variety of formats suitable for input to text formatters A copy made in an otherwise Transparent file format whose markup or absence of markup has been arranged to thwart or discourage subsequent modification by readers is not Transparent An image format is not Transparent if used for any substantial amount of text A copy that is not Transparent is called Opaque 34 Examples of s
34. esheet qui est le nom de la feuille de style utiliser Il est possible de passer des param tres la feuille de style grace aux param tres facultatifs de cet affichage commen ant par xsl Exemple un affichage HTML et une visualisation tierce sans param tres lt fileType id f6 name services unique true fileMame services xml fColder gt doctype systemid services dtd gt lt Visualization visualizationClass fr inria aviz millefeuille core visualization xXSLIVisualization gt lt params gt lt param name name gt affichage html lt param gt lt param name stylesheet gt millefeuille xsl lt param gt lt param name xsl imageFile gt documents images imagetypo xml lt param gt lt param name xsl imagePath gt images lt param gt lt params gt lt visualization gt lt visualization visualizationClass fr inria aviz millefeuille infovis InfoVisualization gt lt jars gt lt jar gt intfovisualization jar lt jar gt lt jar gt intfovis jar lt jar gt lt autre jars gt lt jars gt lt visualization lt ileType gt Apres avoir enregistr le fichier config xml et red marr Eclipse on obtient Millefeuille services xml Eclipse SDK oI Fichier Editer Naviguer Rechercher Projet Run Fen tre Aide ri QE Gr M M ere FY e Millefeuille si ts Navigateur 2 O servicesxml 5 Gi Index Structure m B M lt xml version
35. fectu par l autre personne est le bon votre travail sera perdu ou archiv plut t Pour cela cliquez avec le bouton droit sur le fichier puis cliquez sur Surcharger et mettre jour dans le menu Soit vous d cidez de joindre les modifications effectu es par l autre personne avec les v tres Pour cela ouvrez le fichier dans l diteur de comparaison en double cliquant dessus L diteur de comparaison peut tre ouvert pour tous les fichiers de la m me fa on D diteur de comparaison est en fait un diteur avec deux fen tres une pour le fichier local gauche qui est utilisable pour modifier le fichier local et une fen tre droite pour le fichier distant sur le serveur SVN en lecture seule Pour modifier le fichier distant il faut obligatoirement effectuer une des actions Commit Valider ou Surcharger et Valider Des cadres color s apparaissent pour indiquer les diff rences entre les deux fichiers Ces cadres ont les m mes codes de couleur que les fichiers gris bleu rouge 25 ge EL CG CE IN GEL On voit par exemple qu une partie du placeName je Bae pi y ie ire eo fichier a t modifi e des deux c t s de fa on PS ree pees lt p gt diff rente En cliquant sur le lien entre les EE deux blocs rouges fl che vers la gauche les LODE la MOIT P laceName gt Re modifications effectu es par l autre personne TETEN seront copi es dans le fichier local Cet
36. i de l l ment d j existant dans le fichier externe Dans le cas de la cr ation d une nouvelle r f rence l l ment est copi dans le fichier externe int gralement ou en partie selon la configuration et associ un identifiant g n r automatiquement Exemple voici ce qui a t ajout au fichier externe gecogName xml id bassespyre Basses Pvren es lt geogNamez Lidentifiant n a aucune signification intrins que Il doit seulement tre unique et ne pas contenir de caract res sp ciaux Le plugin s en charge automatiquement 13 Ce lien est tr s important il permet au plugin d afficher les index Ainsi tous les l ments d un index pour lesquels l attribut de r f rencement a t renseign seront consid r s comme externalis s Si le plugin ne trouve pas l identifiant dans le fichier externe l ic ne deviendra rouge pour indiquer qu il y a une erreur Un clic droit sur une occurrence d j externalis e ou sur un regroupement d occurrences puis la s lection du menu supprimer permet d enlever le r f rencement dans ce fichier particulier des occurrences s lectionn es La s lection multiple gr ce la touche Majuscule Shift et du clic d un l ment puis d un autre permet de disposer de nouvelles actions dans le menu contextuel clic droit sur les l ments s lectionn s M Allemagne 2 fattributions ma E A
37. ight notices F Include immediately after the copyright notices a license notice giving the public permission to use the Modified Version under the terms of this License in the form shown in the Addendum below G Preserve in that license notice the full lists of Invariant Sections and required Cover Texts given in the Document s license notice H Include an unaltered copy of this License I Preserve the section Entitled History Preserve its Title and add to it an item stating at least the title year new authors and publisher of the Modified Version as given on the Title Page If there is no section Entitled History in the Document create one stating the title year authors and publisher of the Document as given on its Title Page then add an item describing the Modified Version as stated in the previous sentence J Preserve the network location if any given in the Document for public access to a Transparent copy of the Document and likewise the network locations given in the Document for previous versions it was based on These may be placed in the History section You may omit a network location for a work that was published at least four years before the Document itself or if the original publisher of the version it refers to gives permission K For any section Entitled Acknowledgements or Dedications Preserve the Title of the section and preserve in the section all the substance and tone of each of the contributor acknowledge
38. ir comment r server le dossier millefeuille la r servation utilisant les options Assistant Nouvel Projet et Recherche Projets est valable seulement s il n existe pas de fichier project dans la ressource R en tant que projet configur l aide de Assistant Nouvel Projet echercher des projets dans les sous dossiers de la ressource choisie R server en tant que dossier dans un projet existant R server en tant que projet avec le nom sp cifi millefeuille v R serve r cursivement SVN Pr c dent Suivant gt Annuler choisir si le dossier sur SVN doit s importer comme un projet Eclipse ou comme un dossier dans un projet Choisissez R server en tant que projet avec le nom sp cifi Le nom du projet est bien renseign par d faut mais vous pouvez le modifier votre convenance Laissez coch R serve r cursivement pour que tous les sous dossiers du projet soient charg s puis cliquez sur Suivant VI 3 Indications visuelles Subclipse modifie le navigateur pour ajouter des indications concernant les versions des fichiers et des dossiers Ep gt documents 718 Gy gt almanachs 700 a 1775 p5xml 606 1779 p5 xml 606 1780 p5 xml 606 A 1783 p5 xml 606 1787 p5 xml 606 jj gt 1788 p5 xml 700 DL 1725501606 gt 1700 p5 xml 681 i 1791 p5 xml 606 i 1792 p5 xml 606 gt 1703anll p5 xml 606 2 7 4 1794anl p5 xml 606 1799anV117981799 p5 xml 606 A
39. la liste D bogage V rifiez en haut a droite que la oni Se Java perspective Millefeuille est bien J Navigation Java s lectionn e Autre Millefeuille SDK Eclipse Fichier Editer Naviguer Rechercher Projet Ex cuter Fen tre Aide Vous devriez alors obtenir ae Qay 3 iF i r EH ye Per or ES 2 Millefeuille x cs Navigateur A Index X N Structure m un environnement de 87 D travail proche de cette capture d cran compos principalement d une barre de menu une barre d outils une fen tre a gauche appel e navigateur dans la suite du manuel une fen tre centrale actuellement vide qui contiendra l diteur XML et les affichages lorsqu un fichier sera ouvert et une troisi me fen tre droite qui contiendra les index et la structure du document III Le navigateur III 1 Fonctionnalit s du navigateur Le navigateur est la fen tre de gauche ices vale SUS Sa de la perspective de travail Millefeuille C est ph a dans cette fen tre que l on acc de aux projets eer et a leurs fichiers Un clic droit dans cette o a fen tre ouvre un menu contextuel proposant a asda plusieurs fonctionnalit s Race Les menus Importer Exporter a oe Ex cuter D boguer et Profiler ES sont des fonctionnalit s d Eclipse non ad utilis es par la plateforme Il convient donc de a Actualiser ne pas les utiliser ne Le
40. le perspective courante puis cliquez sur r initialiser Cette action n a qu un effet graphique cela remet toutes les fen tres par d faut de la perspective avec les tailles et positionnements par d faut Je n arrive pas a me connecter au serveur SVN Si vous tes sur votre lieu de travail ou connect a Internet par le r seau d une institution publique ou par celui d une entreprise il est possible que la connexion au serveur SVN doive se faire travers un proxy Pour que Subclipse utilise ce Proxy r cup rez l adresse du Proxy aupr s de votre service informatique Allez dans l explorateur de fichier de Windows dans le dossier C Documents and _ Settings Utilisateur Application Data Subversion en rempla ant Utilisateur par le nom de l utilisateur qui utilise la plateforme Certains de ces dossiers sont cach s il vous faudra certainement afficher les fichiers cach s pour y acc der Ouvrez ensuite le fichier servers avec le bloc note Modifiez les deux lignes suivantes a la fin du fichier http proxy host defaultproxy whatever com http proxy port 7000 Enlevez le et l espace qui d butent chaque ligne Remplacez defaultproxy whatever com par l adresse du Proxy et 7000 par le port du proxy Si le Proxy n cessite un nom d utilisateur et un mot de passe modifiez aussi les deux lignes suivantes de la m me fa on Enregistrez les modifications et red marrez Ecli
41. lle documents almanachs 1793anll p5 xml Modifi 7 millefeuille documents fonctions xml Modifi Selected 5 of 5 Annuler Selectionner tout Effacer S lection Pour effectuer l envoi Commit une boite de dialogue s ouvre Elle permet de choisir parmi les fichiers qui ont t modifi s depuis la derni re mise jour lesquels doivent tre envoy s La plupart du temps on envoie tous les fichiers modifi s Cette boite de dialogue propose aussi d associer un commentaire modifications effectu es raisons des modifications circonstances Une liste d roulante d acc s rapide aux commentaires pr c demment tap s permet de r utiliser les commentaires pr c dents La case cocher keep Locks permet de garder les verrous sur fichiers tels qu ils le sont Les verrous sont une fonctionnalit de SVN qui permet d emp cher la modification ult rieure d un fichier tout le monde ou certaines personnes Il est conseill de le laisser coch par d faut Pour mieux comprendre le fonctionnement d un serveur SVN voici des exemples de succession d actions Mise jour et Commit effectu es par deux utilisateurs diff rents sur un serveur SVN 20 Succession d op rations sans conflit id al Utilisateur 1 Serveur SVN Utilisateur 2 1am Actions __ a AGEN TEE team Version 205 Version 211 X Version 211 Version 211 lt Mi
42. lsace z E Alsace er my 2 Alsace ALSACES zace gi ce EERE 1 i Tout externaliser gleterre 2 d Supprimer toutes les r f rences i TC EN CTI Nouvelle r f rence W Aunis Wi Alsace 1 Tout externaliser permet d effectuer une externalisation en masse Une r f rence sera cr e pour chaque occurrence non externalis e de la s lection Tout externaliser avec une seule r f rence permet de joindre des occurrences qu elles soient d ja externalis es ou non sous une seule r f rence Si la s lection contient des occurrences d ja externalis es le menu propose de choisir de tout joindre sous une des r f rences existantes Supprimer toutes les r f rences permet de d r f rencer toutes les occurrences externalis es de la s lection V 3 Index g n raux dans les fichiers externes Un index assez similaire s affiche lors de l ouverture des fichiers g n raux Il y a cependant des diff rences qui permettent de rep rer rapidement que c est un fichier externe la couleur de fond tr s l g re pour les index dans les fichiers particuliers est ici beaucoup plus prononc e l arbre une fois d pli ne compte pas 2 niveaux mais 3 niveaux les menus contextuels ne proposent pas les m mes fonctionnalit s 14 Index Structure toponymes filtrer 7a ane 1 i 1783 p5 1 T Alen on 7 E 1775 is 4
43. ments and or dedications given therein L Preserve all the Invariant Sections of the Document unaltered in their text and in their titles Section numbers or the equivalent are not considered part of the section titles M Delete any section Entitled Endorsements Such a section may not be included in the Modified Version N Do not retitle any existing section to be Entitled Endorsements or to conflict in title with any Invariant Section O Preserve any Warranty Disclaimers If the Modified Version includes new front matter sections or appendices that qualify as Secondary Sections and contain no material copied from the Document you may at your option designate some or all of these sections as invariant To do this add their titles to the list of Invariant Sections in the Modified Version s license notice These titles must be distinct from any other section titles You may add a section Entitled Endorsements provided it contains nothing but endorsements of your Modified Version by various parties for example statements of peer review or that the text has been approved by an organization as the authoritative definition of a standard You may add a passage of up to five words as a Front Cover Text and a passage of up to 25 words as a Back Cover Text to the end of the list of Cover Texts in the Modified Version Only one passage of Front Cover Text and one of Back Cover Text may be added by or through arrangements made by any one
44. mit apr s avoir fini de travailler Il est aussi vivement conseill d en faire de temps en temps pendant le travail aux tapes ou les fichiers modifi s sont dans un tat correct Le plugin Subclipse permet de g rer les conflits Lors d un commit il y a conflit si le fichier a envoyer n est pas une modification de la version la plus r cente pr sente sur le serveur mais une modification d une version ant rieure Le commit n est alors pas effectu par Subclipse et une boite de dialogue propose de passer dans une perspective permettant la r solution des conflits Cette perspective permet la comparaison des fichiers distants du serveur SVN avec les fichiers locaux Elle est d crite dans la suite du manuel Il ne faut cependant pas en abuser R soudre les conflits est souvent plus co teux en temps que de les viter Je conseille donc d utiliser au maximum les regles suivantes Mettre jour le projet entier syst matiquement avant de commencer travailler et r guli rement ensuite Faire un commit sur chaque fichier ou groupe de fichiers lorsqu ils sont dans un tat correct Faire un commit sur tous les fichiers modifi s sur le projet lorsque l on a fini de travailler Organiser le travail coop ratif de sorte que deux personnes ne travaillent pas sur le m me fichier en m me temps VIS Comparaisons entre fichiers distants et fichiers locaux Subversive fournit une perspective d di e a l
45. ncadrer et structurer des informations Les balises compos es d l ments et d attributs sont entour es par les chevrons lt et gt Chaque type de document Ex Almanach est associ un dialecte XML DTD qui d finit les balises que le document a le droit d utiliser et sous quelles conditions L diteur XML fournit la coloration syntaxique les l ments les attributs et le texte n ont pas la m me couleur Ces couleurs sont configurables via le menu contextuel de l diteur bouton droit sur l diteur puis Pr f rences gt Web et XML gt Fichiers XML gt Styles XML lt teiHeaderz eriteneses l ment s lectionn authority D Il propose aussi l affichage __ _ _ S tend de la ligne 11 la ligne 13 e T P lt titleStmt gt marqueur d erreur des lignes ainsi que l tendue 7 titler ssai pour 1814 lt title gt Di asl A d une zone entre deux balises sur incipal gt Denise Ogilvie lt principal gt Lo G 7 citlestmt gt description de l erreur le c t gauche Ces fonctionnalit s lt publicationStmt 4 ee a i sont activables ou d sactivables en lt authority rchives nationales lt address gt EE ee de fin address manquante cliquant avec le bouton droit sur la ees Appuyez sur F2 pour mettre en vidence bande de gauche 14 lt publicationsStmt gt 1790 p5xml 5 l lt xml versit 2 lt DOCTYPE TI L di
46. nn e l ou le curseur d dition tait positionn dans l diteur XML Lors du passage visualisation sous forme HTML p 5 Be ete a de affichage A GAA F ia RC ER ie l diteur il est BE A Ahn Stn ART BIKES 3 positionn l endroit o BEATS ON kik Lee Dra or ii l affichage tait F ss ne diteur affi chage html IV3 Affichage et navigation dans la structure du document FY a Millefeuille Lorsqu un document est ouvert dans 7 9 nde a C7 l diteur la fen tre de droite se synchronise avec i oo i l diteur et fournit deux onglets les index et la j oD structure du document 2E body L affichage de la structure du document se i Re fait sous forme d arbre interactif La navigation E fw place top right L dans cet arbre provoque le d placement de Jas TN l diteur sur les l ments s lectionn s et vice versa El head Le menu contextuel bouton droit sur Ll arbre a an propose aussi des fonctions d dition du document Ajouter un attribut ajout d attributs et d l ments Cette vue peut piri a top left tre int ressante pour avoir une vue d ensemble du corel italic document rep rer les ent tes et se situer dans la CE structure d un texte 11 V Les index V 1 Index des fichiers particuliers Les index s affichent dans la fen tre de droite l onglet index Pour qu un ou plusieurs index s affichent il faut qu un fichier soit ouvert
47. nt que label v Passer en revue D Utiliser un label personnel Authentification Utilisateur felicien Mot de passe eeeeeeee 4 Les donn es secr tes sont enregistr es sur votre ordinateur dans un fichier dont la lecture est difficile mais pas impossible par un intrus Montrer les informations d utilisateur pour lt Repository Location gt Valider l emplacement du r f rentiel la fin Annuler les Changements lt Pr c dent suivant gt Terminer Annuler R server depuis SVN S lectionner Ressource S lectionner une ressource qui sera extraite come un projet gt Gallica 535 o imanachs 715 millefeuille 612 C plugin 722 4 A ROOT 722 Wig REVISIONS L cran d ajout d un nouveau r f rentiel ou d p t repository en anglais ou serveur SVN s affiche Cette tape permettra d ajouter un serveur SVN dans la liste des serveurs SVN Il suffit alors de remplir le premier onglet G n ral du formulaire avec l adresse du serveur SVN URL ainsi que le nom d utilisateur et le mot de passe de la personne qui utilisera la plateforme Si une seule personne utilise la plateforme sur le poste il est judicieux de cocher enregistrer le mot de passe pour ne plus avoir le saisir Les autres champs et onglets peuvent tre laiss s par d faut Cliquez ensuite sur Suivant Si les param
48. ntient les d finitions de dialecte XML DTD ou Sch mas un dossier stylesheets qui contient les feuilles de style XSLT n cessaires aux index et aux visualisations un dossier defaultContents qui contient des fichiers type qui seront copi s lors de la cr ation d un nouveau fichier et enfin un dossier classes qui contient les extensions du plugin ou les visualisations avanc es Le fichier de configuration est au format XML et sa balise principale est la balise lt project gt Cette balise est unique et la racine du document La balise lt project gt a un attribut name pour renseigner le nom du projet Elle a trois sous balises la balise lt description gt unique qui contient une description du projet des balises lt path gt obligatoires qui d finissent les diff rents r pertoires cit s ci dessus Lattribut id est l indentifiant du r pertoire et l attribut projectPath est le chemin du r pertoire Les r pertoires d identifiant documents classes stylesheets Validation et defaultContents doivent tre d finis des balises lt fileType gt qui d finissent les types de fichiers du projet et leurs caract ristiques Chaque type de fichier a six attributs l attribut id identifiant du type de fichier qui doit commencer par une lettre et ne pas contenir d espace l attribut name nom du type de fichier l attri
49. nuel II 3 Cr ation d un nouveau fichier Millefeuille Pour cr er un nouveau fichier associ un projet d encodage il suffit de cliquer avec le bouton droit dans la fen tre du navigateur sur le projet ou l un de ses sous dossiers puis nouveau et fichier Millefeuille Cette boite de dialogue peut aussi tre ouverte via le menu Fichier Nouveau fichier Millefeuille Assistant de cr ation de fichier xml Dossier millefeuille documents almanachs Parcourir Type de fichier almanach x Nom de fichier 1814 xml Il suffit alors de renseigner le type de fichier parmi ceux d finis dans les fichiers de configuration du projet et le nom du fichier cr er Un fichier est alors cr dans le projet l emplacement souhait et us ouvert dans l diteur Le contenu du fichier est le contenu par d faut associ au type de fichier choisi IV L diteur XML L diteur XML s ouvre dans la fen tre centrale lorsque l on ouvre un fichier XML en double cliquant dessus dans le navigateur Plusieurs fichiers peuvent tre ouverts simultan ment ils disposent alors chacun d un onglet dans cette fen tre Le nom de l onglet est le nom du fichier Il est important de bien rep rer cette information car 1l est facile de confondre deux fichiers XML lorsqu il y en a plusieurs ouverts en m me temps IV 1 Aides l dition XML est un langage qui utilise des balises pour e
50. ocument may include Warranty Disclaimers next to the notice which states that this License applies to the Document These Warranty Disclaimers are considered to be included by reference in this License but only as regards disclaiming warranties any other implication that these Warranty Disclaimers may have is void and has no effect on the meaning of this License 2 VERBATIM COPYING You may copy and distribute the Document in any medium either commercially or noncommercially provided that this License the copyright notices and the license notice saying this License applies to the Document are reproduced in all copies and that you add no other conditions whatsoever to those of this License You may not use technical measures to obstruct or control the reading or further copying of the copies you make or distribute However you may accept compensation in exchange for copies If you distribute a large enough number of copies you must also follow the conditions in section 3 You may also lend copies under the same conditions stated above and you may publicly display copies 3 COPYING IN QUANTITY If you publish printed copies or copies in media that commonly have printed covers of the Document numbering more than 100 and the Document s license notice requires Cover Texts you must enclose the copies in covers that carry clearly and legibly all these Cover Texts Front Cover Texts on the front cover and Back Cover Texts on the back cove
51. oient des commandes au serveur pour r cup rer les fichiers modifi s par les autres utilisateurs ou pour envoyer les modifications effectu es sur ces fichiers SVN permet d acc der toutes les versions successives d un fichier et donc d annuler des modifications ou de r soudre des conflits modifications simultan es Cela permet aussi de suivre l volution d un projet et voir ce qui a t fait par qui et a quel moment ID Installation et mise en route II 1 Installation de la plateforme La plateforme d encodage et de visualisation du projet Millefeuille est bas e sur Eclipse logiciel libre disponible sur http www eclipse org La plateforme est donc compatible avec un grand nombre de systemes d exploitation dont Windows Linux et Mac OS Une machine virtuelle Java a jour minimum Java 1 4 Java 6 conseill est n cessaire pour la faire fonctionner Cette machine virtuelle est gratuite et disponible en t l chargement sur http www java com ft Il existe une version de la plateforme pr configur e et traduite en francais disponible sur http millefeuille gforge inria fr pour Windows sous forme d un installeur exe ou d une archive z1p Linux sous forme d une archive zip MacOs sous forme d une archive zip Installer la plateforme par ce moyen est facile Pour la version installeur pour Windows il suffit de lancer cet ex cutable et de cliquer sur suivant Un raccourci sur l
52. ont effectu es sur le projet ajouts modifications Subclipse le plugin Eclipse utilis pour acc der au systeme SVN fournit un acc s rapide aux commentaires d ja crits via un menu d roulant pour en permettre la r utilisation Laissez coch e la case Launch the Commit Dialog for the shared ressources cela permettra de lancer l import initial des fichiers du projet sur le serveur SVN Une boite de dialogue permettant d effectuer une action Commit envoi sur l ensemble des fichiers appara tra lorsque le bouton Termin sera cliqu Son fonctionnement est d crit dans la suite du manuel Lorsque le projet est d j existant sur un serveur SVN il faut l importer dans Eclipse pour pouvoir travailler dessus Pour cela 1l faut cr er un nouveau projet gr ce au menu Fichier puis Nouveau puis Projet Ce menu est aussi accessible via le menu contextuel du navigateur bouton droit Une liste des types de projets possible appara t choisissez Projets depuis SVN dans l arbre dans le dossier SVN puis cliquez sur suivant 17 r R server depuis SVN Entrer les informations de l emplacement du r f rentiel D finissez les informations de l emplacement du r f rentiel Vous pouvez sp cifier G n ral Avanc R glages SSH R glages SSL Proxy URL https scm gforge inria fr svn millefeuille Label Utiliser l URL du r f rentiel en ta
53. pie de la licence en anglais GNU Free Documentation License Version 1 2 November 2002 Copyright C 2000 2001 2002 Free Software Foundation Inc 51 Franklin St Fifth Floor Boston MA 02110 1301 USA Everyone is permitted to copy and distribute verbatim copies of this license document but changing it is not allowed 0 PREAMBLE The purpose of this License is to make a manual textbook or other functional and useful document free in the sense of freedom to assure everyone the effective freedom to copy and redistribute it with or without modifying it either commercially or noncommercially Secondarily this License preserves for the author and publisher a way to get credit for their work while not being considered responsible for modifications made by others This License is a kind of copyleft which means that derivative works of the document must themselves be free in the same sense It complements the GNU General Public License which is a copyleft license designed for free software We have designed this License in order to use it for manuals for free software because free software needs free documentation a free program should come with manuals providing the same freedoms that the software does But this License is not limited to software manuals it can be used for any textual work regardless of subject matter or whether it is published as a printed book We recommend this License principally for works whose purpose is ins
54. possible accompagn d une capture d cran millefeuille webmaster lists gforge inria fr 31 X Glossaire El ment Dans le langage XML un l ment est une balise avec son contenu attribut texte et sous balises du texte ou un attribut Cet l ment peut contenir d autres l ments appel s enfants Il peut aussi tre contenu dans un l ment parent L l ment racine du document est le seul ne pas avoir de parent Balise Dans le langage XML les balises permettent de s parer les diff rents textes et informations en unit s s mantiques Le nom d une balise est une chaine de caract res ne contenant pas d espace L ouverture d une balise se fait par le texte suivant lt nomBalise attributsEventuels gt La fermeture d une balise se fait par le texte suivant lt nomBalise gt Le contenu de la balise est plac entre les deux Si le contenu est vide l ouverture et la fermeture de balise peuvent tre jointes en lt nomBalise attributsEventuels gt DTD et Dialecte XML Un dialecte XML est un langage bas sur le langage g n rique XML La DTD d finit les noms de balises et d attributs qui peuvent tre utilis s leurs imbrications possibles et leur s mantique TEI est le dialecte qui est utilis pour le projet Millefeuille Attribut Dans le langage XML un attribut est une valeur associ e un nom d attribut dans une balise Les attributs sont utilis s pour c
55. pse 30 L action commit ne fonctionne pas Le serveur SVN fonctionne gr ce un syst me de cache Lorsque l on envoie des fichiers action commit 1l copie les fichiers dans ce cache avant d effectuer l action ce moment seulement les fichiers sont d plac s au bon endroit Si on annule un commit avant qu il soit termin l action n est pas effectu e mais le cache contient toujours ces fichiers Cela peut poser des probl mes si l on retente d envoyer les m mes fichiers Pour nettoyer ce cache et donc r soudre ces probl mes il suffit de cliquer sur l action nettoyer du menu quipe bouton droit sur le projet gt quipe gt nettoyer L affichage HTML ne fonctionne pas Cela peut tre d la pr sence de caract res non latins grecs chinois symboles dans le fichier XML Le processeur XSLT utilis par le plugin ne semble pas pouvoir transformer ces fichiers Ceci est un bug qui est encore dans la liste des bugs corriger dans le plugin L affichage HTML ne fonctionne pas Cela peut tre d la pr sence de caract res non latins grecs chinois symboles dans le fichier XML Le processeur XSLT utilis par le plugin ne semble pas pouvoir transformer ces fichiers Ceci est un bug qui est encore dans la liste des bugs corriger dans le plugin Mon probleme ne figure pas dans la FAQ Si vous le jugez n cessaire envoyez nous un descriptif complet du probl me si
56. r Both covers must also clearly and legibly identify you as the publisher of these copies The front cover must present the full title with all words of the title equally prominent and visible You may add other material on the covers in addition Copying with changes limited to the covers as long as they preserve the title of the Document and satisfy these conditions can be treated as verbatim copying in other respects If the required texts for either cover are too voluminous to fit legibly you should put the first ones listed as many as fit reasonably on the actual cover and continue the rest onto adjacent pages If you publish or distribute Opaque copies of the Document numbering more than 100 you must either include a machine readable Transparent copy along with each Opaque copy or state in or with each Opaque copy a computer network location from which the general network using public has access to download using public standard network protocols a complete Transparent copy of the Document free of added material If you use the latter option you must take reasonably prudent steps when you begin distribution of Opaque copies in quantity to ensure that this Transparent copy will remain thus accessible at the stated location until at least one year after the last time you distribute an Opaque copy directly or through your agents or retailers of that edition to the public It is requested but not required that you contact the authors
57. rences cet l ment dans les fichiers externes La s lection de plusieurs l ments avec Majuscule clic permet de nouvelles actions dans le menu contextuel bouton droit Joindre les r f rences permet de joindre deux r f rences en une seule Les modifications sont appliqu es tous les occurrences portant ces r f rences Supprimer les r f rences sans occurrence permet de supprimer les r f rences mortes Supprimer les r f rences permet de supprimer des r f rences dans le fichier g n ral mais galement les r f rences correspondantes dans les fichiers particuliers Afficher au format HTML permet d afficher la s lection sous forme de tableau HTML Un clic droit sur le sommet de l arbre l index permet d afficher au format HTML la totalit de l arbre de filtrer les r f rences par fichier particulier Comme pour les index des fichiers particuliers un double clic sur le sommet de l arbre permet de plier d plier l arbre dans sa totalit on peut filtrer par mots cl s 15 VI Utilisation de SVN avec Subversive La premi re tape avant de travailler sur un projet en coop ration est de choisir un syst me de gestion de version Notre choix s est port sur SVN car c est certainement le systeme le plus efficace et le plus utilis Son int gration dans Eclipse n cessite un plugin nous avons choisi Subversive pour sa simplicit son efficacit et aussi
58. rne Ces trois compos s doivent donc tre des expressions XPath valides pour que l index fonctionne L attribut referenceAttribute est l attribut des l ments index s qui doit tre utilis dans les fichiers particuliers pour les lier aux r f rences du fichier externe _ L attribut prefix est une chaine de caract res qui sera utilis e suivit d un num ro unique pour g n rer les identifiants d faut de chaine de caract re significative de l l ment par exemple pour les l ments vides _ L attribut nameXSLT contient le nom de la feuille de style XSLT qui sera utilis e pour g n rer le nom d un l ment dans l index Elle aura en entr e l l ment XML correspondant elle doit produire une chaine de caract re Le fichier correspondant doit tre plac dans le r pertoire stylesheets du projet JL attribut infos XSLT contient le nom de la feuille de style XSLT qui sera utilis e pour g n rer des informations plus completes que le nom sur un l ment de l index Cet attribut n est pas encore utilis par la plateforme Il pourra sans doute tre utilis dans les nouvelles fonctionnalit s qui seront d velopp es ult rieurement JL attribut fileExternalisation contient une r f rence vers le type de fichier unique du fichier externe celui dans lequel l externalisation doit se faire Cette r f rence est en fait le caract re suivi du contenu de l a
59. rojet Millefeuille il faut faire attention aux fichiers externes Si l utilisateur 1 travaille sur l externalisation de l index des personnes du fichier 1789 xml et l utilisateur 2 sur celui des personnes du fichier 1814 xml alors le fichier externe des personnes sera modifi par les deux utilisateurs en m me temps et cr era un conflit Conflit d un oubli de mise jour avant de travailler Utilisateur 1 Serveur SVN Utilisateur 2 1789xm 1814 xml 1789 xml 1814 xml 1789 xml 1814 xml gt Mise jour gt rsion 214 Travail sur 1814 xml V214 modifi e Version 215 lt Commit lt Version 215 Oubli de mise jour V214 modifi e Travail sur 1814 xml Conflit gt Commit gt Conflit Ce type de conflit est tr s facile viter il suffit de mettre syst matiquement jour l ensemble du projet avant de commencer travailler 21 Conflit d un oubli de commit apr s avoir fini de travailler Utilisateur 1 Serveur SVN 1789 xml 1814 xml 1789 xml 1814 xml 1789 xml 1814 xml Version 214 Version 214 V214 modifi e Version 214 Version 214 Travail sur 1814 xml Oubli de commit Version 214 Version 214 V214 modifi e Version 215 gt Mise a jour gt Travail sur 1814 xml Version 215 Conflit lt Commit lt Conflit gt Commit gt Celui ci est aussi facile a viter il suffit de faire un com
60. s Si l une des deux a t modifi e il faut modifier l autre et vice versa Dans le cas du SVN il s agit de la comparaison des fichiers locaux sur le disque dur de votre ordinateur dans l espace de travail et des fichiers distants sur le serveur SVN perspective Eclipse est une plateforme fournissant des outils tr s divers Un projet selon les langages utilis s et le type de projet ne n cessite pas tous ces outils Les outils fen tres boutons menus diteurs sont group s dans les perspectives ax Pour la plateforme Millefeuille les deux perspectives utiles sont la Ei perspective Millefeuille qui fournit les outils d dition d index de navigation et de visualisation et la perspective Synchronisation SVN qui regroupe les outils li s SVN On peut changer de perspective gr ce au bouton en haut droite de l cran IDE ou environnement de d veloppement int gr Il s agit d une suite d outils utilis s pour le d veloppement de logiciels et int gr s dans une seule plateforme compl tion La compl tion est une action de l diteur qui lorsqu on lui indique complete la balise ou l attribut qu on a commenc taper 33 Xl Licence Ce manuel est sous licence GNU Free Documentation ce qui signifie qu il est libre Il peut tre distribu copi et modifi gratuitement condition de mentionner le nom de l auteur originel savoir F licien FRANCOIS Voici une co
61. s menus Equipe Comparer ES et Remplacer par sont des fonctionnalit s pai t associ es au syst me de gestion de version oe Elles sont expliqu es dans la partie VI du s RES manuel Tar eur aia Le menu Nouveau permet la A cr ation de nouveau projet ou de nouveau ere su fichier IIL 2 Cr ation d un projet Si le projet est d j cr et partag sur un syst me de gestion de versions ex SVN se reporter la partie VI du manuel pour les explications sur l importation d un projet existant Un projet Millefeuille est un projet d encodage au format XML Il est d fini par ses types de fichiers Ex Almanachs les relations entre ces fichiers Ex Externalisation ainsi qu une liste d index et d affichages amp Nouveau projet Millefeuille Le menu Fichier gt Nouveau gt Projet Millefeuille permet de cr er un nouveau projet Il faut alors renseigner le nom du projet et ventuellement s lectionner une archive zip qui contient les fichiers d un projet type Une fois valid e l architecture d un projet Millefeuille est cr e Par d faut le navigateur ou explorateur n affiche que le dossier documents ainsi que son ventuel contenu Cependant le projet contient d autres fichiers qui sont cach s Nouveau projet Millefeuille cr ation d un nouveau projet millefeuille Nom et localisation du projet sur le disque
62. se jour lt V211 modifi e Travail sur 1789 xml Version 212 gt Commit gt Version 212 gt Mise jour gt Version 212 Creation de 1814 xml Sans Version Travail sur 1814 xml Version 213 lt Commit lt Version 213 Version 213 lt Mise jour lt V213 modifi e Travail sur 1814 xml V212 modifi e Travail sur 1789 xml Travail sur 1814 xml gt Commit gt V214 modifi e Travail sur 1789 xml gt Commit gt gt Mise a jour gt V214 modifi e Version 215 Travail sur 1814 xml Version 215 lt Commit lt gt Mise jour gt Les deux utilisateurs peuvent par exemple travailler successivement sur les m mes fichiers a condition de mettre jour leurs fichiers avant de travailler et d envoyer les fichiers modifi s apr s leur travail I est aussi possible de travailler en m me temps sur des fichiers diff rents Certaines successions peuvent cr er des conflits En voici une liste exhaustive Conflit d des modifications simultan es sur le m me fichier Utilisateur 1 Serveur SVN Utilisateur 2 ee ee gt Mise a jour gt V214 el Travail sur 1814 xml Travail sur 1814 xml V214 modifi e Version 215 lt Commit lt Version 215 Conflit gt Commit gt Conflit Ce type de conflit peut tre vit en se mettant d accord pour ne pas travailler sur les m mes fichiers en m me temps Dans le cas d un p
63. t combine any sections Entitled History in the various original documents forming one section Entitled History likewise combine any sections Entitled Acknowledgements and any sections Entitled Dedications You must delete all sections Entitled Endorsements 6 COLLECTIONS OF DOCUMENTS You may make a collection consisting of the Document and other documents released under this License and replace the individual copies of this License in the various documents with a single copy that is included in the collection provided that you follow the rules of this License for verbatim copying of each of the documents in all other respects You may extract a single document from such a collection and distribute it individually under this License provided you insert a copy of this License into the extracted document and follow this License in all other respects regarding verbatim copying of that document 36 7 AGGREGATION WITH INDEPENDENT WORKS A compilation of the Document or its derivatives with other separate and independent documents or works in or on a volume of a storage or distribution medium is called an aggregate if the copyright resulting from the compilation is not used to limit the legal rights of the compilation s users beyond what the individual works permit When the Document is included in an aggregate this License does not apply to the other works in the aggregate which are not themselves derivative works of the Do
64. t utilis es VI 6 Fonctionnalit s avanc es L diteur de comparaison peut aussi tre ouvert depuis la perspective Millefeuille Pour cela cliquez avec le bouton droit sur un fichier puis menu Comparer puis Dernier du r f rentiel pour comparer avec la version actuelle du serveur SVN ou R vision pour comparer avec une version dont on conna t le num ro De m me si le travail que vous avez effectu sur un fichier ne vous convient pas vous pouvez remplacer ce fichier par la derni re version du SVN une sorte de mise jour sur un fichier modifi Pour cela cliquez avec le bouton droit sur un fichier puis menu Remplacer par puis Dernier du r f rentiel 24 VII Fonctionnalit s utiles d Eclipse VII 1 Outils de Recherche Eclipse fournit deux moyens de rechercher des mots dans les fichiers Recherche et remplace des donn es Le premier est disponible uniquement lorsqu un diteur XML est ouvert il permet de rechercher et de remplacer des mots ou des expressions r gulieres dans le fichier ouvert Une expression r guli re est une suite de Rechercher Remplacer par Sens Port e Avant Tous 5 Arri re Lignes s lectionn es caract res comportant des symboles permettant Options d exprimer des familles de mots rechercher Par L Respecter maj min a Rechercher les renvois a la ligne exemple expression r guliere on ae lt head lt lt head gt
65. teur indique galement si le fichier en cours d dition a t 3 oe aa modifi petite toile c t du nom du fichier et quelles lignes il y a eu 4 teiHeadi 5 i 7 re des modifications gr ce une coloration mauve de la bande de gauche lt tit dans l exemple les lignes 3 4 et 6 ont t modifi es 7 lt til 8 lt pr De plus l diteur valide en temps r el lors de toute modification les documents XML selon leur sch ma ou dialecte Il affiche les erreurs de fa on assez discr te sur la bande de droite Un marqueur rouge correspond a une erreur un marqueur jaune a une mise en garde Le survol du marqueur avec la souris permet d avoir plus de d tails concernant l erreur Un clic sur le marqueur positionne diteur sur I erreur Cet diteur inclut aussi un correcteur orthographique activable d sactivable et configurable via le menu contextuel clic droit sur l diteur Pr f rences gt G n ral gt Editeurs gt Editeurs de texte gt Correcteur orthographique L activation du correcteur orthographique peut entra ner des pertes de performances voire des blocages sur des gros fichiers XML Il est donc conseill de le d sactiver 8 1791 p5xml 606 17 lt p gt lt p gt 1792 iti El ment notesStmt Ru Enfin la proposition et Jdoc Notes statement collects together any notes providing 24 information about a text addition
66. toutes les fonctionnalit s de cette plateforme sont d velopp es en tant que plugin Eclipse a t choisi comme base de la plateforme d encodage du projet Millefeuille pour principalement deux raisons d une part Eclipse fournit des outils d dition de langages XML des outils de gestion de projets et int gre un syst me de gestion de versions d autre part Eclipse est tr s facilement modulable et extensible I 3 Le plugin Millefeuille Voici les principales fonctionnalit s que le plugin Millefeuille ajoute a Eclipse assistant de cr ation de fichiers g n ration d index affichage des documents sous diverses formes gr ce a des feuilles de style cr ation d index g n raux communs plusieurs fichiers et regroupement des occurrences filtres et navigation dans les index Le plugin est enti rement configurable via l dition d un fichier XML Ainsi en ajoutant quelques lignes dans le fichier de configuration on peut facilement d finir un nouveau type de fichiers et ajouter de nouveaux index ou de nouvelles visualisations Ce plugin est donc adaptable a n importe quel projet d encodage au format XML quelque soit le dialecte utilis 1 4 Subversion SVN Subversion en abr g SVN est un logiciel libre de gestion de version publi sous licence Apache BSD Il permet de centraliser des documents sur un serveur unique et l dition collaborative de ces documents Les utilisateurs env
67. truction or reference 1 APPLICABILITY AND DEFINITIONS This License applies to any manual or other work in any medium that contains a notice placed by the copyright holder saying it can be distributed under the terms of this License Such a notice grants a world wide royalty free license unlimited in duration to use that work under the conditions stated herein The Document below refers to any such manual or work Any member of the public is a licensee and is addressed as you You accept the license if you copy modify or distribute the work in a way requiring permission under copyright law A Modified Version of the Document means any work containing the Document or a portion of it either copied verbatim or with modifications and or translated into another language A Secondary Section is a named appendix or a front matter section of the Document that deals exclusively with the relationship of the publishers or authors of the Document to the Document s overall subject or to related matters and contains nothing that could fall directly within that overall subject Thus if the Document is in part a textbook of mathematics a Secondary Section may not explain any mathematics The relationship could be a matter of historical connection with the subject or with related matters or of legal commercial philosophical ethical or political position regarding them The Invariant Sections are certain Secondary Sections whose titl
68. ttra d ajouter un mr serveur SVN dans la liste des serveurs SVN n ral Avanc R glages SSH R glages SSL Proxy URL https scm gforge inria fr svn millefeuille v Passer en revue g res Il suffit alors de remplir le premier FE a di ee onglet G n ral du formulaire avec tiliser un label personnel l adresse du serveur SVN URL ainsi que le eres nom d utilisateur et le mot de passe de la Utilisateur felicien personne qui utilisera la plateforme Si une Mot de passe eeeeeeee seule personne utilise la plateforme sur le poste il est judicieux de cocher enregistrer le Les donn es secr tes sont enregistr es sur votre ordinateur dans un fichier dont 5 e la lecture est difficile mais pas impossible par un intrus mot de passe pour ne plus aVolr a le salsir Les autres champs et onglets peuvent tre laiss s par d faut Cliquez ensuite sur Montrer les informations d utilisateur pour lt Repository Locatior suivant v Valider l emplacement du r f rentiel a la fin Annuler les Changements lt Pr c dent I suivant gt Termine Annuler 16 Assistant Partager Projet Entrer un nom de Projet Choisir le nom du projet sur le r f rentiel SVN Nom sur le r f rentiel Utiliser un nom vide Utiliser un nom sp cifi millefeuille Disposition du r f rentiel du Projet Utiliser le Motif de l Emplacement du r f r
69. ttribut id du type de fichier destination Exemple lt fileType id f1 name almanach fileMName 4lmanach xml defaultContent almanach xml folder almanachs gt lt doctype systemid almanach p5S dtd gt doctype systemiId almanach dtd gt index name personnes color orange tag tel persName referenceAttribute ana prefix p nameXSLT personneMName xsl infos XSLT personnelnfos xsl sourceXPath tei TElL tei text tei body extkpath tei TEL tei text tei body tei p fileExternalization f2 gt index name adresses color blue tag tel address referencettribute ana prefix l nameXSLT adresseName xsl infosXSLT adresselnfos xsl sourceXPath tei TEL tei text tei body extkpath tei TEL tei text tei body tei p fileExternalization f3 gt lt d finition des affichages gt lt fileType gt VUI 3 Cr ation d un affichage ou d une visualisation Un affichage ou une visualisation est en fait un module ou un programme tiers qui se greffe sur Eclipse Cette greffe se fait par l interm diaire de la balise lt visualization gt plac e dans la balise lt fileType gt du fichier de configuration Ce module doit tre d velopp en Java et proposer une classe qui impl mente l interface frinria aviz millefeuille core visualization Vizualisation L int gration de modules d j existant la plateforme ne demande bien souvent que tr s peu de travail il suffit d
70. uitable formats for Transparent copies include plain ASCII without markup Texinfo input format LaTeX input format SGML or XML using a publicly available DTD and standard conforming simple HTML PostScript or PDF designed for human modification Examples of transparent image formats include PNG XCF and JPG Opaque formats include proprietary formats that can be read and edited only by proprietary word processors SGML or XML for which the DTD and or processing tools are not generally available and the machine generated HTML PostScript or PDF produced by some word processors for output purposes only The Title Page means for a printed book the title page itself plus such following pages as are needed to hold legibly the material this License requires to appear in the title page For works in formats which do not have any title page as such Title Page means the text near the most prominent appearance of the work s title preceding the beginning of the body of the text A section Entitled XYZ means a named subunit of the Document whose title either is precisely XYZ or contains XYZ in parentheses following text that translates XYZ in another language Here XYZ stands for a specific section name mentioned below such as Acknowledgements Dedications Endorsements or History To Preserve the Title of such a section when you modify the Document means that it remains a section Entitled XYZ according to this definition The D
71. xternes 14 VI Utilisation de SVN avec Subversive 16 VI 1 Partage d un projet 16 VI2 Importation d un projet 17 VI 3 Indications visuelles 19 VI 4 Commandes principales 20 VIS Comparaisons entre fichiers distants et fichiers locaux 22 VI 6 Fonctionnalit s avanc es 24 VID Fonctionnalit s utiles d Eclipse 25 VII 1 Outils de Recherche 25 VII 2 Raccourcis clavier 25 VIID Configuration du plugin 26 VHI 1 Configuration d un projet 26 VIIL2 Cr ation d un index 27 VIIL3 Cr ation d un affichage ou d une visualisation 28 IX FA 30 X Glossaire 32 XD Licence 34 Pr sentation de la plateforme I 1 Le projet Millefeuille Le projet Millefeuille a t initi par l cole des Chartes l INRIA institut National de Recherche en Informatique et Automatique et les Archives Nationales Il avait pour but de d analyser des sources historiques au format XML pour tudier la structure de l administration fran aise et son volution au cours des 18 me et 19 me si cles La source principale d informations sur ce sujet est la collection des Almanachs ouvrages imprim s tous les ans pendant plus de deux si cles et d crivant les services et personnes de l administration fran aise ainsi que leurs fonctions L encodage dans un format structur XML et TEI permet l analyse de ces documents Le projet a d bouch en 2007 sur le d veloppement d une plateforme d encodage et de travail sur ces documents La plateforme a t d

Manuel d`installation et d`utilisation de la plateforme ()

Contents

Download Pdf Manuals

Related Search

Related Contents