# Annoter et baliser

Emmanuelle Morlock

► To cite this version:

Emmanuelle Morlock. Annoter et baliser. École thématique. Ecole d'été du Consortium DISTAM 2024, L'arbresle, Couvent de la Tourette, France. 2024. hal-04774934

HAL Id: hal-04774934

https://hal.science/hal-04774934v1

Submitted on 9 Nov 2024

HAL is a multi-disciplinary open access
archive for the deposit and dissemination of sci-
entific research documents, whether they are pub-
lished or not. The documents may come from
teaching and research institutions in France or
abroad, or from public or private research centers.

L'archive ouverte pluridisciplinaire HAL, est
destinée au dépôt et à la diffusion de documents
scientifiques de niveau recherche, publiés ou non,
émanant des établissements d'enseignement et de
recherche français ou étrangers, des laboratoires
publics ou privés.

<figure><img src="image_1.png" /></figure>

Distributed under a Creative Commons Attribution 4.0 International License
# Annoter et baliser

Emmanuelle Morlock
IR CNRS – HiSoMA, Biblissima+

École d'été du consortium DISTAM - 9 juillet 2024 - Couvent de la Tourette
Annoter
# Scholarly Primitives (J. Unsworth)

Les opérations fondamentales du travail savant :

* Découvrir

* Annoter

* Comparer

* Faire référence

* Prendre un échantillon

* Illustrer

* Représenter

Unsworth 2000 Unsworth, J. Scholarly Primitives: What Methods Do Humanities Researchers Have in Common, and How Might Our Tools Reflect This?, in Symposium on Humanities Computing: Formal Methods, Experimental Practice. King's College, London (2000).

https://johnunsworth.name/Kings.5-00/primitives.html.
# Les multiples facettes de l'annotation (concept théorique et appliqué)

<figure><img src="image_2.png" /></figure>

**Nantke and Schlupkothen 2020** Nantke, J. and F. Schlupkothen. Annotations in Scholarly Editions and Research: Functions, Differentiation, Systematization. De Gruyter, Berlin/New York (2020).

https://doi.org/10.1515/9783110689112
# Multiplicité des notions & questions posées par l'annotation

* Notes marginales manuscrites

* Notes de bas de page

* Surlignements / soulignements / coups de stabilo

* Commentaires vs notes explicatives

* Révisions

* Références à d'autres documents

* Catégories analytiques

* Indexation

* Distinction de niveaux narratifs dans les textes littéraires

* Multimodale (image, son, video)

* Comment les interpréter ? avec quels savoirs (auteur, contexte)

* Manuel / assisté par ordinateur : l'outil influence-t-il la pensée ?

* Privée ou publique (hypothes.is)

* Cercle hérméneutique
Formule

A ajoute l'information B

à l'objet C

selon la modalité D

avec la finalité E.
# L'annotation numérique

Lorsqu'ils interviennent en superposition d'un support préexistant, les actes d'annotation (écrire-tracer-dessiner) constituent le **"marquage" instrumenté d'un texte** et éventuellement de ses illustrations :

* Souligner

* Surligner

* Entourer

* Barrer

* Cocher

* Ecrire autour/à côté/en marge

* Schématiser une idée, un propos

https://educavox.fr/formation/analyse/annoter-avec-le-numerique (voir notamment la bibliographie)
# Le balisage : pas nécessairement numérique

Mot à centrer

## SALAGON

Lignes à centrer

Conservatoire du patrimoine ethnologique
de Haute-Provence

Lettre à changer

Mettre en petite capitales

Lertte à ajouter

Lettre à supprimer

Mot à changer

Mot à ajouter

Mot à supprimer

Le prieuré bénédictin de Salagon conserve du XIIe siècle son église à deux vaisseaux. Un logis ordonnancé de fenêtres à meneaux lui a été écolé au XVe siècle.

Deux couleurs caladées, des dépendances à usage fermier (XVIe- XIXe siècle), aujourd'hui aménagées en d'exposition, complètent cet ensemble classé classé monument historique.
Baliser comme forme particulière d'annotation
# Pourquoi a-t-on besoin d'un balisage spécial dans le numérique ?

## Objectif :

Disposer d'un langage suffisamment expressif et précis pour nous permettre d'exprimer les données fondamentales d'un texte, de manière à ce que l'essentiel du sens véhiculé par ce texte puisse être transféré d'une application informatique à une autre...
# Pourquoi nous avons besoin du balisage

* Fin des années 60 : idée de séparer le contenu (le texte) de la mise en forme

* Idée de développer de systèmes génériques pour favoriser l'échange des corpus / jeux de données

* 1986 : SGML devient norme ISO

* 1998 : XML recommandation du W3C

* 2007 : TEI P5 (abandon de SGML pour XML)

```xml
<!DOCTYPE document SYSTEM
  "document.dtd">
  <DOCUMENT>
    <head>
      <title>Le titre</title>
    </head>
    ...
  </DOCUMENT>
```
Structure d'un balise XML - 1

<figure><img src="image_3.png" /><figcaption>Contenu</figcaption></figure>

<figure><img src="image_4.png" /><figcaption>balise fermante</figcaption></figure>

<figure><img src="image_5.png" /></figure>

<balise>chaîne de caractères</balise>
Structure d'un balise XML - 2

<figure><img src="image_6.png" /></figure>

<figure><img src="image_7.png" /></figure>

valeur d'attribut
# Les langages de balisage

* il en existe un très grand nombre

