Diple, modules et méthodes pour l'édition en ligne de documents TEI

Digital humanities, TEI, Relax NG, XSL, PHP, CeCILL-C (LGPL)

Documentation
Forge (SourceSup)
Sources, svn checkout https://subversion.cru.fr/diple/trunk
Liste de diffusion: diple-dev@cru.fr

Diple

Diple propose une méthode et des modules afin de faciliter la publication en ligne de corpus XML.
Le logo associe une étoile de kleene (*) et une “diplè” (>) emprunté à la tradition antique de l'édition critique.

Exemples

Workflow: Éditer des corpus XML-TEI

Nous avons écrit un schéma TEI partagé par toutes les publications de l'École des chartes, ELEC (diple/schema/).
Un programme XSL (diple/transform/) prend en charge tous les corpus conformes à ce schéma partagé.
Un éditeur peut ainsi se concentrer sur les particularités de son corpus : son fichier XML, et de courts fichiers Relax NG et XSL spécifiques (corpus/).
Les librairies PHP et JS de Diple (diple/php/ et diple/js/) produisent le site web de consultation.
Le module XREM (diple/modules/xrem/) permet de générer la documentation du schéma.

Module XREM: documenter les fichiers XML (Relax NG, XSL, extraits XML)
`diple/modules/xrem/`

Un schéma détaillé contraint l'éditeur scientifique à bien documenter ses choix éditoriaux...
... et contraint surtout la personne responsable du balisage de la source à se conformer rigoureusement aux conventions de l'édition définies (validation XML).
XREM transforme le schéma (un jeu de fichiers Relax NG) en documentation HTML enrichie de la documentation TEI officielle.
XREM peut également générer la documentation des feuilles de style XSL.
XREM est un jeu de fichiers XSL et Javascript sans dépendance.

Quelques fonctionnalités

Une présentation pensée pour les éditeurs (et non pour les seuls développeurs).
Pour Relax NG : distingue les éléments en fonction de leur valeur d'attribut (<div type="tradition">, <div type="transcription">).
Pour XSL : les index des éléments en entrée et en sortie permettent de retrouver rapidement un template.
La documentation exploite les commentaires XML  (aucun espace de noms propriétaire nécessaire pour la documentation).
XSLT 1, permet de transformer le XML à la volée dans le navigateur.

Diple, moteur XSL
`diple/transform/`

La définition de schémas partagés permet d'approfondir la présentation de structures récurrentes, laissant l'éditeur se concentrer sur les particularités de son corpus.
Les transformations partagées ne supportent pas la totalité des éléments TEI ; elles se concentrent sur des structures particulières à l'édition critique.

Plusieurs étages de notes (historiques et philologiques) ;
Apparat critique : presentation des variantes liées au tableau de la tradition ;
Index et tables des matières...
XSLT 1, permet de transformer le XML à la volée dans le navigateur.

Diple, librairie PHP
`diple/php/`

La librairie de classes PHP permet de générer le site de consultation.
Il n'y a pas de dépendances entres les classes – ce n'est pas un framework.
Les classes sont exploitables en dehors du contexte Diple.
Quelques classes: HtmlInc (extraction des metadonnées et du body...), Hilite (surligner des motifs -regex - passés en argument), Web (manipulation des http headers...).

Outils de recherche

Diple sépare la publication de la recherche.
Les fonctionnalités de recherche dépendent de chaque corpus qui préside au choix du moteur de recherche utilisé.
Les résultats de recherche sont ensuite inclus dans le contexte de l'édition.
Des bases de données relationnelles (MySQL, SQLite), un indexeur plein texte (Lucene Solr), ou un concordancier (PhiloLogic) ont déjà été branchés.

Qu'est-ce qu'une diplè ?

Gr. διπλῆ (diplè) « ligne double, à deux branches ». Signe formé de deux lignes obliques formant un angle aigu dont la pointe est le plus souvent dirigée horizontalement (IRHT, Ædilis, Lexicon, « diplè »)

Signe (<,>) servant aux critiques grecs à indiquer des variantes dans les vers d'Homère ou à noter des vers suspects, et servant aussi à indiquer les citations des saintes Écritures. (Littré, « diple »).

Signum in libris præsertim Ecclesiasticis ad distinctionem appositum. Vide Isidorum Orig. lib. 1. cap. 20. (Du cange, « DIPLE »)

διπλῆ, (διπλοῦς) a marg. mark used by Gramm. (<*>), to indicate vv. Il., rejected verses, etc., and, in dramatic poetry, a new speaker (Liddell Scott, « διπλῆ »)

A marginal mark of this form >, used by the ancient grammarians to indicate various readings, rejected verses, beginning of a new paragraph, etc. (Oxford English Dictionary, « diple »)

In paleography, a critical mark like a Υ or Λ laid on its side , used as a mark of a paragraph, the change from one speaker to another in a drama, different readings, rejection of a reading, etc. (Century Dictionary, « diple »)

Crédits

Auteurs: F. Glorieux et V. Jolivet, avec les contributions de G. Bardet, C. Desenclos et C. Hurel
Financement: École nationale des chartes, TGE Adonis (pour le module odt>tei)
Remerciement: Comité Réseau des Universités pour la forge SourceSup
Diple est disponible sous licence open-source (CeCCIL-C / LGPL).