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.

Initialisation des pages de description et de paramétrage

Sur le wiki de référence, nous recommandons de créer 4 pages :

• Une page d'introduction, destinée au public,
  • exemple sur Wicri/Informatique la page Serveur d'exploration de la revue Génie logiciel,
  • exemple de page minimale en début de travail :

{{Wicri avertissement création lien}}
Cette page introduit ...
==Voir aussi==
;Éléments techniques : 
* [[Wicri:codeArea|codeArea]] ([[Wicri:codeArea/Paramètres, data|data]], [[Wicri:codeArea/Paramètres, fr|fr]])
[[Catégorie:Serveur d'exploration]]

• Dans l'espace de nom Wicri de ce wiki, une page dossier technique,
  • ayant pour nom Wicri:codeArea, exemple Wicri:GénieLogV1
  • Contenu initial :

Cette page introduit la partie technique d'un [[serveur d'exploration sur ...]] ...
* Pour le paramétrage voir : [[Wicri:codeArea/Paramètres, data]], [[Wicri:codeArea/Paramètres, fr]]

• Dans l'espace de nom Wicri de ce wiki, une page de paramétrage pour la génération des données
  • Contenu initial :

Cette page introduit les paramètres de construction des données 
de la version [[Wicri:codeArea|codeArea]] du [[Serveur d'exploration sur ...]].

Voir aussi :
* [[Wicri:codeArea]], dossier technique
* [[Wicri:codeArea/Paramètres, fr]], paramètres pour la navigation

• Dans l'espace de nom Wicri de ce wiki, une page de paramétrage pour la génération de l'interface

Cette page introduit les paramètres de la navigation en français de la version [[Wicri:codeArea|codeArea]] du [[serveur d'exploration sur ...]].

Voir aussi :
* [[Wicri:codeArea]], dossier technique
* [[Wicri:codeArea/Paramètres, data]], paramètres pour la génération des données

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.
• sur la page Wicri:codeArea, introduire un paragraphe Corpus pour documenter la sélection.

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é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 temps :

• 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 des sites de navigation. Ces opérations se réalisent en 2 étapes.

On 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

Signalement dans le réseau Wicri

Modèle Explor lien

Sur Wicri/Base, mettre à jour :

• wicri-base.fr:Modèle:Explor lien/Liste des Area
• wicri-base.fr:Modèle:Explor lien/Area
• wicri-base.fr:Modèle:Explor lien/Version