Il y a 389 articles et 19 utilisateurs inscrits (ce bandeau est défini dans MediaWiki:Sitenotice)

Doc/BM-Orléans

De AJLSM
Version datée du 30 septembre 2014 à 10:37 par Ctate (discussion | contributions)
Aller à la navigation Aller à la recherche
Notice :
Application sous contrat de Maintenance.

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) :
    1. Cartes et plans ;
    2. Gravures ;
    3. Cartes postales.
  • Texte de présentation pour chaque base.
  • Recherche par thème puis par année/période.
  1. 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.
  1. Données dans fichiers excel.
    • 1 ligne = 1 notice/almanach.
    • 1 notice = 1 ou n images TIFF.
  2. 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
  1. 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.
  1. Correspondance entre l'index Vassal et le manuscrit Hubert et données descriptives dans un fichier excel.
    • 1 ligne = 1 nom de famille.
  2. 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.

  1. 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.
  2. 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.

Connexion admin à drupal

http://aurelia.orleans.fr/user mot de passe et dans internals Configuration -> Mode Maintenance Cocher "Mettre le site en mode maintenance " [ Enregistrer la configuration ]

Récupérée de "https://mediawiki.ajlsm.com/index.php?title=Doc/BM-Orléans&oldid=2541"