Doc/BM-Orléans

Notice :

Application sous contrat de Maintenance.

• Doc/BM-Orléans
• Doc/BM-Orléans/ALTO
• Doc/BM-Orléans/Conversion CSV-XML vers METS
• Doc/BM-Orléans/Conversion CSV vers BMO-XML
• Doc/BM-Orléans/Conversion CSV vers CSV-XML
• Doc/BM-Orléans/Drupal
• Doc/BM-Orléans/Structure des dossiers
• Doc/BM-Orléans/Structure du METS

Application de Démo

Important :

Le Google Analytics est celui de la démo : UA-37843608-1, il faudra le mettre à jour pour l'application de production.

Format : BMO-XML

Le format BMO-XML a été élaborés pour proposer une solution d'unification des différentes collections fournies par la bibliothèque d'Orléans. Un travail de converge sémantique a été entrepris, de façon à réduire la complexité du format.

Données XLS

Le tableau ci-dessous reprends les champs extraits des fichiers XLS repris.

Almanachs	Cartes-Plans	Cartes-Postales	Gravures	Vassal-Hubert
cote	n°	cote	n°	nom-famille
cote normalisée	cote normalisée	cote normalisée	cote	lieu-geog
titre complet	cote	titre complet	cote normalisée	date
titre court	titre complet	lieu	titre complet	date-réelle
date grégorienne	titre court	organisation: editeur	dimensions	ref-vol-hubert
date révolutionnaire	mots-clés	date	personne: dessinateur	path (chemin) Vassal
debut_vue	thèmes	mots-clés	personne: illustrateur	liste images Vassal
id_vue_debut_table	demi-siècle	thèmes	mots-clés	path (chemin) Hubert
path TdM	date	liste images	thèmes	liste images Hubert
notes	demi-siècle évén	coordonnées géographiques	demi-siècle	remarques
vues_debut_fin.	dimensions	sous_droits	date exacte	sous_droits
path (chemin) début	nombre images	path (chemin)	liste images	identifiant
path (chemin) fin	manuscrit	identifiant	coordonnées géographiques
numero_cd	liste images		sous_droits
remarque_cd	remarques_images		path (chemin)
type	coordonnées géographiques
titre illustration	sous_droits		identifiant
coordonnées géographiques	path (chemin)
identifiant	path 2
Identifiant.old	path 3
	path 4
	path 5
	path 6
	path 7
	path 8
	path 9
	path 10
	path 11
	path 12
	path 13
	identifiant

Schéma de notice

Pour répondre à l'hétérogénéité des données le format BMO-XML'

<?xml version="1.0" encoding="UTF-8"?>
<!-- list of notice -->
<bmo-xml>
<!-- @id{almanach::identifiant} -->
<!-- @id{cartes-plans::identifiant} -->
<!-- @id{cartes-postales::identifiant} -->
<!-- @id{gravure::identifiant} -->
<!-- @id{presse::ID_DOCNUM} -->
<!-- @id{lenoir::identifiant} -->
<!-- @id{hubert::identifiant} -->
<!-- @id{vassal::identifiant} -->
<!-- @id{vassal-hubert::identifiant} -->
<!-- @collection{*} -->
<notice id="id-de-l-element"
    collection="almanachs|cartes-plans|cartes-postales|gravures|hubert|lenoir|vassal|journal-loiret"
