Dilib Explor, Création d'un espace d'exploration

document en cours de mise au point - contenu non stabilisé Cette page est initialisée dans le cadre de la mise en place, sur Wicri/Informatique du Serveur d'exploration de la revue Génie logiciel

Cette page décrit les opérations nécessaires à la mise en place d'un espace d'exploration.

Espace d'exploration

Opérations préliminaires

Pour une application conséquente et pérenne, la création d'un espace de curation et d'exploration suppose un ensemble de choix et nomenclatures préalable :

• Définition d'une thématique à laquelle on donne un nom, exemples « Serveur d'investigation sur l'hypertexte » ou « Serveur d'exploration de la revue Génie logiciel »
• Définition d'un wiki de référence
• Choix d'un code pour identifier une instance de cet espace, exemple : "GénieLogV1". Pour une action conséquente, cette façon de faire permet notamment de conserver la trace des diverses versions.
• Sur le wiki de référence, introduire :
  • Une page d'introduction, destinée au public, exemple sur Wicri/Informatique la page Serveur d'exploration de la revue Génie logiciel,
  • Dans l'espace de nom Wicri de ce wiki,
    • un dossier technique (facultatif) On peut choisir un nom de dossier plus court, exemple Wicri:Génie logiciel (revue)
    • Une page d'introduction pour la première version (recommandée) avec le code associé exemple Wicri:GénieLogV1

Paramétrage

Le paramétrage se fait sur le wiki de référence. Voir un exemple sur Wicri/Informatique Wicri:Génie logiciel (revue)/Explorer, paramètres

Téléchargements

• sur la machine de développement, création d'un noyau de la hiérarchie de fichiers, exemple pour la revue :

mkdir GenieLogV1
mkdir GenieLogV1/Import

• télécharger les corpus et les déposer sous le répertoire Import.
• télécharger la page paramètre et la déposer sous le répertoire Import, avec le nom WicriParam.wiki, à l'aide de la commande WicriGetPage. Exemple, pour la revue Génie Logiciel.

WicriGetPage                                 \
         -l wicri-informatique.fr            \
         -p "Wicri:GénieLogV1/Paramètres" 
         > GenieLogV1/Import/WicriParam.wiki

Génération

La génération se fait en 3 étapes :

• Initialisation. Cette opération est réalisée à l'aide de la commande ExplorerAreaInit. Elle utilise les même options que l'import des paramètres, exemple :

ExplorerAreaInit                            \
       -l wicri-informatique.fr             \
       -p "Wicri:GénieLogV1/Paramètres"     \
       -d GenieLogV1

Cette commande crée un ensemble de fichiers de commandes shell qui permettent la suite de la génération.

• Création de l'espace des données. Cette étape utilise la commande générée de nom AreaCreateData.sh

sh GenieLogV1/bin/AreaCreateData.sh

• Création du site de navigation. Cette étape utilise la commande générée de nom AreaCreateSite.sh

sh GenieLogV1/bin/AreaCreateSite.sh

Reprises

Pour une reprise totale, on utilise la commande générée AreaReset.sh.

sh GenieLogV1/bin/AreaReset.sh

Puis on reprend les phases de génération si les paramètres ne sont pas modifiés.

La génération des données pouvant être longue des reprises partielles sont possibles. Par exemple, toujours sur GénieLogV1, une modification de la table des paramètres ne concernant que le site web donnera lieu à la reprise suivante :

WicriGetPage -l wicri-informatique.fr -p "Wicri:GénieLogV1/Paramètres" \
      > GenieLogV1/Import/WicriParam.wiki
sh GenieLogV1/bin/AreaResetParameters.sh
sh GenieLogV1/bin/AreaCreateSite.sh

Transfert

Création des fichiers d'exportation

l'exemple suivant donne la procédure à suivre (les 3 premières étapes varient en fonction des applications et de leur stade de développement Les autres sont générales).

cd GenieLogV1
rm Data.tar.gz
rm Site.tar.gz

tar -cvf Data.tar Data
tar -cvf Site.tar Site

gzip Data.tar
gzip Site.tar

Importation sur un autre site

cd GenieLogV1
gunzip Site.tar.gz
rm -rf Site/*
tar -xvf Site.tar

gunzip Data.tar.gz
rm -rf Data/*
tar -xvf Data.tar