Structure d'un document TEI : teiHeader, text et balisage de base

Humanités numériques · Bachelor 2

Anatomie d'un fichier TEI P5 : en-tête, front/body/back, balises de structure, ODD et schémas.

Introduction

Un document TEI est un fichier XML dans l'espace de noms http://www.tei-c.org/ns/1.0, dont l'élément racine est TEI. Il comporte obligatoirement deux parties : le teiHeader, qui décrit le document et son encodage, et l'élément text, qui contient le texte lui-même. Les Guidelines actuelles (P5, depuis 2007) sont maintenues par le TEI Consortium.

Le teiHeader doit contenir au minimum un fileDesc avec titleStmt (titre et responsables), publicationStmt (diffusion) et sourceDesc (source). Il peut compléter par encodingDesc (choix éditoriaux), profileDesc (langues, contexte) et revisionDesc (historique). Le text est organisé en front (pièces liminaires), body (corps) et back (annexes), avec des divisions div, des titres head, des paragraphes p, des vers l groupés en lg, des répliques sp avec speaker.

La TEI n'est pas un schéma unique : elle se personnalise par ODD (One Document Does it all), qui génère un schéma de validation (RelaxNG ou Schematron) et la documentation, de sorte qu'un projet choisisse les éléments pertinents pour ses textes.

Objectifs d'apprentissage

Décrire l'architecture minimale d'un document TEI valide
Choisir entre balises de structure, de pagination et de contenu
Expliquer le rôle de l'ODD et de la validation par schéma
Encoder un court extrait de prose, de poésie et de théâtre

Concepts clés

Deux blocs obligatoires: teiHeader (métadonnées du fichier et de l'édition) et text (contenu) sont les deux enfants attendus de l'élément TEI.
Le teiHeader: fileDesc est obligatoire avec titleStmt, publicationStmt et sourceDesc ; encodingDesc, profileDesc et revisionDesc sont facultatifs mais recommandés.
Structure textuelle et structure matérielle: div, p, lg/l et sp décrivent la structure logique ; pb, lb et cb marquent saut de page, de ligne et de colonne du support.
Personnalisation par ODD: Un fichier ODD spécifie les modules et éléments utilisés et génère schéma et documentation, ce qui garantit des encodages cohérents.

Conclusion

Un bon document TEI commence par un en-tête rigoureux et une structure cohérente. Distinguer structure logique et structure matérielle évite les chevauchements et facilite le traitement ultérieur.

Maîtriser l'ODD et la validation transforme la TEI en cadre de travail collectif, adapté aux besoins d'un projet d'édition.

Cartes

Quel est l'espace de noms d'un document TEI ?: http://www.tei-c.org/ns/1.0.
Quels sont les deux éléments principaux sous TEI ?: teiHeader et text.
Quels sont les trois enfants obligatoires de fileDesc ?: titleStmt, publicationStmt et sourceDesc.
Que contient sourceDesc ?: La description de la source dont le texte numérique est issu (manuscrit, édition imprimée, document né-numérique).
Comment encoder un saut de page et un saut de ligne ?: Avec les éléments vides pb et lb, par exemple <pb n="12"/> et <lb/>.
Comment encoder des vers ?: Chaque vers dans un élément l, regroupés en strophes avec lg.
Comment encoder une réplique de théâtre ?: Avec sp, qui contient speaker pour le nom du personnage et p ou l pour le texte dit.
Que signifie ODD ?: One Document Does it all : un format source unique qui génère à la fois le schéma de validation et la documentation d'un encodage.
Quelle différence entre front, body et back ?: front : pièces liminaires (page de titre, préface) ; body : corps de l'œuvre ; back : annexes, index, notes finales.

Glossaire

TEI: Text Encoding Initiative : standard d'encodage de textes en XML pour les sciences humaines.
teiHeader: Élément qui contient les métadonnées du document TEI.
Élément vide: Élément XML sans contenu, comme pb ou lb, marquant un point dans le texte.
ODD: Format de spécification qui produit un schéma TEI personnalisé et sa documentation.
RelaxNG: Langage de schéma XML utilisé pour valider la structure d'un document.
Validation: Vérification qu'un document respecte les règles d'un schéma.