>
	<!-- {almanach::cote}	@normal{almanach::cote normalisée} -->
  <!-- {lenoir::cote} @normal{lenoir::cote normalisée} -->
  <!-- {hubert::cote} -->
  <!-- {vassal::cote} -->
  <!-- {gravure::cote} @normal{gravure::cote normalisée}-->
  <!-- {cartes-plans::cote} @normal{cartes-plans::cote normalisée}-->
  <!-- {cartes-postales::cote} @normal{cartes-postales::cote normalisée}-->
  <!-- {presse::COTE_ORIGINAL} -->
  <cote normal="cote-normalisee">cote brute</cote>
  <misc>
    <!-- {vassal-hubert::ref-vol-hubert} -->
    <refs>
      <ref type="ouvrage" target="ref-vol-hubert">vol. VI, f°17</ref>
      ...
      <ref type="ouvrage" target="ref-vol-hubert">vol. VIII, f°4</ref>

    </refs>
    <!-- {gravure::n°} -->
    <!-- {cartes-plans::n°} -->
    <num>numéro de l'élément</num>
    <!-- {hubert::folio} -->
    <folio position="">libellé</folio>
		<!-- {almanach::numero_cd} -->
    <!-- {hubert::label cd} @{hubert::no_support} -->
    <!-- {vassal::label cd} -->
    <device type="cd" num="CD00001">libellé</device>
    <!-- {presse::ID_SUPPORT} @num{presse::ID_SUPPORT} -->
    <device num="10CMED0475_8" />
		<!-- {almanach::remarque cd} -->
    <!-- {vassal::remarques} -->
    <!-- {cartes-plans::remarques_images} -->
    <!-- {vassal-hubert::remarques} -->
    <remark>remarque non rattaché à une image particulière</remark><!-- remarque non rattaché à une image particulière -->
  </misc>

  <semantic>
    <!-- {*::titre} -->
		<!-- {almanach::titre complet} -->
    <!-- {gravure::titre complet} -->
    <!-- {cartes-postales::titre complet} -->
    <!-- {cartes-plans::titre complet} -->
    <!-- {presse::TITRE} -->
    <title role="full"> titre complet et très très long </title>
		<!-- {almanach::titre court} -->
    <!-- {cartes-plans::titre court} -->
    <title role="short"> titre court</title>
    <dates>
      <!-- les colonne 'demi-siecle': doit gérer comme du texte brut, la valeur sera rendu dans une liste déroulante sans traitement particulier -->
			<!-- {almanach::date révolutionnaire} -->
      <!-- {gravure::demi-siècle} -->
      <!-- {cartes-plans::demi-siècle} -->
      <date type="half-century">1900-1949</date>
      <!-- {cartes-plans::demi-siècle évén} -->
      <date role="evenement">1900-1949</date>
      <!-- {vassal-hubert::date} (si non reconnu)-->
<!--       <date type="raw">1557-XVIIe siècle</date> -->
			<!-- {almanach::date grégorienne} (si interval) -->
      <!-- {cartes-plans::date} -->
      <!-- {vassal-hubert::date} -->
      <date-interval>
        <!-- {vassal-hubert::date} -->
        <date type="raw">15..-16..</date>
        <date role="bdate" normal="1900">1900</date>
        <date role="edate" normal="1949">1949</date>
      </date-interval>
      <!-- {*::date} -->
      <!-- {gravure::date exacte} -->
      <!-- {cartes-plans::date} -->
      <!-- {cartes-postales::date} -->
<!--       <date type="exact" normal="1928">1928</date> -->
      <!-- {presse::DATE} -->
			<!-- {almanach::date grégorienne} (si pas interval) -->
      <date type="exact" normal="1782-02-01">20111101</date>
      <date type="exact" calendar="gregorien" normal="1931">1931</date>
