Un petit billet pour vous présenter DOE (Dépôt des ODD d’ELAN)Ça veut dire “biche” en anglais, on aime bien les cervidés par chez nous , le site où nous rassemblons la documentation de nos projets en TEI, créé par Serena Crespi et AnneGF et que j’ai repris depuis mon arrivée.
En effet, en arrivant à ELAN, j’ai fait une mise à jour de nombre des ODDODD ?! Vous savez, cet acronyme que l’on retrouve souvent en TEI : One Document Doesitall (je colle tout, sinon l’acronyme ne marche pas 😉 ). et une refonte du graphisme du site de présentation.
ODD ?!? Pour celles et ceux qui n’auraient pas eu la chance de les rencontrer, les fichiers XML ODD permettent de préciser les règles d’encodage que les fichiers doivent respecter. Dans notre cas, il s’agit de restreindre la TEI, sélectionner un sous-ensemble de balises qui seront utilisées dans un projet, avec un ensemble d’attributs dont on peut également préciser les valeurs autorisées.
La bonne nouvelle ? Les ODD sont eux-même des fichiers TEI ! 😎
Pourquoi créer DOE ? À ELAN, nous réutilisons sans cesse notre expérience passées pour créer de nouveaux schémas TEI, surtout lorsque l’objet à éditer à des similarités avec un projet existant. En arrivant en août, j’ai pu rapidement agir sur les projets, car je disposais de nombreux exemples documentés. Le site DOE ouvre cette documentation avec une interface plus accueillante que celle d’un dépôt git, que vous pouvez cependant retrouver aussi ici. Vous y retrouvez pour chaque projet l’ensemble des documentations générées, ainsi que les liens vers les feuilles XSL utilisées 🙂 .
N’hésitez pas à consulter notre documentation et à la réutiliser (en nous citant, bien sûr !)
À ELAN, nous tâchons d’avoir un fichier ODD pour chaque projet qui utilise de la TEI. Celui-ci est spécifique aux besoins du projet, a pour but de guider les personnes qui encodent en réduisant notamment le nombre d’éléments et d’attributs disponibles, mais aussi en complétant ou récrivant leur descriptions. L’objectif ? Favoriser la cohérence des fichiers encodés. À partir de ce fichier ODD, nous pouvons générer plusieurs types de documents, utiles à différents membres des projets.
Une première XSL pour préparer un ODD. Le plus souvent, les fichiers ODD sont générés automatiquement à partir de premier fichiers TEI, grâce à une feuille XSL (celle-là). Ensuite, nous complétons et structurons l’ODD.
De l’ODD vers différentes documentations. À partir de cet ODD, nous avons une série de feuilles XSL qui permettent de générer des documentations. Cette façon de procéder est très souple : si l’encodage évolue au cours du temps, il est possible de regénérer rapidement toute la documentation.
Deux XSL faits maison. Nous avons créé deux XSL(merci AnneGF !) qui permettent de générer des documentations personnalisées, pratiques à utiliser pour les chercheur.euses, stagiaires, étudiant.es … qui seront amenés à créer des fichiers TEI. Il s’agit d’un manuel “maison”, qui peut être plus ou moins développé en fonction des besoins, contenir des exemples et des définitions de balises propres au projet et être structuré, et d’unun tableau récapitulatif de l’ensemble des balises utilisées.
Deux XSL fournis par la TEI. La TEI propose moult XSL dont une pour faire un fichier RNG, utilisé pour valider le fichier TEI, et une pour générer une documentation spécifique au projet, lisible par l’humain et qui correspond à la présentation de la documentation sur le site officiel de la TEI.
Et voilà, amusez-vous bien 😎
OpenEdition vous propose de citer ce billet de la manière suivante :
Fanny Mézard (28 février 2025). DOE : Dépôt des ODD d’ELAN. ELAN - L'élan littératures, arts et numériques de Litt&Arts (UMR 5316). Consulté le 19 avril 2026 à l’adresse https://doi.org/10.58079/13ey7