Description des données du projet
======================================

Forme des datas
------------------

.. image:: img/exemple_parchemin_acte.jpg

Les données du projet *Actes princiers au royaume de France* sont des actes médiévaux - c'est-à-dire des documents qui fondent un droit pour une personne physique ou morale - émis par des princes de la fin de Moyen Âge. Ces princes sont des membres de la famille du roi de France (Orléans, Anjour, Berry, Bourgogne, Alençon, Bourbon) ou des grands feudataires (Bretagne, Savoie, Albret, Armagnac).

État actuel des actes
---------------------

.. index:: originaux, copies, minutes, vidimus, deperditum

Le fichier : :file:`state_data.py`

- Les actes sont écrits au Moyen Âge sur des peaux de parchemin : lors que le parchemin nous est parvenu, on parle d'un **acte original** ou d'une **minute**.

- Les actes originaux ont pu être copiés et certifiés par un notaire au Moyen Âge ou à l'Époque Moderne : on parle alors d'un **vidimus**.

- Les actes orginaux ont pu être copiés : on parle alors d'une **copie**.

- Certains actes originaux sont totalement perdus, mais on en conserve des mentions plus ou moins détaillées ou des éditions modernes : on parle alors d'un **deperditum** (pluriel *deperdita*).

Types diplomatiques des actes
-----------------------------

.. index:: type diplomatique, charte, lettres patentes, mandement, lettres closes, lettres missives, quittance, acte authentique, deperditum

Le fichier : :file:`diplo_type_data.py`