<!--       <date type="exact" calendar="revolutionnaire" normal="??????">an I</date> -->
      <!-- {presse::DATE_NUM} -->
      <date type="exact" role="numerisation" normal="2011-11-01">20111101</date>
    </dates>

    <semantic-items><!-- items sémantiques (mots-clés, index, thèmes, ) -->
			<!-- {cartes-plans::mots-clés} -->
			<!-- {cartes-postales::mots-clés} -->
			<!-- {gravure::mots-clés} -->
			<keywords>
				<keyword type="raw">mot-clé-1 ; mot-clé-2</keyword>
				<keyword type="subject">mot-clé-1</keyword>
				<keyword type="subject">mot-clé-2</keyword>
			</keywords>

			<!-- {cartes-plans::thèmes} -->
			<!-- {cartes-postales::thèmes} -->
			<!-- {gravure::thèmes} -->
			<themes>
				<theme type="raw">theme-1 ; theme-2</theme>
				<theme type="subject">theme-1</theme>
				<theme type="subject">theme-2</theme>
			</themes>
    </semantic-items>

    <entities><!-- entités liées au document: pesonne, organisation -->
      <!-- {gravure::personne: dessinateur} -->
      <person role="dessinateur">Charles Pensée</person>
      <!-- {gravure::personne: illustrateur} -->
      <person role="illustrateur">Pensée</person>
      <!-- {cartes-postales::organisation: editeur} -->
      <person role="editeur">Vogue</person>
      <!-- {vassal-hubert::ref-vol-hubert} -->
      <person role="family-name">ANCEL</person>
      <!-- {presse::EDITION} -->
      <organisation role="edition">pas d'exemple</organisation>
    </entities>
  </semantic>

  <properties><!-- propriétés du document d'origine -->
    <!-- {gravure::dimensions} -->
    <!-- {cartes-plans::dimensions} -->
    <dimensions>
      <format x="32" y="46" unit="cm">32x46</format>
      <format x="36" y="105" unit="inch">36x105</format>
    </dimensions>
    <!-- {presse::RESOLUTION} -->
		<!-- <resolution>300</resolution> -->
    <!-- {cartes-plans::couleur} -->
    <color-palette>niveau de gris</color-palette><!-- palette de couleur: N&B, gris, couleur, etc. -->
    <!-- {cartes-plans::vues} -->
    <views>4</views><!-- nombre de "vues" -->
    <!-- {cartes-plans::nombre images} -->
    <images-count>12</images-count><!-- nombre d'images -->
    <!-- {almanach::note} -->
    <!-- {cartes-plans::manuscrit} -->
    <notes><!-- état du documents, description, remarque -->
    	<note about="unknow">pas d'exemple</note>
	    <!-- {presse::DESC_PHYS_DOCNUM} -->
			<!-- <note about="document">numérotation de fascicule erronée</note> -->
	    <!-- {presse::DESCR_PHYS_PAGE} -->
			<!-- <note about="page">pas d'exemple</note> -->
    </notes>
    <!-- {cartes-postales::lieu} -->
    <!-- {vassal-hubert::lieu} -->
    <place>Orléans</place>
    <!-- {gravure::sous_droits} -->
    <!-- {cartes-plans::sous_droits} -->
    <copyrights/>
  </properties>

  <!-- @fonds{vassal-hubert::} -->
  <media fonds="vassal|hubert">
    <!-- {*::url image} -->
    <!-- {gravure::liste images} @file/src{gravure::path (chemin)} -->
    <!-- {cartes-postales::liste images} @file/src{cartes-postales::path (chemin)} -->
    <!-- {cartes-postales::liste images} @file/src{cartes-postales::path (chemin)} -->
    <!-- {presse::ID_AUTREVERSION} @pagination{presse::N_PAGE}-->
<!-- +++++++++++++++++++ -->
    <!--
    	{almanach::path (chemin) début}
    	si le type de la ligne = illustration, on met un @role=image:illustration.
     -->
    <image role="image:illustration" >
    <image role="image:first" pagination="1">
		<!-- {almanach::titre illustration} -->
		<caption>Gouvernement d'Orléanais, où se trouvent l'Orléanais propre, le Blaisois, le Gâtinais et la Beauce, qui comprend le Vendômois, le Dunois et le pays Chartrain</caption>
    	<!-- @src{almanach::path (chemin) début} -->
		<file type="tiff" src="path/to/TIFF/toto2213231-10000002.tif">toto2213231-10000002.tif</file>
		<!-- {presse::ID_AUTREVERSION} -->
		<ocr type="alto">10000002.XML</ocr>
		<!-- {almanach::coordonnées géographiques} -->
        <coordinates latitude="4.9030333" longitude="2.9030333" />
    </image>

<!-- +++++++++++++++++++ -->
    <!-- {*::url image} -->
    <!-- {gravure::liste images} @file/src{gravure::path (chemin)} -->
    <!-- {cartes-postales::liste images} @file/src{cartes-postales::path (chemin)} -->
    <!-- {cartes-postales::liste images} @file/src{cartes-postales::path (chemin)} -->
    <!-- {presse::ID_AUTREVERSION} @pagination{presse::N_PAGE}-->
    <!-- {almanach::path (chemin) fin} -->
    <image role="image:last">
		<!-- {vassal-hubert::famille}, {vassal-hubert::lieu}, {vassal-hubert::date} -->
		<caption>Gouvernement d'Orléanais, où se trouvent l'Orléanais propre, le Blaisois, le Gâtinais et la Beauce, qui comprend le Vendômois, le Dunois et le pays Chartrain</caption>
		<!-- @src{almanach::path (chemin) fin} -->
		<file type="tiff" src="path/to/TIFF/toto2213231-10000004.tif">toto2213231-10000004.tif</file>
		<!-- {presse::ID_AUTREVERSION} -->
		<ocr type="alto">10000004.XML</ocr>
		<!-- {gravure::coordonnées géographiques} -->
		<!-- {cartes-plans::coordonnées géographiques} -->
		<!-- {carte-postales::coordonnées géographiques} -->
		<coordinates latitude="4.9030333" longitude="2.9030333" />
    </image>

			<!-- {almanach::id_vue_debut_table} -->
    <image role="image:toc">
			<!-- {almanach::titre illustration} -->
    	<caption>Gouvernement d'Orléanais, où se trouvent l'Orléanais propre, le Blaisois, le Gâtinais et la Beauce, qui comprend le Vendômois, le Dunois et le pays Chartrain</caption>
      <file type="tiff" src="path/to/TIFF/toto2213231-10000003.tif">toto2213231-10000003.tif</file>
      <!-- {presse::ID_AUTREVERSION} -->
      <ocr type="alto">10000003.XML</ocr>
        <!-- {gravure::coordonnées géographiques} -->
        <!-- {cartes-plans::coordonnées géographiques} -->
        <!-- {carte-postales::coordonnées géographiques} -->
        <coordinates latitude="4.9030333" longitude="2.9030333" />
    </image>

  </media>
