Fichiers source du site web outils.biblissima.fr (Boîte à Outils Biblissima), construit à l'aide du générateur de sites Jekyll.
Le site Boîte à Outils Biblissima est développé par l'équipe Biblissima. Il contient notamment les interfaces web de deux outils de lemmatisation et de recherche dans des dictionnaires de langues anciennes :
- Collatinus-web, la version en ligne de Collatinus, le logiciel de lemmatisation et d'analyse morphologique de textes latins développé par Yves Ouvrard et Philippe Verkerk.
- Eulexis-web, un lemmatiseur de textes en grec ancien développé par Philippe Verkerk.
Après avoir récupéré le dépôt de code sur votre poste, vous pourrez :
- Utiliser Collatinus-web seul en mode hors-ligne
- Utiliser Eulexis-web seul en mode hors-ligne
- Installer et générer le site complet (plutôt destiné à l'équipe Biblissima)
Pour cloner ce dépôt :
git clone https://github.com/biblissima/outils.biblissima.fr
Un répertoire nommé outils.biblissima.fr est ainsi créé.
Il est possible d'obtenir une version autonome de Collatinus-web, sans recourir à Jekyll, et prête à l'emploi pour une utilisation locale sans connexion internet. Néanmoins, un certain nombre de dépendances sont requises et une connexion internet reste nécessaire lors de l'installation.
L'interface de Collatinus-web requiert :
- PHP
- Qt 5
- une instance du démon Collatinus-web qui tourne en local (à installer séparément, voir ci-dessous)
- les données linguistiques de Collatinus, placées au bon endroit : une partie des données est fournie avec le démon Collatinus-web, mais les dictionnaires sont à installer manuellement (voir instuctions ci-dessous)
Une fois PHP et Qt installés, il faut suivre les étapes suivantes pour avoir une instance fonctionnelle :
- Récupérer les sources du démon Collatinus (à placer dans un autre répertoire) :
git clone -b Daemon https://github.com/biblissima/collatinus.git
- Compiler le démon
cd collatinus
qmake -config release
make
- Télécharger l'archive contenant les dictionnaires et extraire les fichiers à la racine du répertoire
bin/data/dicos
cd bin/data
wget <to-do> -O - | tar -xz
- Lancer le démon Collatinus sur le port 5555
./bin/collatinusd
Une fois le démon lancé, lancer un serveur PHP de développement depuis la racine du répertoire outils.biblissima.fr :
php -S localhost:3000
Puis ouvrir la page de Collatinus-web : http://localhost:3000/collatinus-web/build
Il est possible d'obtenir une version autonome d'Eulexis-web, sans recourir à Jekyll, et prête à l'emploi pour une utilisation locale, sans connexion internet. Néanmoins, un certain nombre de dépendances sont requises et une connexion internet reste nécessaire lors de l'installation.
L'interface d'Eulexis-web requiert :
- PHP
- les données linguistiques d'Eulexis, à placer dans le répertoire
eulexis-web/data
- Télécharger l'archive contenant les données d'Eulexis et l'extraire dans
eulexis-web/data
cd eulexis-web
wget https://outils.biblissima.fr/resources/eulexis/data.tar.gz -O - | tar -xz
Vous pouvez aussi télécharger l'archive en suivant ce lien puis l'extraire manuellement à l'aide du logiciel de votre choix dans le répertoire eulexis-web.
- Lancer un serveur PHP de développement depuis la racine du répertoire
outils.biblissima.fr:
php -S localhost:3000
Puis ouvrir la page d'Eulexis-web : http://localhost:3000/eulexis-web/build
NB : cette section s'adresse en priorité aux développeurs du site.
Lire les instructions sur https://jekyllrb.com/docs/installation/.
Pour lancer un serveur de développement local et recharger le site à chaque changement dans les fichiers (watch mode), exécuter la commande suivante depuis le répertoire du dépôt :
jekyll serve watch
Pour consulter le site en local :
cd _site
php -S localhost:3000
cd outils.biblissima.fr
jekyll build --config=_config.yml,_config_prod.yml --trace --verbose
Le site est alors généré dans le répertoire _site.
jekyll build --config=_config.yml,_config_prod.yml,_config_collatinus-web.yml --trace --verbose
Les fichiers nécessaires à l'application sont situés dans le répertoire collatinus-web.
jekyll build --config=_config.yml,_config_prod.yml,_config_eulexis-web.yml --trace --verbose
Les fichiers nécessaires à l'application sont situés dans le répertoire eulexis-web.