* A ne pas confondre avec les langages de programmation : les langages de balisage se contentent de décrire (ne donnent pas d'instructions)

* Ils explicitent des contenus par le biais :

* d'éléments

* d'attributs

* de texte

```xml
<book>
  <title type ="last">Phèdre</title>
  <title type ="first">Phèdre et Hyppolyte</title>
  <author>Racine</author>
</book>
```
Le jour n'est pas plus pur que le fond de mon coeur.
<figure><img src="image_8.png" /></figure>

L'ÉCOLE
DES FEMMES

ACTE PREMIER

SCÈNE PREMIÈRE
CHRYSALDE, ARNOLPHE.

CHRYSALDE.

Sous venez, dites-vous, pour lui donner la main?

V

ARNOLPHE.

Oui, je veux terminer la chose dans demain.

CHRYSALDE.

Pous sommes ici seuls, et l'on peut, ce me semble,
sans craindre d'être ouïs, y discourir ensemble.
Voulez-vous qu'en ami je vous ouvre mon cœur?
Votre dessein pour vous me fait trembler de peur,

2

Source gallica.bnf.fr / Bibliothèque nationale de France

<text>

<body>

<head>L'École des femmes <lb/><hi rend="i">Comédie</hi></head>

<div1 type="act" xml:id="I1">

<head>Acte Premier</head>

<div2 type="scene" xml:id="I01">

<head>Scène Première</head>

<sp who="chrysalde" xml:id="I01-1">

<i>Vous venez, dites-vous, pour lui donner la main ?</i>

</sp>

<sp who="arnolphe" xml:id="I01-2">

<l>Oui, je veux terminer la chose dans demain.</l>

</sp>

<sp who="chrysalde" xml:id="I01-3">

<l>Nous sommes ici seuls, et l'on peut, ce me semble,</l>

<l>Sans craindre d'être ouïs, y discourir ensemble.</l>

<l>n="5">Voulez-vous qu'en Ami je vous ouvre mon cœur ?</l>

<l>Votre dessein, pour vous, me fait trembler de peur :</l>
## et aussi pour les humains...

* <lb ed="T"/>何必能稱美談。」

* <persName key="A001583">什</persName>每有疑義, 必共諮決。時偽 <lb ed="T"/>秦主 <persName key="A002097">姚興</persName>專志經法, 供養三千餘僧, <placeName key="PL000000042002">關中</placeName>舊僧 (...)
Comparez

* J'ai bien aimé Mamma Mia

* Elle a alors crié Mamma Mia !

* J'ai bien aimé [ titre ] Mamma Mia[ fin de titre ]

• Elle a alors crié [autre langue]Mamma Mia ![fin autre langue]

* Elle a alors crié [ autre langue : italien ] Mamma Mia ! [ fin autre langue ]
# Types de langages de balisages (Markup Languages)

Langage de balisage : système d'encodage de la structure, présentation ou sémantique des éléments composant un texte et de leurs relations.

<table><tr><td>Procédural</td><td>RED INK ON; PRINT "-1000 €"; RED INK OFF</td></tr><tr><td>Présentationnel</td><td>\textcolor{red}{-1000€}</td></tr><tr><td>Descriptif</td><td>Vous êtes en découvert de :<br/><measure unit="euro" value="-1000">1000 euros</measure></td></tr></table>
# Rôle du balisage

Le balisage explicite aux machines ce qui est implicite pour les humains

* **Structures logiques et physiques des documents**

* Livre > chapitre > paragraphe

* Pièce de théâtre > acte > scène

* **Eléments indexables (entités nommées)**

* noms, lieux, dates, etc.

* **Catégories d'analyse**

* linguistiques

* narratologiques,

* interprétations spécifiques à une perspective de recherche
# Balisage sémantique et non présentationnel

## Le balisage présentationnel enregistre des apparences

* `<i>mens sana in corpore sano</i>`

* `<i>Le roman de la Momie</i>`

* C'est `<i>juste</i>` une impression...

## Le balisage sémantique capture le sens (ou la fonction)

* `<foreign>mens sana in corpore sano</foreign>`

* `<title>Le roman de la momie</title>`

* C'est `<emph>juste</emph>` une impression...
# Un texte est une abstraction

* un document est un objet réel, qui a une existence dans le mode physique

* un texte est une abstraction, construite en référence à une communauté (ou une pratique sociale attestée)

* le texte =

le texte

+ le point de vue sur le texte

+ la perception de ce point de vue par un individu
<figure><img src="image_9.png" /></figure>

Text as **Idea, Intention**

TEXT I

TEXT S

TEXT W

TEXT D

TEXT L

TEXT V

Text as (visual) **Sign**

Text as **Document**

Text as **Version**

Text as (structured)
**Work**

Text as **Linguistic code**
Le balisage de texte, c'est donc :

* une étape essentielle pour créer une édition savante numérique

* la formalisation d'une interprétation (le texte + un point de vue sur le texte)

* produire une représentation lisible par les humains et par les machines

* expliciter les traits caractéristiques du document de manière à les rendre exploitables par des logiciels informatiques

* produire une source à partir de laquelle on peut générer autant de versions que l'on veut

* dans un formatage adapté à différents appareils de lecture

* dans des versions plus ou moins exhaustives ou transformées en fonction d'objectifs éditoriaux (version reproduisant l'orthographe du scripteur vs version normalisée)

* faciliter/permettre l'échange et la préservation des données (l'explicitation des implicites étant une condition de l'intelligibilité future de la représentation)
# Les fonctions du balisage

* Fonction structurelle

* explicite la structure

* délimite les composants du document

* Fonction descriptive

* donnent des informations

* facilitent la recherche d'information

* Fonction présentationnelle

* mettent en forme l'information dans un format visuel

* ont pour but de favoriser la lisibilité

* Fonction relationnelle

* liens hypertexte

* lancement d'applications
exemple

Paris, le 13 septembre 2010

Cher Jean,

Je vous remercie de la fabuleuse soirée que j'ai passé en votre compagnie à la Comédie française. Les acteurs se sont surpassés et j'ai particulièrement apprécié cette mise en scène de Phèdre. Ce fut d'iciencieuse.

Henri
# Balisage structurel

<ENTETE>Paris, le 13 septembre 2010</ENTETE>

<SALUTATIONS>Chère Jeanne,<SALUTATIONS>

<CORPS>

Je vous remercie pour la fabuleuse soirée que j'ai passée en votre compagnie à la Comédie Française. Les acteurs se sont surpassés et j'ai particulièrement apprécié cette mise en scène de Phèdre.

Ce fut délicieux.

</CORPS>

<SIGNATURE>Henri</SIGNATURE>
# Balisage présentationnel

<ALIGN-RIGHT>Paris, le 13 septembre 2010</ALIGN-RIGHT>

<BOLD>Chère Jeanne,<BOLD>