</notice>
</bmo-xml>

Publication de notice

Les documents aux formats BMO-XML doivent être placé dans le répertoire indiqué par la variable bmo.bmo-xml-docs-dir du fichier <app>/WEB-INF/properties/bmo-xml.properties.

Le format de publication par lot est légèrement trompeur, on peut – théoriquement – publier les notices de façon individuelles si elles sont chacune dans un fichier respectif (cf. section Mise à jour de notice).

Remarques : Les fichiers doivent des fichiers XML bien formés et respecter le schéma décrit dans la section Schéma de notice.

Conversion de notice (CSV vers BMO-XML)

To do :

La procédure de conversion n'est à l'heure actuelle suffisamment conviviale pour être utilisée par les utilisateurs finaux. Si toutes fois, vous souhaitez faire une conversion la procédure est décrite dans Doc/BM-Orléans/Conversion CSV vers BMO-XML.

À l'avenir, on proposera un champs de sélection de fichiers .csv (Parcourir…) qui prendra en charge la conversion du format CSV vers le format BMO-XML.

Suppression de notice

La suppression des notices se faire une par une.

Mise à jour de notice

Pour corriger une notice, on re-publiera la notice corrigé. Pour ce faire deux solutions s'offrent à nous :

1. Modifier le fichier contenant toutes les notices de la collection et le republier. La durée de publication étant assez cours, cette solution est viable.
2. Extraire la notice que l'on veut corrigé dans un fichier XML séparés (p. ex. : ma-notice.xml) est publier ce fichier. Le fichier doit être bien formés

Important :

Cette seconde approche est théorique, je ne l'ai jamais testé.

Formulaire de recherche

To do :

Cette fonctionnalité n'existe plus, depuis l'éclatement en plusieurs bases des données BMO-XML.

Le formulaire de recherche est dynamique. En effet, la liste des collections se construit dynamiquement en fonction des valeurs retournées par l'index collection

Résultats de recherche

To do :

La pagination est inconsistante, elle doit être corrigée..

Colone « Cote »

La colonne « Cote » affiche la cote sous sa forme brute et le tri se fait sur la cote normalisée.

Notice :

L'affichage étant différent de la données sur laquelle on tri, il se peut les l'ordre des résultats paraissent incohérents, mais c'est l'approche souhaité par la bibliothèque.

Colone « Libellé »

• Pour les collections almanachs, cartes-plans, cartes-postales et gravures la colone « Libellé » corresponds à l'élément <title role=full> ;
• pour la collection vassal-hubert cela corresponds à l'élément {{tag|person role=family-name.

Colone « Date »

La colonne « Date » est construite sur l'heuristique suivante :

1. Pour la collection vassal-hubert,
   1. date brute ;
   2. intervalle de date ;
2. Sinon
   1. date exacte ;
   2. date brute ;
   3. intervalle de date ;
   4. demi-siècle ;
   5. évènement ;
   6. unknow-date.

Notice :

Le tri ce fait sur la forme normalisée. Comme pour la colonne « Cote », l'affichage étant différent de la données sur laquelle on tri, il se peut les l'ordre des résultats paraissent incohérents, mais c'est l'approche souhaité par la bibliothèque.

Mise en forme des notices

La mise en forme des notices est basé sur un modèle de notice générique qui peut être étendu pour chaque collection. On consultera notamment la collection Vassal-Hubert (Fonds de généalogie orléanaise) pour un exemple.

Les liens rebonds sont à l'heure actuelle restreints à la collection à laquelle appartient la notice.

Conception logiciel

La feuille XSL de construction (<app>/module-bmo-xml/xsl/notice-builder.xsl) est générique. Elle déclare un ensemble de templates, est les invoques de façon générique, sur un système de hook.

