Le wiki de la liste txm-users

• Télécharger l'archive des macros à utiliser : http://sourceforge.net/projects/txm/files/software/TXM%20macros/Edition/AnalyticEditionMacroPack.zip/download
• Copier le contenu (dossiers “scripts”, “xsl” et “css”) de l'archive dans le dossier “USERHOME/TXM”
• Télécharger l'archive 'ea2014.zip' des corpus exemples qui contient quelques images de facsimilés et les fichiers sources : https://filesender.ens-lyon.fr/?vid=31e3514e-d531-8989-dbb6-0000541a7ead (lien valable jusqu'au 9/07/2014)

• Dans TXM, ouvrir la vue “macro”
• Lancer la macro “edition/AddFacsAttribute”
  • Renseigner les paramètres :
    • dossier source : 'ea2014/ea2014-xml-tei'
    • dossier d'images : 'ea2014/img'
    • dossier de sortie : 'ea2014/out'
    • les paramètres “tag”, “attribute” et “prefix” ne sont pas à modifier
  • lancer l'Exécution
  • La console doit afficher qlqchose comme :

Execution de AddFacsAttributeMacro.groovy
Processing: 
 sourceDirectory: /home/xxx/corpus/ea2014/ea2014-xml-tei
 imageDirectory: /home/xxx/corpus/ea2014/img
 outputDirectory: /home/xxx/corpus/ea2014/out
 tag: pb
 attribute: facs
srcFiles=[/home/xxx/corpus/ea2014/ea2014-xml-tei/1549_DuBellayOl-b.xml, /home/xxx/corpus/ea2014/ea2014-xml-tei/qgraal_cm-b.xml]
Processing subdirectory: 1549_DuBellayOl-b with 10 images.
Processing subdirectory: qgraal_cm-b with 10 images.

• Vérifier que l'attribut @facs a bien été ajouté aux balises <pb/> des fichiers sources XML du répertoire '/home/xxx/corpus/ea2014/out'
• Si nécessaire, copier les fichiers sources non-modifiés dans le répertoire des résultats (pas nécessaire pour les sources de l'archive “ea2014.zip”)
• Copier les fichiers du dossier '/home/xxx/corpus/ea2014/out' vers le dossier '/home/xxx/corpus/ea2014/ea2014-xml-tei-facs' (qui ne contient que le fichier metadata.csv)

• Importer le corpus '/home/xxx/corpus/ea2014/ea2014-xml-tei-facs' dans TXM
  • lancer le module d'import XML/w+CSV sur le répertoire de sources '/home/xxx/corpus/ea2014/ea2014-xml-tei'
    → un nouveau corpus 'EA2014XMLTEI' est ajouté
    Remarque : le script de lancement du module XML/w+CSV 'USERHOME/TXM/scripts/import/xmlLoader.groovy' a été mis à jour par l'installation de l'archive SynopticEditionsBuilder.zip. La mise à jour consiste à ne plus avoir un nombre maximal de mots par page d'édition. Si vous souhaitez retrouver le comportement d'origine, il vous suffit de remplacer le script 'xmlLoader.groovy' par le script 'xmlLoader-orig.groovy' en le renommant 'xmlLoader.groovy'.
• Sélectionner le corpus “EA2014XMLTEI”
• Lancer la macro “FacsEditionBuilder”
  • Choisir le nom de l'édition et si nécessaire changer les paramètres “tag” et “attribute” (pas nécessaire pour les sources de l'archive “ea2014.zip”)
  • lancer l'Exécution
• À la fin de la macro, TXM redémarre ses moteurs et l'édition a été ajoutée, ou mise à jour si elle était déjà présente
• La console doit afficher qlqchose comme :

Execution de FacsEditionBuilderMacro.groovy
Corpus view selection is: EA2014XMLTEIFACS
Work directory=/home/xxx/TXM/corpora/ea2014xmltei/txm/EA2014XMLTEI
** Updating corpus configuration...
** Building new edition HTML files...
 Creating edition facs directory: /home/xxx/TXM/corpora/ea2014xmltei/HTML/EA2014XMLTEIDFACS/facs
 Build HTML pages of text=1549_DuBellayOl-b
 add page 0 w_0
 add page 1 w_0
 add page 2 w_0
 add page 3 w_1549_DuBellayOl-b_1
 add page 4 w_1549_DuBellayOl-b_153
 add page 5 w_1549_DuBellayOl-b_442
 add page 6 w_1549_DuBellayOl-b_759
 add page 7 w_1549_DuBellayOl-b_884
 add page 8 w_1549_DuBellayOl-b_1105
 add page 9 w_1549_DuBellayOl-b_1353
 add page 10 w_1549_DuBellayOl-b_1600
 Build edition references in corpus configuration
 Build HTML pages of text=qgraal_cm-b
 add page 0 w_0
 add page 1 w_0
 add page 2 w_qgraal_cm-b_1
 add page 3 w_qgraal_cm-b_455
 add page 4 w_qgraal_cm-b_902
 add page 5 w_qgraal_cm-b_1387
 add page 6 w_qgraal_cm-b_1699
 add page 7 w_qgraal_cm-b_1933
 add page 8 w_qgraal_cm-b_2422
 add page 9 w_qgraal_cm-b_2896
 add page 10 w_qgraal_cm-b_3370
 Build edition references in corpus configuration
 Saving corpus configuration...
Moteur de recherche lancé en mode mémoire.
Moteur statistique lancé.connecté.
Chargement des sous-corpus et des partitions...Terminé.
New edition created.
Terminé: 7677 ms

• Copier le dossier '/home/xxx/corpus/ea2014/img' (contenant les sous-dossiers d'images par texte) dans TXM/corpora/ea2014xmltei/HTML/EA2014XMLTEIFACS (en tenant compte du fait que le préfixe par défaut '../img/' était donné en paramètre à la macro AddFacsAttribute)

• Sélectionner le corpus “EA2014XMLTEI”
• Lancer la macro “EditionUpdater”
  • Aucun paramètre par défaut n'est à modifier
  • Lancer l'Exécution
• À la fin de la macro, TXM redémarre ses moteurs et l'édition “default” a été mise à jour
• La console doit afficher qlqchose comme :

Execution de EditionUpdaterMacro.groovy
Corpus view selection is: EA2014XMLTEI
Edition name: default
XSLs: txm-edition-xtz.xsl & txm-edition-page-split.xsl

Backup of /home/xxx/TXM/corpora/ea2014xmltei/HTML/EA2014XMLTEI directory to /home/xxx/TXM/corpora/ea2014xmltei/HTML/EA2014XMLTEI-default-back...
......................
Applying XSL 1: /home/xxx/TXM/xsl/txm-edition-xtz.xsl...
-> Applying HTMLRenderer : /home/xxx/TXM/xsl/txm-edition-xtz.xsl
..
Applying XSL 2: /home/xxx/TXM/xsl/txm-edition-page-split.xsl...
-> Applying HTMLPageSplitter: /home/xxx/TXM/xsl/txm-edition-page-split.xsl
..
Moteur de recherche lancé en mode mémoire.
Moteur statistique lancé.connecté.
Chargement des sous-corpus et des partitions...Terminé.
Terminé: 115447 ms

• Dans TXM, régler le niveau de mise à jour à ALPHA
• Installer l'extension “Synoptic Editor”
• Après redémarrage, ouvrir l'édition synoptique du corpus EA2014XMLTEI avec la commande “Read Synoptic Edition”
  • sélectionner les deux éditions : 'facs' et 'default'
  • lancer l'affichage
• Le retour au texte depuis les concordances permet également d'ouvrir l'édition synoptique