Dilib Explor, Création d'un espace d'exploration
Cette page décrit les opérations nécessaires à la mise en place d'un espace d'exploration.
Sommaire
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