Je vous remercie pour la fabuleuse soirée que j'ai passée en votre compagnie à la Comédie Française. Les acteurs se sont surpassés et j'ai particulièrement apprécié cette mise en scène de <UNDERLINE>Phèdre</UNDERLINE>.

Ce fut <BLINK>délicieux.</BLINK>

<IMG SRC="henri.jpg" align="left"/>

<FONT-FACE="Times">Henri</FONT-FACE>
# Balisage descriptif

<PLACE>Paris</PLACE>, le <DATE>13 septembre 2010</DATE>

Chère <PERSON>Jeanne,<PERSON>

Je vous remercie pour la fabuleuse soirée que j'ai passée en votre compagnie à la <PLACE>Comédie Française</PLACE>. Les acteurs se sont surpassés et j'ai particulièrement apprécié cette mise en scène de <PLAY>Phèdre</PLAY>.

Ce fut <EMOTION>délicieux</EMOTION>.

<PERSON>Henri</PERSON>
# Balisage relationnel

Paris, le <TODAY href="date" actuate="auto"/>

Chère Jeanne,
Je vous remercie pour la fabuleuse soirée que j'ai passée en votre compagnie à la Comédie Française. Les acteurs se sont surpassés et

j'ai particulièrement apprécié cette mise en scène de <A REF="http://data.bnf.fr/11940749/jean_racine_phedre/">Phèdre</A>.

Ce fut délicieux.

<IMG SRC="henri.jpg" align="left"/>

<A HREF="mailto:henri@henri.net">Henri</A>
# Balisage procédural

\section{Formats produits par \LaTeX}

\label{memoformats}

Les principaux sont les suivants:

\begin{itemize}

\item pdf \item html (avec tth ou tex4ht ou d'autres) \item ps (vieux) \item rtf

\end{itemize}
## Fonctions du balisage comme “annotation structurée”

* délimiter (rendre “adressable”)

* expliciter (qualifier)

* représenter (une structure ou un phénomène, implicite ou explicite)

* ajouter de l'information (notes critiques par ex.)
# Atouts du balisage descriptif

* Le “contenu” prime sur la mise en forme

* Cette distinction permet la ré-utilisation

* Elle est à la base de la flexibilité de l'édition numérique

<figure><img src="image_10.png" /></figure>
## Comparer

Mon amie <persName>Adélaïde</persName>

Je vis à <placeName>Adélaïde</placeName> en Australie
Que va-t-on baliser ?

* Première étape : analyse du document

* Choix des éléments que l'on souhaite représenter

* aspects visuels (mise en page, forme des lettres, décorations...)

* dimension linguistique et structurelle

* information sur le monde réel (lieux, personnes, événements historiques...)

* Qu'est-ce qui est le plus important ?

* à vous de décider ! (a priori, selon la question de recherche)
# XML en 5 points

1. XML décrit les données mais ne les affiche pas

2. Les balises ne sont pas prédéfinies

3. Le balisage décrit la structure et le contenu

4. On doit utiliser des “grammaires” (schémas, DTD) pour contrôler le balisage

5. XML permet des traitements automatisés tout en restant lisible par des humains
Une hiérarchie ordonnée d'éléments de contenus

<figure><img src="image_11.png" /></figure>
<recette>

<Titre>Lait de poule</titre>

<ingredients>

<ingredient><qté>1</qté><nom>oeuf</nom></ingredient>

<ingredient><qté>10 cl</qté><nom>de lait chaud</nom></ingredient>

<ingredient><nom>sucre en poudre</nom></ingredient>

</ingredients>

<preparation>

<explications>Verser le tout dans un verre à anse. Sucrer selon son goût. Remuer et ajouter un peu de noix de muscade râpée.</>

</explications>

<durée/>

</preparation>

</recette>
<figure><img src="image_12.png" /></figure>

recette

titre

ingrédients

ingrédient

qté

nom

ingrédient

qté

nom

ingrédient

qté

nom

préparation

explications

durée
<figure><img src="image_13.png" /></figure>
lait de poule] [ [ [ 1 ] oeuf ] ]

[ 10 cl ] [ de lait chaud ] ] [ Verser le tout dans un verre à anse. Sucrer selon son goût. Remuer et ajouter un peu de noix de muscade râpée. ] ]
<figure><img src="image_14.png" /></figure>

## recette

titre

ingrédients

ingrédient

qté

nom

ingrédient

qté

nom

ingrédient

qté

nom

préparation

explications

durée
# Conventions habituelles de l'épigraphe grecque et latine

<table><tr><td>...</td><td>Illegible letters, not restored by editor</td></tr><tr><td>ąbc</td><td>Letters ambiguous outside of their context</td></tr><tr><td>[...]</td><td>Letters missing, not restored by editor</td></tr><tr><td>[abc]</td><td>Letters missing, restored by editor</td></tr><tr><td>⟨...⟩</td><td>Letters erroneously omitted, not restored</td></tr><tr><td>⟨abc⟩</td><td>Letters erroneously omitted, not restored</td></tr><tr><td>a(bc)</td><td>Abbreviation expanded by editor</td></tr><tr><td>{abc}</td><td>Letters considered superfluous</td></tr><tr><td>[[abc]]</td><td>Deletion which can be restored</td></tr></table>
... et leur équivalent en TEI / EpiDoc

<table><tr><td>...</td><td>&lt;gap reason="illegible" extent="unknown"/&gt;</td></tr><tr><td>abc</td><td>&lt;unclear&gt;abc&lt;/unclear&gt;</td></tr><tr><td>[...]</td><td>&lt;supplied reason="lost"&gt;abc&lt;/supplied&gt;</td></tr><tr><td>[abc]</td><td>&lt;supplied reason="lost"&gt;abc&lt;/supplied&gt;</td></tr><tr><td>&lt;...&gt;</td><td>&lt;gap reason="omitted" extent="unknown"/&gt;</td></tr><tr><td>&lt;abc&gt;</td><td>&lt;supplied reason="omitted"&gt;abc&lt;/supplied&gt;</td></tr><tr><td>a(bc)</td><td>&lt;expan&gt;&lt;abbr&gt;a&lt;/abbr&gt;&lt;ex&gt;bc&lt;/ex&gt;&lt;/expan&gt;</td></tr><tr><td>{abc}</td><td>&lt;surplus&gt;abc&lt;/surplus&gt;</td></tr><tr><td>[[abc]]</td><td>&lt;del&gt;abc&lt;/abc&gt;</td></tr></table>
# Comment ?

