Dilib, hiérarchie : Différence entre versions

De Wicri Outils
(Arborescence Dilib)
(Variables d'environnement)
 
Ligne 105 : Ligne 105 :
  
 
Pour des raisons de performances, plusieurs versions pourront être obtenues par compilation. A l'heure actuelle, une seule version est disponible : Main.
 
Pour des raisons de performances, plusieurs versions pourront être obtenues par compilation. A l'heure actuelle, une seule version est disponible : Main.
 +
===$DILIB_DATA===
 +
''A partir de la version V0.6.40''
  
 +
Répertoire contenant les données de curation issues du réseau Wicri
 
===$DILIB_IMPORT===
 
===$DILIB_IMPORT===
 
===$DILIB_BOTTOM===
 
===$DILIB_BOTTOM===
Ligne 111 : Ligne 114 :
 
===$WICRI_ROOT===
 
===$WICRI_ROOT===
 
La variable [[$WICRI_ROOT]] désigne la racine de l'arborescence Wicri.
 
La variable [[$WICRI_ROOT]] désigne la racine de l'arborescence Wicri.
 +
 
==Fichiers d'initialisation==
 
==Fichiers d'initialisation==
 
A partir de la version V0.6.34, 2 fichiers d'initialisation sont utilisés.
 
A partir de la version V0.6.34, 2 fichiers d'initialisation sont utilisés.

Version actuelle datée du 7 octobre 2024 à 15:33

LogoDilib.gif
Panneau travaux.png
Bibliothèque Dilib (ressources numériques)

Cette page introduit la description de la hiérarchie de fichiers de la bibliothèque Dilib.

Par rapport aux versions précédentes, à partir de la version V0.5.20, la bibliothèque contient trois parties essentielles :

  • les sources de programmes qui figurent dans le répertoire Import ($DILIB_IMPORT) ;
  • les bibliothèques et exécutables qui sont compilés dans le répertoire "Main" ($DILIB) ;
  • les données qui sont stockées dans $DILIB_ROOT/Data
 

Installation recommandée

Évolution concernant les données

A partir de la version V0.6.33, une réorganisation est en cours pour séparer les données des modules logiciels. Ceci devrait permettre d'offrir :

  • une boîte à outils générique, relativement indépendante des projets Wicri LorExplor,
  • un complément de données pour le génération de serveurs d'exploration.

Dilib et Wicri

La bibliothèque Dilib est de plus en plus complémentaire du projet Wicri. En effet, les serveurs d'exploration sont généralement associés à un wiki du réseau.

Nous recommandons d'installer 2 hiérarchies de fichiers sur une machine donnée, une pour gérer la bibliothèque d'outils et données associées, l'autre pour les serveurs associés aux wikis.

Par exemple, sur une configuration MacBook, à partir de l'emplacement Documents, on peut trouver :

- Documents +
            +- Dilib -
            |
            +- WicriRoot -

Arborescence Wicri

Nous recommandons, pour l'arborescence Wicri de reprendre l'organisation en place sur la machine Ticri de l'Université de Lorraine.

La racine sera manipulée dans les scripts shells par la variable d'environnement $WICRI_ROOT et la proposition "WicriRoot" du paragraphe précédent est « facultative ».

En revanche, pour utiliser facilement les exemples données sur les serveurs à l'aide de « copier-colle », il convient de respecter ce qui suit :

  • les répertoires correspondants à des wikis communs sont rangés sous un répertoire nommé Wicri,
  • les wikis institutionnels sont rangés à partir de répertoire dont le nom correspond généralement à un wiki commun.
  • les « wikis clonés »[1] sont placés sous leur code langue.
  • les serveurs sous un répertoire nommé corpus.

Ainsi, une installation conforme sera :

- Documents 
      +- Dilib - ...
      |
      +- WicriRoot 
            +- Wicri 
            |     +- Europe
            |     |      +France
            |     |      |     + Lorraine 
            |    ...    ...    |     +- explor +
            |     |           ...    |     +- CrpgHal +
                  |                  |          + CrpgHalV1
                  |                  +- fr + Clone de Wicri/Lorraine (fr)
                  +- Ticri 
                       +- H2ptm

Arborescence Dilib

Pour supporter plusieurs versions, depuis la version VO.6.29, la hiérarchie recommandée est la suivante :

  ... Dilib +                       $DILIB_BOTTOM
       |- init.sh                 en pratique, un lien vers le init.sh de la version courante
       +- V0.4 ...
       + ...                 les versions antérieures ou en test
       +- V0.6
       |   *- V0.6.0
       |   + ...
       |   *- V0.6.3
       |      +- V0.6.31  $DILIB_ROOT - la version courante
       |         +- Import            les sources 
       |         |    +...
       |         |    +- DilibMake   les outils de génération
       |         |    +- Data        les données importées -  deprecated voir ImportData
       |         |    +...
       |         +- Main              $DILIB - les bibliothèques et exécutables
       |         |    +- bin
       |         |    +- data          lien vers $DILIB_ROOT/Data 
       |         +- ImportData         répertoire d'importation pour les données Wicri
       |         +- Data               répertoire pour les données générées 
       |         +- TestImportData     répertoire intermédiaire pour l'importation des données deprecated
       |         +- TestData           répertoire de test deprecated
       |
       +- Bases
       +- ImportBases


Les 3 répertoires Import/Data, TestImportData et TestData ont été introduits en version V0.6.29.

Variables d'environnement

Dans une installation donnée, pour une version donnée la hiérarchie DILIB est contrôlée par 3 variables d'environnement : $DILIB_ROOT, $DILIB, $DILIB_IMPORT.

$DILIB_ROOT

$DILIB_ROOT désigne la base d'une installation.

$DILIB

Le répertoire $DILIB est la base de l'arborescence utilisable par l'utilisateur.

Pour des raisons de performances, plusieurs versions pourront être obtenues par compilation. A l'heure actuelle, une seule version est disponible : Main.

$DILIB_DATA

A partir de la version V0.6.40

Répertoire contenant les données de curation issues du réseau Wicri

$DILIB_IMPORT

$DILIB_BOTTOM

La variable $DILIB_BOTTOM repère la racine d'une installation Dilib.

$WICRI_ROOT

La variable $WICRI_ROOT désigne la racine de l'arborescence Wicri.

Fichiers d'initialisation

A partir de la version V0.6.34, 2 fichiers d'initialisation sont utilisés.

  • La fichier localisé à l'emplacement $DILIB/init.sh.
  • un fichier par utilisateur sur un site donné (ou sur un ordinateur personnel).

Gestion des données

Voir Dilib, gestion des données.

Le répertoire Data ($DILIB/data)

Le répertoire Data contient des données gérées sur le réseau Wicri.

Ce répertoire contient des ensembles de données utiles pour la curation ou la navigation. Il contient notamment les sous-répertoires suivants :

- $DILIB_ROOT
      +- Data
           +- Wicri --+- Canada
           |          |
           |          +- Musique
           +- Atilf

Outils concernées : DilibDataMkdir.sh

Les répertoires Bases et ImportBases

Le répertoire Bases est dédié aux données externes au réseau Wicri.

A l'heure actuelle, il est utilisé par le MeSH en français.

Voir aussi

Notes
  1. Cette possibilité n'est pas encore disponible.