L'inclusion des feuilles de transformations relative à chaque collection (e.g. : notice-vassal-hubert.xsl), permet à celles-ci de surcharger les déclarations et les invocations de notice-builder.xsl. Redéfinissant de ce faite le rendu final.

Propriétés : BMO-XML

Notice :

Pour les URL, donner l'URL absolue avec un slash à la fin pour les répertoires.

Emplacement des CSV : bmo.csv-import-dir

Paramètre	Défaut	Valeurs possible	Description
bmo.csv-import-dir	vide	chemin	Emplacement des données soumis par BM-Orléans, converti en CSV.

Emplacement des CSV-XML : bmo.csv-xml-export-dir

Paramètre	Défaut	Valeurs possible	Description
bmo.csv-xml-export-dir	vide	chemin	Destination de la conversion CSV vers CSV-XML et Source de la conversion CSV-XML vers XML-BMO. Shell-script must use this path as input/output-directory.

Emplacement des CSV : bmo.export-xml-bmo-dir

Paramètre	Défaut	Valeurs possible	Description
bmo.export-xml-bmo-dir	vide	chemin	Destination de la conversion CSV-XML vers XML-BMO.

Emplacement des documents BMO-XML : bmo.bmo-xml-docs-dir

Paramètre	Défaut	Valeurs possible	Description
bmo.bmo-xml-docs-dir	vide	chemin	Emplacement des documents publiables (notices au format BMO-XML). Équivalent à la variable pleade.ead-docs-dir pour l'EAD Shell-script must use this path as input/output-directory.

Liste des notices publiées : bmo.published-bmo-xml-files

Paramètre	Défaut	Valeurs possible	Description
bmo.published-bmo-xml-files	context://module-bmo-xml/conf/published-files.xml	chemin	URL du fichier qui à un instant t, indique les documents BMO-XML qui ont été publiés.

Dossier de travaille de la publication : bmo.publish.workdir

Paramètre	Défaut	Valeurs possible	Description
bmo.publish.workdir	context://module-bmo-xml/workdir/	chemin	Chemin du répertoire de travail pour la publication des documents BMO-XML. Ce répertoire est pour usage interne de l'application, il contient les documents téléversés, splittés, etc. To do : Il faut indiquer le sous-dossier workdir/ quand on renseigne la variable. Important : le dossier workdir/upload/ doit exister.

Mise à jour des collections

Une partie des collections est en cours de numérisation, il sera donc nécessaire de pouvoir les mettre à jour. À noter qu'elle n'évolueront pas quand aux données quelles contiennent.

Mise à jour prévues

1. Cartes Postales ;
2. Manuscrit ;

Les données existantes

Corpus	Description	Format et traitement
Iconographie locale	Ensemble de trois bases de données (3 fichiers excel) : Cartes et plans ; Gravures ; Cartes postales. Texte de présentation pour chaque base. Recherche par thème puis par année/période.	Données descriptives dans fichiers excel. 1 base = 1 fichier excel. 1 ligne = 1 notice. 1 notice = 1 ou n images TIFF.
Almanachs	Données descriptives et images numérisées des almanachs orléanais. Recherche par almanach puis par année. Texte de présentation.	Données dans fichiers excel. 1 ligne = 1 notice/almanach. 1 notice = 1 ou n images TIFF. Un autre excel liste les images qui représentent des plans et gravures situées dans certains almanachs. liste certaines vues remarquables : des plans et gravures.
Index de Charles de Vassal et Manuscrits de généalogie du chanoine Hubert	Données descriptives et images numérisées de l'index de C. de Vassal et correspondance avec les manuscrits de généalogie du chanoine Hubert dans fichier excel. Recherche par nom propre et date. Texte de présentation.	Correspondance entre l'index Vassal et le manuscrit Hubert et données descriptives dans un fichier excel. 1 ligne = 1 nom de famille. Pagination dans 2 fichiers excel supplémentaires
Manuscrits de Le Noir	Composante du document EAD : « Catalogue général des manuscrits des bibliothèques publiques de France. Départements — Tome LVII. Orléans. Deuxième supplément » qui fera l'objet d'un formulaire de recherche spécifique à l'EAD.	fichier Excel reconstituant la table des matières de chaque manuscrit Les données descriptives seront au format EAD. La collection d'images concernent les trois cotes 1421, 1422 et 1423. fichier Excel de tables de matières utilisé pour la navigation dans la visionneuse. Trois liens seront ajoutés dans l'EAD vers la collection d'images illustrant le manuscrit de Le Noir. Le document EAD est publié en entier.