- La diplomatique *vise, plus largement, à mettre en oeuvre une compréhension critique de l'une des grandes catégories de sources écrites, les actes écrits, où se trouve consigné soit l'accomplissement d'un acte juridique, soit l'existence d'un fait juridique, soit encore éventuellement un fait quelconque dès lors que l'écrit est rédigé dans une certaine forme propre à lui donner validité* (définition de la Commission internationale de diplomatique reprise par l'École nationale des chartes, 2011, `source <http://theleme.enc.sorbonne.fr/cours/diplomatique>`_).

- Chaque acte princier possède un type diplomatique, c'est-à-dire qu'il est rattaché à une catégorie documentaire qui permet de le critiquer.

- Les types diplomatiques utilisées pour qualifier les actes princiers sont :

.. list-table:: Types diplomatiques
   :widths: 25 25
   :header-rows: 1

   * - Type
     - Caractéristiques
   * - Charte
     - Valeur perpétuelle ("à tous présent et à venir", "pour que ce soit ferme et estable à toujours mais"), scellée d'un sceau en cire verte sur double queue
   * - Lettres patentes
     - Adresse universelle ("à tous ceux qui ces présentes lettres verront"), corroboration simple ("en témoins de ce"), scellée d'un sceau en cire rouge sur double queue
   * - Mandement
     - Adresse particulière à tel officier, pas de corroboration, scellée d'un sceau en cire rouge sur simple queue
   * - Quittance
     - Formules "confessons avoir eu et receu de" et "de laquelle somme de ... nous tenons pour bien content et païé et en quittons ..."
   * - Lettres missives
     - Acte de correspondance, sceau plaqué.
   * - Lettres closes
     - Formule "lettres de par le duc". Sceau plaqué.
   * - Acte authentique
     - Acte passé sous la seule autorité d'un notaire.
   * - Deperditum
     - Deperditum dont le type diplomatique n'a pas pu être déterminé.

Conservation des actes
----------------------

.. index:: Archives nationales de France, archives départementales, archives municipales, Bibliothèque nationale de France, bibliothèques municipales

Le fichier : :file:`institutions.yaml`

- Les actes originaux, vidimés ou copiés sont conservés dans des institutions patrimoniales et y possèdent tous une cotation. Par exemple : *Archives départementales de la Côte d'Or, B 11942, cote 247*, *Bibliothèque nationale de France, ms. fr. 20389, cote 99*. Ces institutions patrimoniales peuvent être :

  - des services d'archives : Archives nationales de France, services d'archives départementales ou municipales.

  - des bibliothèques : Bibliothèque nationale de France, bibliothèques municipales

- S'il s'agit d'un deperditum :

  - s'il s'agit d'édition, c'est la référence abrégée du livre dans lequel ils sont édités qui est donné.

  - si le deperditum est mentionné dans un document d'archives, c'est la cote de ce document qui est donné.

- Dans le projet, les institutions sont listées dans le fichier `institutions.yaml`. Toutes les institutions listées ne contiennent pas un acte princier : il s'agit d'en lister le plus possible pour les futurs actes qui seront entrés dans la base.

Identifiants
-------------

.. index:: Albret, Alençon, Armagnac, Berry, Bourbon, Bourgogne, Bretagne, Orléans, Savoie

- Chaque maison princière a un identifiant : 

.. list-table:: Identifiants des maisons princières
   :widths: 25 25
   :header-rows: 1

   * - Maison
     - Code
   * - Albret
     - alb
   * - Alençon
     - alb
   * - Anjou
     - anj
   * - Armagnac
     - arm
   * - Berry
     - bry
   * - Bourbon
     - brb
   * - Bourgogne
     - brg
   * - Bretagne
     - bre
   * - Orléans
     - orl
   * - Savoie
     - sav

- Chaque prénom porté par les princes et princesses a un identifiant,

  - Celui des noms d'homme est composé de deux lettres ;

  - Celui des noms de femme de trois lettres.

.. list-table:: Identifiants des prénoms des princes et princesses
   :widths: 25 25
   :header-rows: 1

   * - Prénom    
     - Code
   * - Alain     
     - al  
   * - Amédée    
     - am  
   * - Arthur    
     - ar  
   * - Bernard   
     - be  
   * - Charles   
     - ch  
   * - Édouard   
     - ed  
   * - François  
     - fr  
   * - Jean      
     - je  
   * - Louis     
     - lo  
   * - Philippe  
     - ph  
   * - Pierre    
     - pi  
   * - René      
     - re  
   * - Anne      
     - ann 
   * - Agnès     
     - agn 
   * - Béatrice  
     - bea 
   * - Blanche   
     - bla 
   * - Bonne     
     - bon 
   * - Catherine 
     - cat 
   * - Françoise 
     - fra  
   * - Isabelle 
     - isa 
   * - Jeanne    
     - jea 
   * - Marguerite
     - mag 
   * - Marie     
     - mar  
   * - Yolande     
     - yol 

- Chaque prince ou princesse a un numéro d'ordre, en romain minuscule : `i`, `ii`, `iii`, `iv`, etc. 

- L'identifiant des actes (`@xml:id` de `<TEI>`) est composé des trois éléments séparés d'un underscore et suivi de la date et d'une lettre.

	- Actes de Charles Ier de Bourbon du 28 août 1427 : `brb_ch_i_1427_08_24a`.
	
Les fichiers XML
----------------

- Les actes princiers se trouvent dans des fichiers XML-TEI. Un fichier XML correspond à un acte.

- Chaque fichier est divisé en deux grands ensembles, le `<teiHeader>` et le `<text>`.

- Le `<teiHeader>` documente l'édition :

  - le `<titleStmt>`, avec trois niveaux de titre (*Actes princiers*, *Actes de X* et identifiant de l'acte) et l'identité de la personne ayant effectué la transcription.

  - le `<editionStmt>` associé l'édition au projet Actes princiers et liste les individus impliqués dans le projet.

  - le `<publicationStmt>` donne les informations de publications et la licence.

  - le `<sourceDesc>` contient les métadonnées relatives à l'acte édité :

    - le `<msDesc>` indique le lieu où l'acte est conservé, sa cote, et sa date ;

    - le `<listPerson>` contient l'identité des individus ayant émis (princes ou pricnesses) et signé (princes, princesses ou secrétaires) l'acte ;

    - le `<listWit>` contient le tableau de la tradition de l'acte, c'est-à-dire la liste de l'ensemble des exemplaires connus du document. Des notes critiques (`<note>`) peuvent s'y trouver : *cf. supra* ;

    - le `<listPlace>` contient la localisation de l'acte avec des coordonnées géographiques.

  - le `<profileDesc>` contient dans un `<abstract>` le résumé de l'acte.

- Le `<text>` contient l'édition critique :

  - L'édition se trouve dans une `<div>`, qui possède plusieurs attributs :

    - `@n` avec la date de l'acte et une lettre (`14381227a`) ;

    - `@xml:id` avec l'identifiant de l'acte agn-i-14381227a ;

    - `@type` avec l'état de l'acte ;

    - `@subtype` avec le type diplomatique de l'acte.

  - Une `<div>` de deuxième niveau (avec `@type="front"`) contient :

    - `<docDate>` avec la datation de temps (`<date>`) et de lieu (`<placeName>`) ;

    - `<argument>` avec l'analyse de l'acte.

  - Une autre `<div>` de deuxième niveau (avec `@type="acte"`) contient :

    - Le texte de l'acte dans des `<p>` ;

    - Une ou plusieurs mentions hors teneur dans une ou des `<div>` de troisième niveau (avec `@type="MHT"`). Un `@subtype` peut venir préciser l'emplacement de la mention hors teneur ;

    - Une ou plusieurs signatures dans une ou des `<div>` de troisième niveau (avec `@type="sign"`).
  
  - Des notes (`<note>`) peuvent également être ajoutées :
    
    - Les notes paléographiques concernent l'écriture de l'acte : `<note @type="paleo">`

    - Les notes critiques contextualisent ou explicitent un élément de l'édition, qu'il soit situé dans l'analyse, le tableau de la tradition ou le texte de l'acte : `<note @type="bp">` (`bp` pour *bas de page*).

Les fichiers CSV de corpus
--------------------------

- Les actes princiers sont décrits dans des CSV. Chaque CSV correspond à un prince ou une princesse.

- Les colonnes des CSV sont :

.. list-table:: Colonnes des CSV
   :widths: 15 30
   :header-rows: 1

   * - Colonne
     - Contenu
   * - ACTE_ID
     - identifiant de l'acte
   * - NUM
     - numérotation de l'acte (*utile dans le CSV uniquement*)
   * - INSTITUTION
     - institution de conservation de l'acte
   * - IDNO1
     - série de l'acte dans l'institution de conservation
   * - IDNO2
     - cote de l'acte dans l'institution de conservation
   * - ETAT
     - état de l'acte
   * - TYPE DIPLOMATIQUE
     - type diplomatique de l'acte
   * - ANNEE
     - année d'écriture de l'acte
   * - DATE
     - date de l'acte *telle qu'elle est écrite dans le XML*
   * - DATE_MODIFIEE
     - date de l'acte au format `YYYY, DD MM`
   * - LIEU
     - lieu de production de l'acte
   * - PRINCE
     - individus ayant émis l'acte (séparés par `+++`)
   * - SIGNATAIRE
     - individus ayant signé l'acte (séparés par `$$$`)
   * - LANGUE
     - langue de rédactino de l'acte
