# Atelier de TEI
### École hivernale en ligne des sciences humaines et sociales 2024
##### Yanet Hernandez
Doctorante en Littérature option Humanités Numériques (Université de Montréal)
---
## Sommaire
- Définition de la TEI
- Brève introduction aux langages de balisage
- L'XML-TEI
- Les schémas personnalisés
- Ressources
---
## La TEI
<div style="font-size:2.5rem">
> La TEI (Text Encoding Initiative) est un consortium qui développe et maintient collectivement une norme pour la représentation de textes sous forme numérique. Son principal objectif est un ensemble de lignes directrices qui précisent les méthodes de codage des textes lisibles par machine, principalement dans les domaines des sciences humaines, des sciences sociales et de la linguistique.
</div>
<div style="font-size:1rem">
Définition de TEI sur la page d'accueil du site de la <a href="https://tei-c.org">Text Encoding Initiative (TEI)</a>
</div>
---
### La TEI fournit un standard pour le balisage de corpus littéraires et scientifiques en XML (langage de balisage extensible)
---
## D'autres langages de type XML
---
HTML (HyperText Markup Language: pour le sites web)
---
KML (Keyhole Markup Language: Google Maps)
<div>
<pre><?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
<Placemark>
<name>New York City</name>
<description>New York City</description>
<Point>
<coordinates>-74.006393,40.714172,0</coordinates>
</Point>
</Placemark>
</Document>
</kml></pre></div>
---
RDF (Resource Description Framework: catalogues de bibliothèques)
<div>
<pre><rdf:Description rdf:about="http://www.w3.org/TR/rdf-syntax-grammar">
<ex:editor>
<rdf:Description>
<ex:homePage rdf:resource="http://purl.org/net/dajobe/"/>
<ex:fullName>Dave Beckett</ex:fullName>
</rdf:Description>
</ex:editor>
<dc:title>RDF 1.1 XML Syntax</dc:title>
</rdf:Description></pre>
</div>
---
SVG (Scalable Vector Graphics: des images numériques)
<div style="display:flex;flex-wrap:wrap">
<div style="width:60%; margin-right: 2rem">
<pre><?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
<svg width="391" height="391" viewBox="-70.5 -70.5 391 391" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
<rect fill="#fff" stroke="#000" x="-70" y="-70" width="390" height="390"/>
<g opacity="0.8">
<rect x="25" y="25" width="200" height="200" fill="lime" stroke-width="4" stroke="pink" />
<circle cx="125" cy="125" r="75" fill="orange" />
<polyline points="50,150 50,200 200,200 200,100" stroke="red" stroke-width="4" fill="none" />
<line x1="50" y1="50" x2="200" y2="200" stroke="blue" stroke-width="4" />
</g>
</svg>
</pre></div>
<img src="https://s3.hedgedoc.org/demo/uploads/448df74e-0d3a-4cf5-bd55-0ba71b129fe4.png" width="100" height="100">
</div>
---
OOXML (Open Office XML: pour le documents word, par exemple)
<div style="display:flex;flex-wrap:wrap">
<div style="margin-right:1rem;width:45%">
<img src="https://s3.hedgedoc.org/demo/uploads/2c165759-ee35-4dda-aa00-ecc3dfdb4379.png">
</div>
<div style="margin-right:1rem;width:45%">
<img src="https://s3.hedgedoc.org/demo/uploads/f3efc47b-f63e-472b-b279-0d5828d7b97d.png"/></div>
</div>
---
L'XML fonctionne un tant que base de données textuelles et la TEI fournie le standard pour cette base de données.
---
## L'XML-TEI
- permet d'organiser la information dans le texte (forme)
---
## L'XML-TEI
- permet d'ajouter des couches d'information : des interprétations, des analyses, des annotations (contenu)
---
## L'XML-TEI
- permet l'échange, l'interopérabilité et la réutilisabilité des données textuelles
---
## Liste de projets qui utilisent l'XML-TEI
- [Les manuscrits de Madame Bovary](https://www.bovary.fr/)
- [Pulter Project](https://pulterproject.northwestern.edu)
- [Walter Benjamin en édition numérique](https://www.walter-benjamin.online/)
- [CatCor](https://catcor.seh.ox.ac.uk)
---
## Comment utiliser exactement la TEI et à quoi cela ressemble ?
---
### Exemple simple de fichier XML-TEI
##### L'en-tête
<div>
<pre>
<?xml version="1.0" encoding="UTF-8"?>
<TEI xmlns="http://www.tei-c.org/ns/1.0">
<teiHeader>
<fileDesc>
<titleStmt>
<title>Exemple simple</title>
</titleStmt>
<publicationStmt>
<p>Publié comme example par SHS.</p>
</publicationStmt>
<sourceDesc>
<p>Pas de sources : produit nativement numérique.</p>
</sourceDesc>
</fileDesc>
</teiHeader>
</TEI>
</pre>
</div>
---
##### Le corps du texte
<div style="display:flex;flex-wrap:wrap">
<div style="margin-right:1rem;width:45%">
<pre><?xml version="1.0" encoding="UTF-8"?>
<TEI xmlns="http://www.tei-c.org/ns/1.0">
<teiHeader></teiHeader>
<text>
<body>
<head>Exemple</head><div><p ana="#req">Si on éclairera les salles des gardes <lb/>
de <hi rend="bigger">Votre Majesté</hi>, des gardes de <lb/>
la Porte<ref type="note" target="#n-007"/> et des Cent Suisses.</p>
</div>
</body>
</text>
</TEI>
</pre></div>
<div style="margin-right:1rem;width:45%">
<img src="https://s3.hedgedoc.org/demo/uploads/53e99532-31d0-45d6-b816-1d22bcdd0e00.png"/></div>
</div>
---
[TEI By Example](https://teibyexample.org/)
---
## Éditeurs pour l'XML
- Le logiciel [Oxygen](https://www.oxygenxml.com)
- VSCODE + SCHOLARLY XML EXTENSION
- [Leaf-Writer](https://leaf-writer.leaf-vre.org/)
---
## C'est quoi un schéma ?
Le schéma en XML va être la référence que la machine va utiliser pour valider le document en s'assurant que celui-ci a la structure correcte.
---
## Les schémas personnalisés
- La plateforme [Roma](https://roma.tei-c.org/) pour la personnalisation de schémas
- Pour utiliser les schémas personnalisés par le Consortium de la TEI (https://tei-c.org/guidelines/customization/)
---
## Pourquoi utiliser l'XML-TEI pour encoder mon corpus ?
- Exploitation orientée données : utilisation du texte en tant que données réutilisables et exploitables de différentes manières
[ce qui n'est pas encodé ne pourra être facilement exploité]
---
## Plus de ressources
### XSLT
- [TEI GARAGE](https://teigarage.tei-c.org/) - Convertisseur de fichiers, y compris du format ODD à RELAX NG schema pour les schémas personnalisés.
- [Générateur de XSLT](https://www.xsltgenerator.com/signin)
- [Application de la transformation en utilisant le navigateur](https://developer.mozilla.org/en-US/docs/Web/API/XSLTProcessor/Basic_Example)
- [CETEICEAN 🐳](https://github.com/TEIC/CETEIcean)
---
## En savoir plus
[The TEI Guidelines](https://tei-c.org/release/doc/tei-p5-doc/fr/html/index.html)
[La TEI simplifiée : une introduction au codage des textes électroniques en vue de leur échange](https://tei-c.org/Vault/P4/Lite/teiu5_fr.html)
[TEI By Example](https://teibyexample.org/)
[TEI GitHub](https://github.com/TEIC/TEI)
[TEI listServ](https://listserv.brown.edu/cgi-bin/wa?A0=TEI-L)
---
# Merci !
---