## Balisage “manuel”

* Editeur de texte basique (notepad, textedit)

* Editeur de texte outillé (oXygen, XMLMind, VScode...)

* Interfaces “auteur” (balisage par clic sur des boutons)

## Balisage dans des chaînes de traitement

* Conversions (`.docx stylé => TEI`)

* Reconnaissance optique de caractères (HTR -> alto -> TEI)

* Autres outils (OpenRefine)
```xml
<?xml version="1.0" encoding="UTF-8"?>
<?xml-model href="http://www.stoa.org/epidoc/schema/latest/tei-epidoc.rng"
type="application/xml" schematypens="http://relaxng.org/ns/structure/1.0"?>
<?xml-model href="http://www.stoa.org/epidoc/schema/latest/tei-epidoc.rng"
type="application/xml" schematypens="http://purl.oclc.org/dsdi/schematron"?>
<TEI xmlns="http://www.tei-c.org/ns/1.0" xml:id="CK166" xml:lang="en">
<teiHeader>
<fileDesc>
<titleStmt>
<title>Statue assise de Ns-p3-mdw, fils de Ns-p3-q3-śwty et de Tz-h3'-n-B3stt, en scribe. Caire CG 48613</title>
</title>
</teiHeader>
</fileDesc>
</teiHeader>
</xml-model>
```

Schema & documentation*

<figure><img src="image_15.png" /></figure>

apparatus

bibliography

commentary

edition

textpart

translation
<figure><img src="image_16.png" /></figure>

Description

Oeuvre

Image

Edit

Models

[Manuscrits autographes de Lingueille (lieues ou les mers) / Jules Verna
Derniers - 1900.jpg - 2190.0200 - 231.96]

manuel

<figure><img src="image_17.png" /></figure>

<figure><img src="image_18.png" /></figure>

<figure><img src="image_19.png" /></figure>

<figure><img src="image_20.png" /></figure>

<figure><img src="image_21.png" /></figure>

<figure><img src="image_22.png" /></figure>

plus grand a coup sur que la rencontre d'un
tigre en pleine foret.

une Daujehane après qu'elle par la
branche électrique nous atterrita au Nautilus
au porte extérieure car il s'était endormi, et le Nautilus
renait la referma. D'ici que nous fûmes rentrés dans
la première cellule : puis, il pressa un bouton.
J'entendis néanmoins les pas qui se tournèrent
autour de moi, et en quelques secondes
la cellule fut éclairée violets. la porte extérieure
s'ouvrira alors, et nous parlaient. Pour le verrouiller,
à mon côté, je regardai scapandère new fûmes
rentrés, nous sans peine, et, banale, je regardai
maAMBRE, mais tout en émerveillant de cette excursion
au fond des mers.

Chapitre 18.

Quatre mille lieues sous le
Pacifique.

plus grand a coup sur que la rencontre d'un
tigre en pleine foret.
une Daujehane après qu'elle par la
branche électrique nous atterrita au Nautilus
au porte extérieure car il s'était endormi, et le Nautilus
renait la referma. D'ici que nous fûmes rentrés dans
la première cellule : puis, il pressa un bouton.
J'entendis néanmoins les pas qui se tournèrent
autour de moi, et en quelques secondes
la cellule fut éclairée violets. la porte extérieure
s'ouvrira alors, et nous parlaient. Pour le verrouiller,
à mon côté, je regardai scapandère new fûmes
rentrés, nous sans peine, et, banale, je regardai
maAMBRE, mais tout en émerveillant de cette excursion
au fond des mers.

Chapitre 18.

Quatre mille lieues sous le
Pacifique.

plus grand a coup sur que la rencontre d'un
tigre en pleine foret.

une demi heure après, guidés par la
trainée électrique, nous atteignions le Nautilus.
La porte extérieure était restée ouverte, et le capitaine
Nemo la referma, des que nous fûmes rentrés dans
la première cellule ; puis, il pressa un bouton.
J'entendis manoeuvrer les pompes ; je sentis l'eau
baisser autour de moi, et en quelques instants,
la cellule fut entièrement vidée. La porte interieure
s'ouvrit alors, et nous passâmes dans le vestiaire,

Là, nos habits de scaphandre nous furent
retirés, non sans peine, et, harassé, >je< je regagnai
ma chambre, encore tout emerveillé de cette excursion
au fond des mers.

Chapitre 18.

Quatre mille lieues sous le
Pacifique.
Transformer le balisage pour la version de lecture

<figure><img src="image_23.png" /></figure>
# Edition multisupports

<figure><img src="image_24.png" /></figure>

<figure><img src="image_25.png" /></figure>
# Les couches technologiques d'une édition en lignes

<figure><img src="image_26.png" /></figure>

Présentation

