Code source et contenus de MACAO Legacy + code d'extraction et conversion semi-automatique des contenus.
Code source et contenus de MACAO Legacy.
Le code d'extraction et conversion semi-automatique des contenus est dans `tetras_extraction/script` avec [un README dédié](tetras_extraction/script/README.md)
Le nouveau projet basé sur Hugo est disponible ici : https://gitlab.tetras-libre.fr/macao/macao-hugo
Le nouveau projet basé sur Hugo est disponible ici : https://gitlab.tetras-libre.fr/macao/macao-hugo
@@ -9,21 +9,17 @@ Ensuite pour chaque shell, il est nécessaire de `source venv/bin/activate` avan
...
@@ -9,21 +9,17 @@ Ensuite pour chaque shell, il est nécessaire de `source venv/bin/activate` avan
de pouvoir lancer Python.
de pouvoir lancer Python.
```sh
```sh
python src/extract.py
python src/main.py
```
```
`extract.py` est le point d'entrée de l'extracteur, qui produit une représentation
`main.py` est le point d'entrée du processus de conversion complet, qui produit une arborescence de fichiers pour Macao-Hugo. Chacune des trois phases de conversion peut aussi être lancée séparément :
RDF des contenus textuels extraits de Macao12.
-`extract.py` -> Extraction des contenus textuels MACAO vers une représentation RDF/Turtle
Il accepte des paramètres sous forme de variables d'environnement:
-`transform.py` -> Transformation, notamment inférence sur RDFS, nettoyage HTML, identification des ressources liées (images, Flash...)
-`MACAO_ROOT`: Répertoire racine du dépôt.
-`export.py` -> Export vers le format Hugo+SurveyJS
Par défaut `"../../.."`
-`SOURCES_DIR`: Répertoire source Macao (celui avec le `imsmanifest.xml`)
Ces points d'entrée ne prennent pas d'arguments mais dépendent de quelques variables d'environnement. L'outil [`mcli`](../../mcli) s'en occupe, voir sa documentation sur le [wiki](https://gitlab.tetras-libre.fr/macao/macao-legacy/-/wikis/Extraction-et-CLI)(notamment la commande `setup-debug` qui permet de préparer un fichier `.env` pour les outils externes).
Par défaut `"../../../Basilisk/MACAO/macao_12"`
-`RESULTS_DIR`: Répertoire résultat de l'extraction
### Dépendances externes
Par défaut `"../result"`
La phase d'export utilise [Corese-Python](https://github.com/Wimmics/corese/blob/master/docs/corese-python/Corese-library%20with%20Python.md) via Py4j, et nécessite donc un environnement **Java 11**.
