Lors de la consultation d’une page d’une édition, MaX se base sur l’URL interrogée. C’est cette URL qui va permettre de déclencher un ensemble de traitements (de l’affichage d’une page HTML simple, au requêtage de la base de données XML pour générer une nouvelle page HTML *via* une transformation XSL).
L’URL contient systématiquement l’identifiant de l'édition consultée. Cet identifiant, en plus d’autres paramètres optionnels, permettent de construire le document adéquat, en s’appuyant également sur le fichier de configuration de l’édition (pour les options d’affichage ou l’utilisation des plugins par exemple).
L’URL contient systématiquement l’identifiant de l’édition consultée. Cet identifiant, en plus d’autres paramètres optionnels, permettent de construire le document adéquat, en s’appuyant également sur le fichier de configuration de l’édition (pour les options d’affichage ou l’utilisation des plugins par exemple).
Les principales URLs de consultation sont les suivantes :
@@ -37,7 +37,7 @@ Lors de la consultation d’un sommaire, d’un document ou d’un fragment, MaX
1. Requêtage XQUERY pour la récupération des données (liste de documents, document complet, fragment identifié, etc.).
2. Transformation de ces données en un contenu HTML par application de templates XSLT.
3. Création d'une page HTML complète (à partir d'un template HTML) contenant les données transformées, les blocs de navigation, menu, etc. ainsi que les imports CSS et Javascript nécessaires.
3. Création d’une page HTML complète (à partir d’un template HTML) contenant les données transformées, les blocs de navigation, menu, etc. ainsi que les imports CSS et Javascript nécessaires.
4. Exécution des éventuels plugins au sein du navigateur.
4) Ajouter les deux bibliothèques suivantes dans le dossier lib de basex :
@@ -115,15 +115,15 @@ Si besoin de la version en développement, se placer sur la branche dev :
=> Si le message suivant s’affiche ``Please install BaseX or set $BASEX_PATH environment variable``, il faut alors indiquer le chemin vers le dossier contenant l’application BaseX au moyen de la commande suivante :
`export BASEX_PATH=../../projet-basex`
`export BASEX_PATH=../../projet-BaseX`
Ensuite refaire ``./max.sh -i``.
Cela permet d'ajouter le dossier nodes_modules dans le dossier *projet*-MaX.
Cela permet d’ajouter le dossier nodes_modules dans le dossier *projet*-MaX.
8) Créer un lien symbolique depuis BaseX (*projet*-basex) pointant vers MaX (*projet*-MaX)
``cd ../../projet-basex/webapp``
``cd ../../projet-BaseX/webapp``
`sudo ln -s ../../projet-MaX MaX`
|Nota Bene |
@@ -132,7 +132,7 @@ Cela permet d'ajouter le dossier nodes_modules dans le dossier *projet*-MaX.
9) Lancer le serveur HTTP de BaseX
`cd ../../projet-basex/bin`
`cd ../../projet-BaseX/bin`
`./basexhttp &`
=> Pour vérifier l’installation, consulter [http://localhost:8984/max.html](http://localhost:8984/max.html)
@@ -82,7 +82,7 @@ L’entrée *sommaire* pointe vers l’URL `http://[host]:[port]/[edition]/somma
```
L’affichage du texte du menu est géré par un fichier de ressources d’internationalisation (appelé en développement logiciel i18n**[AG : à reformuler et à mettre dans le glossaire ?]**), qui permettra à termes de gérer l'adaptation de l'interface à des langues différentes.
L’affichage du texte du menu est géré par un fichier de ressources d’internationalisation (appelé en développement logiciel [i18n*]()../glossary/#i)), qui permettra à termes de gérer l’adaptation de l’interface à des langues différentes.
Ce fichier par défaut se trouve dans `[projet-]MaX/ui/i18n/I18n.xml`. Il peut être surchargé.
@@ -95,11 +95,11 @@ Trois paramètres sont disponibles dans cette XSL :
**projectId* : identifiant du projet,
**baseURI* : baseURI du projet,
**selectedTarget* : entrée de menu courante (valeur d'un des attributs @target).
**selectedTarget* : entrée de menu courante (valeur d’un des attributs @target).
### Fichier i18n
Pour surcharger le fichier i18n, il faut créer un dossier **ui** dans le dossier de l'édition, puis un dossier **i18n**, dans lequel est ajouté un fichier **I18n.xml**
Pour surcharger le fichier i18n, il faut créer un dossier **ui** dans le dossier de l’édition, puis un dossier **i18n**, dans lequel est ajouté un fichier **I18n.xml**
<divclass="mermaid">
graph LR;
@@ -112,10 +112,10 @@ graph LR;
D("I18n.xml")
</div>
Ce fichier est construit à partir des identifiants que l'on a choisi dans le fichier menu.xml.
Ce fichier est construit à partir des identifiants que l’on a choisi dans le fichier menu.xml.
```xml
<!-- Exemple d'un fichier I18n.xml -->
<!-- Exemple d’un fichier I18n.xml -->
<?xml version="1.0" encoding="UTF-8"?>
@@ -127,7 +127,7 @@ Ce fichier est construit à partir des identifiants que l'on a choisi dans le fi
```
###Menu à gauche
Pour configurer un menu à gauche dans la version de démonstration max_tei_demo, il est nécessaire d'activer la surcharge de transformation du menu en renommant le fichier **editions/demo_lorem/ui/xsl/menu_left.xsl** en **editions/demo_lorem/ui/xsl/menu.xsl**.
Pour configurer un menu à gauche dans la version de démonstration max_tei_demo, il est nécessaire d’activer la surcharge de transformation du menu en renommant le fichier **editions/demo_lorem/ui/xsl/menu_left.xsl** en **editions/demo_lorem/ui/xsl/menu.xsl**.
Faire de même avec le template HTML, en renommant le fichier **editions/demo_lorem/ui/templates/_template.html** en **editions/demo_lorem/ui/templates/template.html**.