pages web (html/CSS /javascript

Traitements

programmes, scripts (XSLT, XQuery, etc.

Données

XML / TEI
```xml
<xml>
  <TEI>
    (...)
    <div>
      <head>Atelier pratique</head>
      <p>L'encodage XML/TEI, c'est facile !</p>
    </div>
    (...)
  </TEI>
```

XML

Couche données

Transformation
(XSLT, Xquery)

XSLT

Couche "traitements"

HTML

Couche présentation

```html
<html>
  (...)
  <h1>Atelier pratique</h1>
  <p>L'encodage XML/TEI, c'est facile !</p>
  (...)
</html>
```
HTML

h1 = Titre de niveau 1

+

body {
  font-family: Times;
}

font-size: 200%;

color: green;

font-weight: bold;

color: black;

font-size: 100%;

margin-top: 10%;

CSS

document: Police Times

title 1: taille 200%, vert

paragraphe: taille 100% noir

=

Atelier pratique

L'encodager XML/TEI, c'est facile !

Affichage dans le
navigateur web
Que peut-on représenter ?

structure du
document (titres,
paragraphes,
strophes)

Métadonnées
(auteur, date de
création,
provenance, genre)

<figure><img src="image_27.png" /></figure>

Structures
linguistiques (parties
du discours, phrases,
mots...)

Références à des
personnes ou objets
du monde réel, des
evénements

Caractéristiques du
document support
(dimensions, état du
support, couleur, type
de papier...

Disposition, mise en
page, analyse des
formes graphiques et
manuscrites

Processus : ratures,
campagnes de
correction

Annotations, notes de
régie...
Processus typique

<figure><img src="image_28.png" /></figure>
# 3 mécanismes clés du balisage XML/TEI
## Mécanisme clé : identifier / pointer

```html
<text>
  <body>
    <div n="1">
      <p n="1">[...]</p>
      Vade retro Satana, scandalum
      <anchor xml:id="app1b"/>es nobis <anchor
        xml:id="apple"/>
      </p>
      [...]
    </div>
  </body>
</text>

<app from="#app1b" to="#apple">
  <rdg wit="#B">est mihi</rdg>
</app>
```
## Mécanisme : parallélisation

```html
<text>
  <body>
    <div n="sermo1">
      <p n="1">[...]</p>
      Vade retro Satana, scandalum
      <app>
        <lem>es nobis</lem>
        <rdg wit="#B">est mihi</rdg>
      </app>
      [...]
    </div>
  </body>
</text>
```

```html
</p> </div>
</body>
</text>
```
Balisage “débarqué” (standoff markup)

* élément conteneur <standOff>

* pour :

* des données liées

* de l'information contextuelle

* des listes d'annotations...

* utilise le mécanisme “identification / pointeur”
```html
<text>
  <body>
    <!-- ... -->
    <p>
      <w xml:id="w51">I</w>
      <w xml:id="w52">wanna</w>
      <w xml:id="w53">put</w>
      <w xml:id="w54">up</w>
      <w xml:id="w55">new</w>
      <w xml:id="w56">wallpaper</w>
      <pc>.</pc>
    </p>
    <!-- ... -->
  </body>
</text>
```
```xml
<standOff type="morphosyntax">
  <spanGrp type="wordForm">
    <span target="#w51" ana="#fs01"/>
    <span target="#w52" ana="#fs02"/>
    <span target="#w52" ana="#fs03"/>
    <span target="#w53 #w54" ana="#fs04"/>
    <span target="#w55" ana="#fs05"/>
    <span target="#w56" ana="#fs06"/>
  </spanGrp>
  <fs xml:id="fs01">
    <f name="lemma">
      <string>I</string>
    </f>
    <f name="pos">
      <symbol value="PP"/>
    </f>
  </fs>
  <fs xml:id="fs02">
    <f name="lemma">
      <string>want</string>
    </f>
  </fs>
```
<text>
<body>
<div type="edition">
<div type="textpart" subtype="chapter"
n="1" xml:id="ch1">
<p n="1" xml:id="c1p1">
<seg n="1" xml:id="c1p1s1">Gallia est omnis divisa in partes tres, quarum unam incolunt Belgae, aliam Aquitani, tertiam qui ipsorum lingua Celtae, nostra Galli appellantur.</seg>
</seg n="6" xml:id="c1p1s6">Belgae ab extremis Galliae finibus oriuntur, pertinent ad inferiorem partem fluminis Rheni, spectant in septentrionem et orientem solem.</seg>
<seg n="7" xml:id="c1p1s7">Aquitania a Garumna flumine ad Pyrenaeos montes et eam partem Oceani quae est ad Hispaniam pertinet; spectat inter occasum solis et septentriones.</seg>
</p>
</div>
</div>
</div>
</body>
</text>
```xml
<standOff>
<listAnnotation>
<annotation xml:id="ann01"
  motivation="linking" target="#Gallia">
<respStmt xml:id="ed">
<resp>creator</resp>
<persName>Fred Editor</persName>
</respStmt>
<revisionDesc>
<change status="created"
  when="2020-05-21T13:59:00Z" who="#ed"/>
<change status="modified"
  when="2020-05-21T19:48:00Z" who="#ed"/>
</revisionDesc>
<licence target="http://creativecommons.org/licenses/by/3.0/"/>
 <!-- Gallia in seg 1 -->
<ptr target="#string-range(c1p1s1,0,6)"/>
 <!-- Galliae in seg 6 -->
<ptr target="#string-range(c1p1s6,19,7)"/>
</annotation>
 <!-- ... -->
</listAnnotation>
</standOff>
```
# Le balisage peut être (semi-)automatisé...

<table><caption>Tableur</caption><thead><tr><th>Inventory</th><th>W</th><th>D</th><th>M</th><th>W</th><th>Linguage(s)</th><th>Original locality</th><th>Present locality</th><th>Primary bibliography</th><th>Secondary sources</th><th>Visual documentation</th><th>Substance of interpretation</th><th>Remarks</th></tr></thead><tbody><tr><td>1.</td><td>31</td><td></td><td></td><td></td><td></td><td>Najayurathana Site 128 (1)</td><td>NM 79</td><td>Sarkar 1965-66.</td><td>Sarkar 1990: 84 (excerpt by editor); IAR 1961:42.77; ARIE 1962-63: 8.147; —Raghurath 2001: 67.11 (1)</td><td>Sarkar: Raghurath; — photos 2r 2017.</td><td>gift of a pila'r</td><td>ABE states: "Tab discovered in Site No. 125, near the Royal Burning Chat. No. 127".</td></tr><tr><td>2.</td><td></td><td></td><td></td><td></td><td></td><td>Settars, Pural, Gurukul District</td><td>unknown</td><td>Sankaranarajan 1967-68.</td><td>ABE 1976:57.63; 8.349; —Raghurath 2001: 69 (2)</td><td>Est. AJS; Sankaranarajan; Srinivasan &amp; Sridharan; —Sridharan; Enin, k. 60; Sankaranarajan; photos</td><td>erosion of a stone pila'r</td><td>Village called Rentahentas nowadays.</td></tr><tr><td>3.</td><td>22</td><td>unavailable</td><td>unavailable</td><td>50</td><td>MA</td><td>Kirakupad, Pural, Gurukul District</td><td></td><td>Sarkar 1965-66</td><td>Raghurath 2001: 70 (1); —Nehamitha Raa et al. 1998: 178 (no. 1)</td><td>erosion of a dustbin statue</td><td>erosion of written inscription, pila'r to the boundaries between the faces of the stone, CO. 01. C02, and inscription at Enin, Enin, Enin</td><td>the stone is only identified by the upper segment, measurements concern only the lower segment.</td></tr><tr><td>4.</td><td>47</td><td>38</td><td>44</td><td>51</td><td>MA</td><td>Najayurathana 1; West side of the Muhadlatazi</td><td></td><td>Vogel 1976-77 (C22); —1965</td><td>Raghurath 2001: 72 (41, 194, 83); —Vogel</td><td>erosion of welfare and happiness</td><td>gift for welfare and happiness</td><td>The examples shown by Raghurath under No. 5 and 6 together belong to our DA0005.</td></tr><tr><td>5.</td><td>46</td><td>30</td><td>88</td><td>56</td><td>MA</td><td>Najayurathana 1; West side of the Muhadlatazi</td><td>NM 301, 502</td><td>Vogel 1976-77 (C22); —1965</td><td>Raghurath 2001: 74 (51)</td><td>erosion of a pila'r</td><td>erosion of a stone pila'r</td><td>No reading for No. 190005 in Raghurath. See remarks under DA0005.</td></tr><tr><td>6.</td><td>48</td><td>29</td><td>105</td><td>55</td><td>MA</td><td>Najayurathana 1; West side of the Muhadlatazi</td><>NM 283, 259</td><td>Vogel 1929-30a (1); —1965</td><td>Raghurath 2001: 79 (41, 194, 83); —Vogel, Raghurath 2001: 74 (51)</td><td>erosion of welfare and happiness</td><td>erosion of a pila'r for welfare and happiness</td><td>No reading for No. 190005 in Raghurath. See remarks under DA0005.</td></tr><tr><td>7.</td><td>45</td><td>33</td><td>43</td><td>54</td><td>MA</td><td>Najayurathana 1; West side of the Muhadlatazi</td><>NM 285</td><td>Vogel 1929-30a (13, 18-19); —1965</td><td>Raghurath 2001: 80 (64)</td><td>erosion of a pila'r for welfare and happiness</td><td>erosion of a pila'r for welfare and happiness</td><td>Raghurath 2001: 197 (indicates Site No. 1 but is rather for Site 1)</td></tr><tr><td>8.</td><td>47</td><td>36</td><td>66</td><td>51</td><td>MA</td><td>Najayurathana 1; South side of the Muhadlatazi</td><>NM 285</td><td>Vogel 1929-30a (13, 18-19); —1965</td><td>Raghurath 2001: 80 (77)</td><td>erosion of a pila'r for welfare and happiness</td><td>erosion of a pila'r for welfare and happiness</td><td>Raghurath 2001: 197 (indicates Site No. 1 but is rather for Site 1)</td></tr><tr><td>9.</td><td>49</td><td>3</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr><tr><td>10.</td><td>49</td><td>3</td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td><td></td></tr></tbody></table>

<figure><img src="image_29.png" /><figcaption>fichier balisé
EpiDoc</figcaption></figure>

<figure><img src="image_30.png" /><figcaption>Interface de
lecture</figcaption></figure>

<figure><img src="image_31.png" /></figure>
Prototype de visualisation de données partir d'un corpus d'ostraca

Απολλωσ Πρισκοσ

παντὸς ὑγειαίνιν· ἐὶ

Χαιρήμωνι ἱμιμάτιν

ἀβολοί· κώμισε ποι

δέσμην κράμπος

πλίω γὰρ τὴν δέσμι

Μάξιμος τίρος και Δομίττις καὶ Ἀπολιναρίῳ·

ἀσπάστε ὁ Ἀπολιναοί τὸν μίλον σοῦ.

Apollôs à Priscus, son frère, salut et longue santé. J'ai reçu des mains de Chairèmôn un demi-mation de dattes et sept oboles. Reçois, via Capito le carrier, une botte de choux et un peu de rue. Il ne transporte pas plus que la botte. Salue Maximus la recrue, Domitius et Apollinaris. Apollinaris, ton ami, te salue. Porte-toi bien.

<figure><img src="image_32.png" /></figure>

<persName>Apollôs</persName> à

<persName>Priscus</persName>, son frère.

<seg ana="#paiement">J'ai reçu</seg>

des mains de <persName>Chairèmôn</persName>

un <measure type="currency" unit="mation"><num

value="0.5">demi</num>-mation</measure>

de <seg ana="#objet-denrée">dattes</seg> et

<measure type="currency" unit="obole>

<num value="7">sept</num> oboles

</measure>

<figure><img src="image_33.png" /></figure>

<figure><img src="image_34.png" /></figure>
# Balisage

Le balisage permet deux choses fondamentales :

* Délimiter des unités “discrètes” au sein du texte

* Expliciter de manière univoque l'ajout d'information

Le langage de balisage :

* Un vocabulaire de balises (`<p>`, `<div>`, `<note>`, `<opener>`, `<unclear>`...)

* Une “grammaire” qui spécifie les relations possibles

* enfants possibles

* attributs possibles

* et autres contraintes
# Démos
# Document word stylé

gras

italique

Document test

Ceci n'est pas une **pipe**.

Le consortium **DISTAM** (Digital Studies Africa, Asia, and the Middle East) organise son école d'été du 8 au 12 juillet au Couvent de la Tourette. Le couvent est situé à 2 kilomètres de la gare de l'Arbresle (Éveux), à l'ouest de Lyon. Une navette entre la gare de l'Arbresle et le Couvent est disponible.

style : tei:name

<figure><img src="image_35.png" /></figure>

style : tei:placeName
# Démos

* TEI Publisher :

* url : https://teipublisher.com/

* bac à sable : https://teipublisher.com/exist/apps/tei-publisher/index.html

* Import d'un document Word stylé

* Exploitation d'un encodage parallèle (édition critique) et visualisation des témoins via IIIF : *Sermones Demo*

* Passer de données tabulaires à un balisage TEI via l'interface graphique d'OpenRefine
```json
"width": 1327,
"height": 2143
},
"on": "https://digi.vatlib.it/iiif/MSS_Reg.lat.245/canvas/p0005"
}
],
"thumbnail": {
    "@id": "https://digi.vatlib.it/pub/digit/MSS_Reg.lat.245/thumb/Reg.lat.245_0005 fa_0001r.tif.jpg",
    "@type": "dctypes:Image",
    "format": "image/jpeg",
    "width": 97,
    "height": 150
},
"viewingHint": "non-paged"
},
{
    "@id": "https://digi.vatlib.it/iiif/MSS_Reg.lat.245/canvas/p0006",
    "@type": "sc:Canvas",
    "label": "1v",
    "width": 1297,
    "height": 2141,
    "images": [
        {
            "@id": "https://digi.vatlib.it/iiif/MSS_Reg.lat.245/res/anno0006",
            "@type": "oa:Annotation",
            "motivation": "sc:painting",
            "resource": {
                "@id": "https://digi.vatlib.it/iiif/MSS_Reg.lat.245/res/img0006",
                "@type": "dctypes:Image",
                "format": "image/jpeg",
                "service": {
                    "@context": "http://iiif.io/api/image/2/context.json",
                    "@id": "https://digi.vatlib.it/iiifimage/MSS_Reg.lat.245/Reg.lat.245_0006 fa_0001v.jp2",
                    "profile": "http://iiif.io/api/image/2/level2.json"
                },
                "width": 1297,
                "height": 2141
            },
            "on": "https://digi.vatlib.it/iiif/MSS_Reg.lat.245/canvas/p0006"
        }
    ]
},
"thumbnail": {
    "@id": "https://digi.vatlib.it/pub/digit/MSS_Reg.lat.245/thumb/Reg.lat.245_0006 fa_0001v.tif.jpg",
    "@type": "dctypes:Image",
    "format": "image/jpeg",
    "width": 95,
    "height": 150
},
},
{
    "@id": "https://digi.vatlib.it/iiif/MSS_Reg.lat.245/canvas/p0007",
    "@type": "sc:Canvas",
    "label": "2r",
    "width": 1327,
    "height": 2143,
    "images": [
```
<figure><img src="image_36.png" /></figure>

<figure><img src="image_37.png" /></figure>

<figure><img src="image_38.png" /></figure>

<figure><img src="image_39.png" /></figure>

<figure><img src="image_40.png" /></figure>

<figure><img src="image_41.png" /></figure>

OpenRefine manifest json

Permalien

Ouvrir...

Exporter

Aide

<figure><img src="image_42.png" /></figure>

294 lignes

Voir en: lignes entrées

Afficher: 5 10 25 50 100 500 1000 lignes

Extensions

VIB-Bits

RDF Transform

RDF

Wikidata

« première

« précédente

1

suivante

dernière »

Toutes

@id

url

id

<figure><img src="image_43.png" /></figure>

1. https://digi.vatlib.it/iiifimage/MSS_Reg.lat.245/Reg.lat.245_0001_al_piatto.anteriore.jp2

MSS_Reg.lat.245/Reg.lat.245_0001_al_piatto.anteriore.jp2

al_piatto.anteriore

<figure><img src="image_44.png" /></figure>

2. https://digi.vatlib.it/iiifimage/MSS_Reg.lat.245/Reg.lat.245_0002_ba_risguardia.anteriore.jp2

MSS_Reg.lat.245/Reg.lat.245_0002_ba_risguardia.anteriore.jp2

ba_risguardia.anteriore

<figure><img src="image_45.png" /></figure>

3. https://digi.vatlib.it/iiifimage/MSS_Reg.lat.245/Reg.lat.245_0003_cy_0001r.jp2

MSS_Reg.lat.245/Reg.lat.245_0003_cy_0001r.jp2

cy_0001r 1r

<figure><img src="image_46.png" /></figure>

4. https://digi.vatlib.it/iiifimage/MSS_Reg.lat.245/Reg.lat.245_0004_cy_0001v.jp2

MSS_Reg.lat.245/Reg.lat.245_0004_cy_0001v.jp2

cy_0001v 1v

<figure><img src="image_47.png" /></figure>

5. https://digi.vatlib.it/iiifimage/MSS_Reg.lat.245/Reg.lat.245_0005 fa_0001r.jp2

MSS_Reg.lat.245/Reg.lat.245_0005 fa_0001r.jp2

fa_0001r 1r

recto

<figure><img src="image_48.png" /></figure>

6. https://digi.vatlib.it/iiifimage/MSS_Reg.lat.245/Reg.lat.245_0006 fa_0001v.jp2

MSS_Reg.lat.245/Reg.lat.245_0006 fa_0001v.jp2

fa_0001v 1v

verso

<figure><img src="image_49.png" /></figure>

7. https://digi.vatlib.it/iiifimage/MSS_Reg.lat.245/Reg.lat.245_0007 fa_0002r.jp2

MSS_Reg.lat.245/Reg.lat.245_0007 fa_0002r.jp2

fa_0002r 2r

recto

<figure><img src="image_50.png" /></figure>

8. https://digi.vatlib.it/iiifimage/MSS_Reg.lat.245/Reg.lat.245_0008 fa_0002v.jp2

MSS_Reg.lat.245/Reg.lat.245_0008 fa_0002v.jp2

fa_0002v 2v

verso

<figure><img src="image_51.png" /></figure>

9. https://digi.vatlib.it/iiifimage/MSS_Reg.lat.245/Reg.lat.245_0009 fa_0003r.jp2

MSS_Reg.lat.245/Reg.lat.245_0009 fa_0003r.jp2

fa_0003r 3r

recto

<figure><img src="image_52.png" /></figure>

10. https://digi.vatlib.it/iiifimage/MSS_Reg.lat.245/Reg.lat.245_0010 fa_0003v.jp2

MSS_Reg.lat.245/Reg.lat.245_0010 fa_0003v.jp2

fa_0003v 3v

verso
# Export du modèle

## Préfixe

```
<facsimile>
<surfaceGrp>
```

## Modèle de ligne

```
<surface type="${type}" n="${n}" xml:id="${id}">
  <graphic url="${url}"/>
</surface>
```

## Séparateur de ligne

## Suffixe

```
</surfaceGrp>
</facsimile>
```

```
<facsimile>
<surfaceGrp><surface type="null" n=""" xml:id="a1_piatto.anteriori">
  <graphic url="MSS_Reg.lat.245/Reg.lat.245_0001_al_piatto.anteriori"/>
</surface><surface type="null" n=""" xml:id="ba_risguardia.anteriori">
  <graphic url="MSS_Reg.lat.245/Reg.lat.245_0002_ba_risguardia.anteriori"/>
</surface><surface type="null" n="1r" xml:id="cy_0001r">
  <graphic url="MSS_Reg.lat.245/Reg.lat.245_0003_cy_0001r.jp2"/>
</surface><surface type="null" n="1v" xml:id="cy_0001v">
  <graphic url="MSS_Reg.lat.245/Reg.lat.245_0004_cy_0001v.jp2"/>
</surface><surface type="recto" n="1r" xml:id="fa_0001r">
  <graphic url="MSS_Reg.lat.245/Reg.lat.245_0005 fa_0001r.jp2"/>
</surface><surface type="verso" n="1v" xml:id="fa_0001v">
  <graphic url="MSS_Reg.lat.245/Reg.lat.245_0006 fa_0001v.jp2"/>
</surface><surface type="recto" n="2r" xml:id="fa_0002r">
  <graphic url="MSS_Reg.lat.245/Reg.lat.245_0007 fa_0002r.jp2"/>
</surface><surface type="verso" n="2v" xml:id="fa_0002v">
  <graphic url="MSS_Reg.lat.245/Reg.lat.245_0008 fa_0002v.jp2"/>
</surface><surface type="recto" n="3r" xml:id="fa_0003r">
  <graphic url="MSS_Reg.lat.245/Reg.lat.245_0009 fa_0003r.jp2"/>
</surface><surface type="verso" n="3v" xml:id="fa_0003v">
  <graphic url="MSS_Reg.lat.245/Reg.lat.245_0010 fa_0003v.jp2"/>
</surface><surface type="recto" n="4r" xml:id="fa_0004r">
  <graphic url="MSS_Reg.lat.245/Reg.lat.245_0011 fa_0004r.jp2"/>
</surface><surface type="verso" n="4v" xml:id="fa_0004v">
  <graphic url="MSS_Reg.lat.245/Reg.lat.245_0012 fa_0004v.jp2"/>
</surface><surface type="recto" n="5r" xml:id="fa_0005r">
  <graphic url="MSS_Reg.lat.245/Reg.lat.245_0013 fa_0005r.jp2"/>
</surface><surface type="verso" n="5v" xml:id="fa_0005v">
  <graphic url="MSS_Reg.lat.245/Reg.lat.245_0014 fa_0005v.jp2"/>
</surface><surface type="recto" n="6r" xml:id="fa_0006r">
  <graphic url="MSS_Reg.lat.245/Reg.lat.245_0015 fa_0006r.jp2"/>
</surface><surface type="verso" n="6v" xml:id="fa_0006v">
  <graphic url="MSS_Reg.lat.245/Reg.lat.245_0016 fa_0006v.jp2"/>
</surface><surface type="recto" n="7r" xml:id="fa_0007r">
```
<facsimile>

<surfaceGrp>

<surface type="null" n="" xml:id="al_piatto.anteriore">
  <graphic url="MSS_Reg.lat.245/Reg.lat.245_0001_al_piatto.anteriore.jp2"/>
</surface>

<surface type="verso" n="10v" xml:id="fa_0010v">
  <graphic url="MSS_Reg.lat.245/Reg.lat.245_0024 fa_0010v.jp2"/>
</surface>

<surface type="recto" n="11r" xml:id="fa_0011r">
  <graphic url="MSS_Reg.lat.245/Reg.lat.245_0025 fa_0011r.jp2"/>
</surface>

(...)

</surfaceGrp>

</facsimile>
Conclure ?
# Quelques remarques en guise de conclusion

* Baliser c'est annoter en fonction d'objectifs d'exploitations

* Balisage "à la main" : utile à pratiquer pour apprendre / comprendre

* Tout part de l'analyse du document et des objectifs d'exploitation, en fonction d'une question de recherche

* Le balisage sémantique manuel de sources anciennes : quand l'expertise humaine est (encore) nécessaire...

* Granularité du balisage / nombre d'attributs à renseigner : bien évaluer les besoins, prendre en compte ce qui peut être calculé (pour alléger l'encodage premier)

* Plusieurs couches d'encodage combinables (enrichissements progressifs)

* La compréhension fine du balisage d'un corpus / du système d'annotation permet de concevoir des interfaces adaptées à la question de recherche
Suite

* Le balisage n'est pas une opération mécanique et neutre, c'est une activité intellectuelle analytique orientée par des objectifs d'expression scientifique et des besoins d'exploitation

* La qualité du résultat dépend de la conscience que l'on a du code utilisé pour décoder, du système du novueil codage et de la compréhsion que l'on a de la façon dont les manipulations automatiques vont s'opérer

* C'est quelque chose qui peut faciliter le travail, faire gagner du temps et permettre une plus grande acuité scientifique dès le départ, même si on ne fait pas d'édition.
## Conseils de lecture

* http://www.pum.umontreal.ca/catalogue/pratiques-de-ledition-numerique

* http://books.openedition.org/oep/1298

* http://dh.obdurodon.org/what-is-xml.xhtml

* https://dlsanthology.commons.mla.org/digital-scholarly-editing/

* http://jtei.revues.org/

* http://www.wwp.northeastern.edu/outreach/seminars/UCLA/presentations/html/introduction_markup_lecture.xhtml

* http://mutec.huma-num.fr/sites/www.mutec-shs.fr/files/Guide%20Editer%20des%20sources%20historiques%20%20gr%C3%A2ce%20a%20XML.pdf
<figure><img src="image_53.png" /></figure>