Tutoriel de production d'une édition synoptique : [ Images de facsimilé | Édition critique ]

Il est recommandé d'utiliser à la place des macros et de ce tutoriel le module d'import XML-XTZ+CSV pour produire les éditions synoptiques depuis TXM 0.7.8

Préparation

Mise à jour des sources XML avec des liens vers les fichiers images dans l'attribut @facs des balises <pb/>

  • 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)

Création de l'édition synoptique avec facsimilé

  • 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)

Remplacement des éditions TXM d'origine (HTML)

  • 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

Lecture de l'édition dans TXM pour bureau à l'aide de l'extension "Éditeur d'édition synoptique"

  • 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
public/tutoriel_edition_synoptique.txt · Dernière modification: 2016/12/22 20:48 par slh@ens-lyon.fr