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.
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.
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 :
