-
Notifications
You must be signed in to change notification settings - Fork 0
/
SUE_les_fils_de_famille_XSLT.xsl
766 lines (699 loc) · 45.7 KB
/
SUE_les_fils_de_famille_XSLT.xsl
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:tei="http://www.tei-c.org/ns/1.0"
xpath-default-namespace="http://www.tei-c.org/ns/1.0" exclude-result-prefixes="xs tei"
version="2.0">
<!-- Exclusion des préfixes TEI avec exclude-result-prefixes -->
<!-- On configure l'output HTML, avec indentation automatique et encodage en UTF-8 -->
<xsl:output method="html" indent="yes" encoding="UTF-8"/>
<!-- On évite les espaces non voulus -->
<xsl:strip-space elements="*"/>
<!-- On configure les sorties HTML -->
<xsl:template match="/">
<!-- On stocke le nom le chemin du fichier courant -->
<xsl:variable name="witfile">
<xsl:value-of select="replace(base-uri(.), 'SUE_les_fils_de_famille.xml', '')"/>
</xsl:variable>
<!-- Pour chaque output HTML de l'édition numérique, on crée une variable qui stocke le chemin de l'output, en concaténant la variable witfile crée précédemment -->
<xsl:variable name="path_homepage">
<xsl:value-of select="concat($witfile, 'html/homepage', '.html')"/>
</xsl:variable>
<xsl:variable name="path_pers_index">
<xsl:value-of select="concat($witfile, 'html/pers_index', '.html')"/>
</xsl:variable>
<xsl:variable name="path_place_index">
<xsl:value-of select="concat($witfile, 'html/place_index', '.html')"/>
</xsl:variable>
<xsl:variable name="path_relationships">
<xsl:value-of select="concat($witfile, 'html/relationships', '.html')"/>
</xsl:variable>
<xsl:variable name="path_transcription">
<xsl:value-of select="concat($witfile, 'html/transcription', '.html')"/>
</xsl:variable>
<xsl:variable name="path_transcription_enrichie">
<xsl:value-of select="concat($witfile, 'html/transcription_enrichie', '.html')"/>
</xsl:variable>
<xsl:variable name="path_original_edition">
<xsl:value-of select="concat($witfile, 'html/original_edition', '.html')"/>
</xsl:variable>
<xsl:variable name="path_analysis">
<xsl:value-of select="concat($witfile, 'html/analysis', '.html')"/>
</xsl:variable>
<xsl:variable name="path_about">
<xsl:value-of select="concat($witfile, 'html/about', '.html')"/>
</xsl:variable>
<!-- BRIQUES DE CONSTRUCTION DES SORTIES HTML -->
<!-- On crée le head HTML -->
<xsl:variable name="head">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8"/>
<meta name="description"
content="Projet d'édition numérique du roman-feuilleton les Fils de famille d'Eugène Sue (1856)"/>
<meta name="keywords" content="edition, tei, xslt, roman-feuilleton"/>
<meta name="author" content="Hugo Scheithauer"/>
<title>
<!-- On récupère le titre de l'oeuvre littéraire encodée directement dans le XML source -->
<xsl:value-of
select="concat(//sourceDesc//titleStmt/title, ', ', //sourceDesc//forename, ' ', //sourceDesc//surname)"
/>
</title>
<script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"/>
<link
href="https://cdn.jsdelivr.net/npm/[email protected]/dist/css/bootstrap.min.css"
rel="stylesheet"
integrity="sha384-eOJMYsd53ii+scO/bJGFsiCZc+5NDVN2yr8+0RDqr0Ql0h+rP48ckxlpbzKgwra6"
crossorigin="anonymous"/>
<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/js/bootstrap.bundle.min.js" integrity="sha384-JEW9xMcG8R+pH31jmWH6WWP0WintQrMb4s7ZOdauHnUtxwoG2vI5DkLtS3qm9Ekf" crossorigin="anonymous"/>
</head>
</xsl:variable>
<!-- On crée une barre de navigation -->
<xsl:variable name="nav_bar">
<nav class="navbar navbar-expand-md navbar-dark bg-dark justify-content-between">
<a class="navbar-brand" style="padding-left: 5px" href="{$path_homepage}">
<!-- On récupère le prénom et nom de l'auteur, et le titre de l'oeuvre dans la source XML -->
<xsl:value-of
select="concat(//sourceDesc//titleStmt/title, ', ', //sourceDesc//forename, ' ', //sourceDesc//surname)"
/>
</a>
<!-- Pour chaque output HTML, on crée un lien de navigation dans la barre de navigation -->
<ul class="navbar-nav mr-auto">
<li class="nav-item">
<!-- On récupère une variable entre {}. Les variables suivantes étant les chemins de fichier des différents outputs. -->
<a class="nav-link" href="{$path_original_edition}">Edition d'origine</a>
</li>
<li class="nav-item">
<a class="nav-link" href="{$path_transcription}">Transcription</a>
</li>
<li class="nav-item">
<a class="nav-link" href="{$path_transcription_enrichie}">Transcription
enrichie</a>
</li>
<li class="nav-item">
<a class="nav-link" href="{$path_pers_index}">Index des personnages</a>
</li>
<li class="nav-item">
<a class="nav-link" href="{$path_place_index}">Index des noms de lieux</a>
</li>
<li class="nav-item">
<a class="nav-link" href="{$path_relationships}">Relations entre les
personnages</a>
</li>
<li class="nav-item">
<a class="nav-link" href="{$path_analysis}">Analyses</a>
</li>
<li class="nav-item">
<a class="nav-link" href="{$path_about}">A propos</a>
</li>
</ul>
</nav>
</xsl:variable>
<!-- On crée un footer pour la mise en page -->
<xsl:variable name="footer">
<footer class="text-center text-white" style="background-color: #f1f1f1;">
<div class="text-center p-3" style="background-color: rgba(0, 0, 0, 0.2);">
<p>Hugo Scheithauer - 2021</p>
</div>
</footer>
</xsl:variable>
<!-- SORTIES HTML -->
<!-- Avec xsl:result-document, on écrit les règles de transformation pour les output
Ici, on crée l'output HTML correspondant à la page d'accueil. -->
<!-- @href permet d'indiquer le chemin du fichier de sortie
@method indique ici que la sortie sera en HTML
@indent="yes" permet d'indiquer qu'on attend du HTML indenté -->
<xsl:result-document href="{$path_homepage}" method="html" indent="yes">
<html>
<xsl:copy-of select="$head"/>
<body>
<xsl:copy-of select="$nav_bar"/>
<div style="padding: 20px;">
<figure>
<a href="https://gallica.bnf.fr/ark:/12148/bpt6k58180814/f8.item">
<img class="rounded mx-auto d-block"
src="../image/illustration_fils_de_famille_p1.png"
style="width: 38rem; height: auto"/>
</a>
<figcaption style="text-align:center;">Image d'illustration des Fils de
famille, folio 8, édition Michel Lévy Frères, 1862</figcaption>
</figure>
</div>
<div class="container">
<div style="text-align: center; padding-top: 20px;">
<p>Bienvenue dans ce projet d'édition numérique du roman-feuilleton
<i>Les Fils de famille</i> d'Eugène SUE.</p>
<p>
<xsl:value-of select="//encodingDesc"/>
</p>
<!-- Pour créer un lien renvoyant à l'édition d'origine sur Gallica, on récupère l'attribut @facs de <distributor> dans la source XML, et on l'injecte comme attribut HTML dans la balise <a> grâce aux {} -->
<p>Ce projet présente les pages 2 à 5 du roman. La numérisation est
disponible sur <a
href="https://gallica.bnf.fr/accueil/en/content/accueil-en?mode=desktop"
>Gallica</a> à cette <a
href="{//sourceDesc//publicationStmt/distributor/@facs}"
>adresse</a>.</p>
<p>Cette édition propose d'enrichir la lecture de l'oeuvre originale en
analysant le rapport des personnages par une analyse
statistique.</p>
<p>Vous pouvez naviguer à travers le projet grâce à la barre de
navigation en haut de cette page. Bonne visite !</p>
</div>
</div>
</body>
<xsl:copy-of select="$footer"/>
</html>
</xsl:result-document>
<!-- On crée l'index des personnages -->
<xsl:result-document href="{$path_pers_index}" method="html" indent="yes">
<html>
<xsl:copy-of select="$head"/>
<body>
<xsl:copy-of select="$nav_bar"/>
<div class="container">
<h1>Index des noms de personnages</h1>
<ul>
<!-- On appelle une xsl:template créée plus bas grâce à l'attribut @name. -->
<xsl:call-template name="pers_index"/>
</ul>
</div>
</body>
<xsl:copy-of select="$footer"/>
</html>
</xsl:result-document>
<!-- On crée l'index des noms de lieux -->
<xsl:result-document href="{$path_place_index}" method="html" indent="yes">
<html>
<xsl:copy-of select="$head"/>
<body>
<xsl:copy-of select="$nav_bar"/>
<div class="container">
<h1>Index des noms de lieux</h1>
<ul>
<xsl:call-template name="place_index"/>
</ul>
</div>
</body>
<xsl:copy-of select="$footer"/>
</html>
</xsl:result-document>
<!-- On crée la sortie HTML pour afficher les informations de l'édition originale -->
<xsl:result-document href="{$path_original_edition}" method="html" indent="yes">
<html>
<xsl:copy-of select="$head"/>
<body>
<xsl:copy-of select="$nav_bar"/>
<div class="container">
<h1>Informations bibligraphiques de l'édition d'origine</h1>
<ul>
<li>Titre : <xsl:value-of select="//biblFull/titleStmt/title"/></li>
<!-- On utilise la fonction concat() pour concaténer plusieurs chaînes de caractères afin de mettre en page les informations -->
<li>Auteur : <xsl:value-of
select="concat(//biblFull/titleStmt//forename, ' ', //biblFull/titleStmt//surname)"
/></li>
<li>Maison d'édition : <xsl:value-of
select="concat(//biblFull/publicationStmt/publisher, ' (', //biblFull//settlement, ', ', //biblFull//postCode, ', ', //biblFull//street, ')')"
/></li>
<li>Date d'édition : <xsl:value-of select="//biblFull//date"/></li>
<li>Mise à disposition par : <a href="{//biblFull//distributor/@facs}"
><xsl:value-of select="//biblFull//distributor"/></a></li>
</ul>
</div>
<div class="container">
<h1>Localisation de l'extrait dans l'oeuvre originale</h1>
<ul>
<!-- On sélectionne des éléments XML en testant leur attribut @unit.
Par exemple, le premier <xsl:value> récupère la valeur de l'élément <biblScope unit="part"> -->
<li>Partie : <xsl:value-of
select="//biblFull/seriesStmt/biblScope[@unit = 'part']"/></li>
<li>Chapitre : <xsl:value-of
select="//biblFull/seriesStmt/biblScope[@unit = 'chapter']"
/></li>
<li>Pages : <xsl:value-of
select="//biblFull/seriesStmt/biblScope[@unit = 'page']"/></li>
</ul>
</div>
</body>
<xsl:copy-of select="$footer"/>
</html>
</xsl:result-document>
<!-- On crée la sortie HTML de la transcription -->
<xsl:result-document href="{$path_transcription}" method="html" indent="yes">
<html>
<xsl:copy-of select="$head"/>
<body>
<xsl:copy-of select="$nav_bar"/>
<div class="container">
<xsl:element name="div">
<xsl:apply-templates select="//body"/>
</xsl:element>
</div>
</body>
<xsl:copy-of select="$footer"/>
</html>
</xsl:result-document>
<!-- On crée la sortie HTML de la transcription enrichie grâce au mode "enrichi" -->
<xsl:result-document href="{$path_transcription_enrichie}">
<html>
<xsl:copy-of select="$head"/>
<body>
<xsl:copy-of select="$nav_bar"/>
<div class="container">
<xsl:element name="div">
<xsl:apply-templates select="//body" mode="enrichi"/>
</xsl:element>
</div>
</body>
<xsl:copy-of select="$footer"/>
</html>
</xsl:result-document>
<!-- On crée la page HTML pour les analyses statistiques -->
<!-- Pour les analyses statistiques, on utilise la librairie JavaScript "Google Charts" permettant de réaliser des diagrammes. -->
<xsl:result-document href="{$path_analysis}" method="html" indent="yes">
<html>
<xsl:copy-of select="$head"/>
<body>
<xsl:copy-of select="$nav_bar"/>
<div class="container d-flex justify-content-center">
<h1>Analyses statistiques de l'extrait encodé</h1>
</div>
<div class="container">
<div class="d-flex justify-content-center" id="SpeechDistributionChart"/>
</div>
<div class="container">
<table class="columns">
<caption style="caption-side:top;">Répartition des mentions des
personnages dans tous les dialogues selon les personnages</caption>
<tr>
<td>
<div style="margin:10px; border: 1px solid #ccc"
id="GenevieveSpeechDistributionChart"/>
</td>
<td>
<div style="margin:10px; border: 1px solid #ccc"
id="CharlesDelmareSpeechDistributionChart"/>
</td>
<td>
<div style="margin:10px; border: 1px solid #ccc"
id="PereDelmareSpeechDistributionChart"/>
</td>
</tr>
</table>
<div style="margin:10px; border: 1px solid #ccc" id="test"/>
</div>
</body>
<xsl:copy-of select="$footer"/>
<!-- Ci-dessous, le script JavaScript commenté permettant l'affichage des diagrammes. -->
<script type="text/javascript">
google.charts.load('current', {
'packages':[ 'corechart']
});
google.charts.setOnLoadCallback(drawSpeechDistributionChart);
google.charts.setOnLoadCallback(drawGenevieveSpeechDistributionChart);
google.charts.setOnLoadCallback(drawCharlesDelmareSpeechDistributionChart);
google.charts.setOnLoadCallback(drawPereDelmareSpeechDistributionChart);
// Premier diagramme concernant la répartition de l'espace de parole
function drawSpeechDistributionChart() {
var data = google.visualization.arrayToDataTable([[ 'Task', "Distribution de l'espace de parole"],<xsl:for-each select="//listPerson/person">
<xsl:variable name="person">
<xsl:value-of select="persName"/>
</xsl:variable>
<xsl:variable name="person_id">
<xsl:value-of select="./@xml:id"/>
</xsl:variable>
['<xsl:value-of select="$person"/>', <xsl:value-of select="count(//said[@who = concat('#', $person_id)])"/>]<xsl:text>,</xsl:text>
</xsl:for-each>
<xsl:for-each select="//listPerson/personGrp">
<xsl:variable name="person_grp">
<xsl:value-of select="name"/>
</xsl:variable>
<xsl:variable name="person_grp_id">
<xsl:value-of select="./@xml:id"/>
</xsl:variable>
['<xsl:value-of select="$person_grp"/>', <xsl:value-of select="count(//said[@who = concat('#', $person_grp_id)])"/>]<xsl:if test="position() != last()">, </xsl:if>
</xsl:for-each>
]);
// Les valeurs récupérées grâce à ces boucle auraient pu être récupérées grâce à un simple count().
// Cependant, dans le cas où il y aurait un nombre important de personnages,
// on peut imaginer qu'il serait chronophage de les lister un par un. Ces boucles
// s'en occupent donc, mais ont pour ici valeur de démonstration.
// La première boucle récupère les personnages uniques. La deuxième boucle récupère les groupes de personnage.
// Dans notre cas, la valeur pour le seul personGrp sera de 0, la famille Dumirail n'ayant aucun dialogue dans l'extrait encodé.
// Avec xsl:text on s'assure qu'on construit un array JavaScript valide.
// On utilise un xsl:if pour construire un array JavaScript valide, au cas où les groupes de personnages seraient plus de 1.
// On n'applique pas ce xsl:if sur la boucle des personnages uniques car l'encodage XML comporte un groupe de personnages.
// Des utilisations de count() sans boucle sont effectuées plus bas.
var options = {
'title': "Distribution de l'espace de parole", 'width': 550, 'height': 400
};
var chart = new google.visualization.PieChart(document.getElementById('SpeechDistributionChart'));
chart.draw(data, options);
}
// Diagramme affichant la répartition des mentions des personnages dans l'intégralité des dialogues de Geneviève, elle y comprise.
function drawGenevieveSpeechDistributionChart() {
var data = google.visualization.arrayToDataTable([[ 'Task', "Répartition des mentions des personnages dans l'intégralité des dialogues de Geneviève, elle y comprise"],[ 'Geneviève',<xsl:value-of select="count(//said[@who = '#Geneviève']//rs[@ref = '#Geneviève'] | //said[@who = '#Geneviève']//persName[@ref = '#Geneviève'])"/>
],[ 'Charles Delmare',<xsl:value-of select="count(//said[@who = '#Geneviève']//rs[@ref = '#Charles_Delmare'] | //said[@who = '#Geneviève']//persName[@ref = '#Charles_Delmare'])"/>
],[ 'Le père Delmare',<xsl:value-of select="count(//said[@who = '#Geneviève']//rs[@ref = '#père_Delmare'] | //said[@who = '#Geneviève']//persName[@ref = '#père_Delmare'])"/>
],[ 'La famille Dumirail',<xsl:value-of select="count(//said[@who = '#Geneviève']//rs[@ref = '#famille_Dumirail'] | //said[@who = '#Geneviève']//persName[@ref = '#famille_Dumirail'])"/>
]]);
// Pour récupérer les valeurs à partir des balises rs, on utilise la fonction count() qui va compter le nombre d'occurence
// On ajoute la | pour sélectionner un autre node, en l'occurence celui des persName
// De la sorte, on calcule toutes les mentions
var options = {
'title': "Répartition des mentions des personnages dans l'intégralité des dialogues de Geneviève, elle y comprise", 'width': 400, 'height': 400
};
var chart = new google.visualization.PieChart(document.getElementById('GenevieveSpeechDistributionChart'));
chart.draw(data, options);
}
// Diagramme affichant la répartition des mentions des personnages dans l'intégralité des dialogues de Charles Delmare, lui y compris.
function drawCharlesDelmareSpeechDistributionChart() {
var data = google.visualization.arrayToDataTable([[ 'Task', "Répartition des mentions des personnages dans l'intégralité des dialogues de Charles Delmare, lui y compris"],[ 'Geneviève',<xsl:value-of select="count(//said[@who = '#Charles_Delmare']//rs[@ref = '#Geneviève'] | //said[@who = '#Charles_Delmare']//persName[@ref = '#Geneviève'])"/>
],[ 'Charles Delmare',<xsl:value-of select="count(//said[@who = '#Charles_Delmare']//rs[@ref = '#Charles_Delmare'] | //said[@who = '#Charles_Delmare']//persName[@ref = '#Charles_Delmare'])"/>
],[ 'Le père Delmare',<xsl:value-of select="count(//said[@who = '#Charles_Delmare']//rs[@ref = '#père_Delmare'] | //said[@who = '#Charles_Delmare']//persName[@ref = '#père_Delmare'])"/>
],[ 'La famille Dumirail',<xsl:value-of select="count(//said[@who = '#Charles_Delmare']//rs[@ref = '#famille_Dumirail'] | //said[@who = '#Charles_Delmare']//persName[@ref = '#famille_Dumirail'])"/>
]]);
var options = {
'title': "Répartition des mentions des personnages dans l'intégralité des dialogues de Charles Delmare, lui y compris", 'width': 400, 'height': 400
};
var chart = new google.visualization.PieChart(document.getElementById('CharlesDelmareSpeechDistributionChart'));
chart.draw(data, options);
}
// Diagramme affichant la répartition des mentions des personnages dans l'intégralité des dialogues du père Delmare, lui y compris.
function drawPereDelmareSpeechDistributionChart() {
var data = google.visualization.arrayToDataTable([[ 'Task', "Répartition des mentions des personnages dans l'intégralité des dialogues du père Delmare, lui y compris"],[ 'Geneviève',<xsl:value-of select="count(//said[@who = '#père_Delmare']//rs[@ref = '#Geneviève'] | //said[@who = '#père_Delmare']//persName[@ref = '#Geneviève'])"/>
],[ 'Charles Delmare',<xsl:value-of select="count(//said[@who = '#père_Delmare']//rs[@ref = '#Charles_Delmare'] | //said[@who = '#père_Delmare']//persName[@ref = '#Charles_Delmare'])"/>
],[ 'Le père Delmare',<xsl:value-of select="count(//said[@who = '#père_Delmare']//rs[@ref = '#père_Delmare'] | //said[@who = '#père_Delmare']//persName[@ref = '#père_Delmare'])"/>
],[ 'La famille Dumirail',<xsl:value-of select="count(//said[@who = '#père_Delmare']//rs[@ref = '#famille_Dumirail'] | //said[@who = '#père_Delmare']//persName[@ref = '#famille_Dumirail'])"/>
]]);
var options = {
'title': "Répartition des mentions des personnages dans l'intégralité des dialogues du père Delmare, lui y compris", 'width': 400, 'height': 400
};
var chart = new google.visualization.PieChart(document.getElementById('PereDelmareSpeechDistributionChart'));
chart.draw(data, options);
}
// Etant donné que dans l'extrait encodé les trois personnages n'interagissent pas tous et toutes entre eux (Charles Delmare ne
// parle qu'à Geneviève, le père Delmare ne parle qu'à Geneviève, Geneviève adresse la parole, indirectement, au père Delmare qu'une
// seule fois), il n'est pas pertinent à ce stade de faire des diagrammes de répartition des mentions dans les dialogues selon à qui
// s'adresse le personnage. On préfère se contenter des diagrammes indiquant les mentions dans l'intégralité des dialogues.</script>
</html>
</xsl:result-document>
<!-- On crée la sortie HTML pour afficher les relations entre les personnages -->
<xsl:result-document href="{$path_relationships}" method="html" indent="yes">
<html>
<xsl:copy-of select="$head"/>
<body>
<xsl:copy-of select="$nav_bar"/>
<div class="container">
<div style="text-align: center; padding-top: 20px;">
<h1>Relations entre les personnages</h1>
<br/>
<!-- On utilise une boucle xsl:for-each pour former une structure HTML pour chaque <listRelation> -->
<xsl:for-each select="//listRelation">
<h2>
<xsl:value-of select="./@type"/>
</h2>
<!-- Etant donné qu'une <listRelation> peut contenir plusieurs <relation>, on crée une boucle for-each pour toutes les traiter. L'encodage XML utilisé pour la transformation ne comprend pas plusieurs <relation> dans les <listRelation>, cependant, cette structure a tout de même mise en place dans le cas où cela serait nécessaire. Cette structure a donc valeur de démonstration. -->
<xsl:for-each select="./relation">
<dl>
<dt>Personnages</dt>
<xsl:choose>
<!-- On utilise xsl:choose pour tester si <relation> comprend un attribut @ active. Si cela est le cas, cela sous-entend la majeure partie du temps l'exitence d'un attribut @passive. -->
<xsl:when test="./@active">
<!-- On récupère les valeurs des attributs @active et @passive pour récupérer les persName plus tard. -->
<xsl:variable name="id_active">
<!-- On transforme le pointeur avec replace() -->
<xsl:value-of select="./replace(@active, '#', '')"
/>
</xsl:variable>
<xsl:variable name="id_passive">
<xsl:value-of
select="./replace(@passive, '#', '')"/>
</xsl:variable>
<dd><xsl:value-of
select="//person[@xml:id = $id_active]/persName"/>
→ <xsl:value-of
select="//person[@xml:id = $id_passive]/persName"
/></dd>
</xsl:when>
<!-- Si <relation> ne possède pas d'attribut @active, alors c'est qu'il y a probablement un attribut @mutual, que l'on va traiter ici. -->
<xsl:otherwise>
<!-- On utilise la fonction XPath translate() pour remplacer le # et le _ par un espace -->
<!-- On ne transforme pas les pointeurs par commodité, la chaîne de caractère comprenant en effet deux pointeurs, difficile à traiter et à séparer en deux entités distincts qu'on pourrait exploiter plus tard. On se contente donc du pointeur pour afficher le nom des personnages. Cette solution est applicable à @active et @passive également, l'output étant finalement le même. Cette technique a l'avantage de ne pas nécessiter la création de variable. -->
<dd>
<xsl:value-of
select="./translate(@mutual, '#_', ' ')"/>
</dd>
</xsl:otherwise>
</xsl:choose>
<dt>Type de relation</dt>
<dd>
<xsl:value-of select="./@name"/>
</dd>
</dl>
</xsl:for-each>
</xsl:for-each>
</div>
</div>
</body>
<xsl:copy-of select="$footer"/>
</html>
</xsl:result-document>
<!-- On crée la sortie HTML pour la page à propos -->
<xsl:result-document href="{$path_about}" method="html" indent="yes">
<html>
<xsl:copy-of select="$head"/>
<body>
<xsl:copy-of select="$nav_bar"/>
<div class="container">
<h1 style="text-align: center; padding: 20px;">Projet d'édition numérique -
Les fils de famille, Eugène SUE (1856), édité par la librairie Michel
Lévy Frères (1862)</h1>
<h2 style="text-align: center; padding: 10px;">Encodage XML-TEI</h2>
<p>Ce projet d'édition numérique résulte de l'encodage en XML-TEI d'un
passage du roman-feuilleton Les Fils de famille, écrit par Eugène Sue, à
l'aide d'une ODD et d'une RNG personnalisée. L'encodage a été réalisé à
partir de l'édition numérisée, disponible sur <a
href="https://gallica.bnf.fr/ark:/12148/bpt6k58180814/">Gallica</a>.
Ces règles spécifiques ont été appliquées dans le but de :</p>
<ul>
<li>Mettre en relation Les Fils de famille avec un corpus plus important
de romans-feuilletons.</li>
<li>Présenter l'histoire de la librairie Michel Lévy Frères par rapport
aux oeuvres qu'elle a édité.</li>
<li>Mettre en relief la structure littéraire de l'oeuvre textuelle
encodée. Se faisant, cet encodage est propice à la création d'un
outil de recherche scientifique, facilitant la navigation dans
l'oeuvre.</li>
<li>Etudier les rapports entre les personnages, les espaces de parole
qui leurs sont dédiés, ainsi que leur fréquence d'apparition et de
mention respective dans l'oeuvre, selon les contextes, dans le but
de produire des données statistiques. Cet encodage pourrait
permettre, à terme, une analyse poussée des différentes dynamiques
propres aux relations entre les personnages.</li>
</ul>
<h2 style="text-align: center; padding: 10px;">Transformations XSL</h2>
<p>Les transformations XSL ont pour but de réaliser une sortie HTML depuis
l'encodage en XML. L'édition numérique se présente ainsi sous la forme
de plusieurs pages HTML :</p>
<ul>
<li>Une page d'accueil</li>
<li>Les informations bibliographiques de l'édition d'origine</li>
<li>La transcription du passage encodé</li>
<li>L'index des personnages</li>
<li>L'index des noms de lieux</li>
<li>Une page détaillant les relations entre les personnages</li>
<li>Une page dédiée aux analyses statistiques des relations entre les
personnages, à partir de l'encodage des dialogues entre ceux-ci</li>
<li>Une page à propos donnant des informations sur le projet</li>
</ul>
<h2 style="text-align: center; padding: 10px;">Evaluation</h2>
<p>Ce projet a été réalisé par <a href="https://github.com/HugoSchtr">Hugo
Scheithauer</a> dans le cadre de l'évaluation du module d'XML-TEI et
d'XSLT du <a
href="http://www.chartes.psl.eu/fr/cursus/master-technologies-numeriques-appliquees-histoire"
>Master 2 "Technologies appliquées à l'histoire"</a> de l'Ecole
nationale des chartes. La feuille de transformation XSL doit répondre
aux critères suivants :</p>
<ul>
<li>Mettre en place une structure d'accueil HTML</li>
<li>Rédiger des règles simples avec un Xpath valide pour insérer des
informations du document source dans le document de sortie</li>
<li>Créer une ou des règles avec des conditions</li>
<li>Utiliser une ou des règles for-each uniquement si cela est
nécessaire</li>
<li>Proposer un code facile à lire et commenté</li>
<li>Simplifier le plus possible ses règles XSL</li>
</ul>
</div>
</body>
<xsl:copy-of select="$footer"/>
</html>
</xsl:result-document>
</xsl:template>
<!-- Templates -->
<!-- Template d'affichage de l'index des personnages -->
<xsl:template name="pers_index" match="//listPerson">
<!-- On écrit une boucle for-each pour pouvoir trier par ordre alphabétique les personnages avec xsl:sort -->
<!-- La boucle nous permettra également d'afficher les occurences des personnages dans le roman -->
<xsl:for-each select="//person">
<xsl:sort select="persName" order="ascending"/>
<li>
<!-- On affiche le nom du personnage et la note lui correspondant -->
<xsl:value-of select="concat(persName, ' : ', note)"/>
<ul>
<!-- On crée une variable qui permet de stocker l'@xml:id du personnage -->
<xsl:variable name="person_xml_id">
<xsl:value-of select="./@xml:id"/>
</xsl:variable>
<xsl:choose>
<!-- On essaye de récupérer les informations sur l'occurence des personnages avec les <persName> -->
<xsl:when
test="ancestor::TEI//body/div//persName[@ref = concat('#', $person_xml_id)]">
<!-- On utilise xsl:for-each-group pour itérer sur les persName, et on les groupe selon les <div> de premier niveau -->
<xsl:for-each-group
select="ancestor::TEI//body/div//persName[@ref = concat('#', $person_xml_id)]"
group-by="ancestor::div[1]">
<li>
<!-- On récupère les informations des attributs @type et @n des <div> au niveau des parties, et des chapitres -->
<xsl:value-of
select="concat(ancestor::body/div/div/@type, ' ', ancestor::body/div/div/@n, ', ', ancestor::div[1]/@type, ' ', ancestor::div[1]/@n)"
/>
</li>
</xsl:for-each-group>
</xsl:when>
<!-- Il est possible qu'un personnage ne soit pas mentionné directement dans le texte avec un <persName>, mais qu'il prenne la parole, signalé par un <said>.-->
<xsl:otherwise>
<xsl:for-each-group
select="ancestor::TEI//body/div//said[@who = concat('#', $person_xml_id)]"
group-by="ancestor::div[1]">
<li>
<xsl:value-of
select="concat(ancestor::body/div/div/@type, ' ', ancestor::body/div/div/@n, ', ', ancestor::div[1]/@type, ' ', ancestor::div[1]/@n)"
/>
</li>
</xsl:for-each-group>
</xsl:otherwise>
</xsl:choose>
</ul>
</li>
</xsl:for-each>
<!-- On réalise la même opération pour les personnages signalés dans l'encodage en tant que groupe avec <personGrp> -->
<xsl:for-each select="//personGrp">
<xsl:sort select="persName" order="ascending"/>
<li>
<xsl:value-of select="concat(name, ' : ', note)"/>
<ul>
<xsl:variable name="personGrp_xml_id">
<xsl:value-of select="./@xml:id"/>
</xsl:variable>
<xsl:for-each-group
select="ancestor::TEI//body/div//persName[@ref = concat('#', $personGrp_xml_id)]"
group-by="ancestor::div[1]">
<li>
<xsl:value-of
select="concat(ancestor::body/div/div/@type, ' ', ancestor::body/div/div/@n, ', ', ancestor::div[1]/@type, ' ', ancestor::div[1]/@n)"
/>
</li>
</xsl:for-each-group>
</ul>
</li>
</xsl:for-each>
</xsl:template>
<!-- Template d'affichage de l'index des noms de lieux -->
<xsl:template name="place_index">
<!-- On utilise une boucle for-each pour pouvoir créer une mise en page en fonction des informations disponibles pour chaque lieu. -->
<xsl:for-each select="//listPlace/place">
<xsl:sort select=".//name"/>
<li>
<xsl:value-of select="placeName//name"/>
<xsl:value-of select="concat(' (', @type, ')')"/>
<!-- Si le lieu a une information de ville (étant donné que l'encodage XML utilise des balises autofermantes pour <settlement>, on teste avec string-length() la longueur de la chaîne de caractère, et on vérifie que la chaîne de caractères est différente de 'none' -->
<xsl:if
test="string-length(placeName//settlement) > 1 and placeName//settlement != 'none'">
<xsl:value-of select="concat(', ', placeName//settlement)"/>
</xsl:if>
<!-- Si le lieu a une information de région (!= 'none', dans l'encodage XML), on la récupère, sinon, on ne fait rien. -->
<xsl:if test="placeName//region != 'none'">
<xsl:value-of select="concat(', ', placeName//region)"/>
</xsl:if>
<!-- Si le lieu a une information de note, on la récupère. Sinon, on met directement un '.' -->
<xsl:choose>
<xsl:when test="note">
<xsl:value-of select="concat(' : ', note)"/>
</xsl:when>
<xsl:otherwise>.</xsl:otherwise>
</xsl:choose>
</li>
</xsl:for-each>
</xsl:template>
<!-- Règles pour afficher la transcription -->
<!-- Afin d'afficher une transcription avec seulement le texte, on utilise le mode #all -->
<!-- On traite les <head> des <div> de premier niveau -->
<xsl:template match="//body/div/head" mode="#all">
<xsl:element name="h1">
<xsl:attribute name="class">text-center</xsl:attribute>
<xsl:value-of select="."/>
</xsl:element>
</xsl:template>
<!-- On traite les <head> des <div> de deuxième niveau -->
<xsl:template match="//body/div/div/head" mode="#all">
<xsl:element name="h2">
<xsl:attribute name="class">text-center</xsl:attribute>
<xsl:value-of select="."/>
</xsl:element>
</xsl:template>
<!-- On traite les <head> des <div> de troisième niveau -->
<xsl:template match="//body/div/div/div/head" mode="#all">
<xsl:element name="h3">
<xsl:attribute name="class">text-center</xsl:attribute>
<xsl:value-of select="."/>
</xsl:element>
</xsl:template>
<!-- On traite les <p> -->
<xsl:template match="//body//p" mode="#all">
<xsl:element name="p">
<xsl:apply-templates mode="#current"/>
</xsl:element>
</xsl:template>
<!-- On traite les <gap> -->
<xsl:template match="//gap" mode="#all">
<xsl:element name="p">
<xsl:attribute name="class">text-danger</xsl:attribute>
<u>Manque dans la version numérisée : <xsl:value-of select="//gap/desc"/></u>
</xsl:element>
</xsl:template>
<!-- On traite les <emph> dans les <p> pour que l'affichage soit également en italique dans la sortie HTML -->
<xsl:template match="emph[@rend = 'italic']">
<xsl:element name="i">
<xsl:apply-templates/>
</xsl:element>
</xsl:template>
<!-- Afin de proposer une transcription enrichie, on crée le mode enrichi, qui permettra d'entourer tous les <persName> et les <placeName> avec une balise <a> renvoyant à l'index des noms de lieux, ou à l'index des noms de personnage. -->
<xsl:template match="placeName" mode="enrichi">
<!-- On doit recréer les variables des chemins de fichier car celles créées initialement sont dans le scope de la première template, et ne sont donc pas disponibles en dehors. -->
<xsl:variable name="witfile">
<xsl:value-of select="replace(base-uri(.), 'SUE_les_fils_de_famille.xml', '')"/>
</xsl:variable>
<xsl:variable name="path_place_index">
<xsl:value-of select="concat($witfile, 'html/place_index', '.html')"/>
</xsl:variable>
<xsl:element name="a">
<xsl:attribute name="href">
<xsl:value-of select="$path_place_index"/>
</xsl:attribute>
<xsl:apply-templates/>
</xsl:element>
</xsl:template>
<xsl:template match="persName" mode="enrichi">
<xsl:variable name="witfile">
<xsl:value-of select="replace(base-uri(.), 'SUE_les_fils_de_famille.xml', '')"/>
</xsl:variable>
<xsl:variable name="path_pers_index">
<xsl:value-of select="concat($witfile, 'html/pers_index', '.html')"/>
</xsl:variable>
<xsl:element name="a">
<xsl:attribute name="href">
<xsl:value-of select="$path_pers_index"/>
</xsl:attribute>
<xsl:apply-templates/>
</xsl:element>
</xsl:template>
</xsl:stylesheet>