Ce fichier **menu.xml** permet d’ajouter autant d’onglets et sous-onglets qu’il est nécessaire.
Ce fichier *menu.xml* permet d’ajouter autant d’onglets et sous-onglets qu'il est nécessaire.
Ce fichier dont l’élément racine est `<menu>` contient un ou plusieurs éléments `<entry>`. L’élément ``<entry>`` contient un élément `<id>` pour indiquer l’identifiant et un élément `<target>` pour mentionner la cible, à savoir la fin de l’URL `nom.html`. L’élément `<target>` permet tout aussi bien de pointer vers :
@@ -32,8 +32,8 @@ L’attribut ``@type`` avec la valeur ``main`` est employé pour chaque entrée
Dans l’exemple ci-dessous, le menu contient deux entrées principales (attribut ``@type="main"``) : *accueil* et *sommaire*.
*``accueil.html`` pointe (généralement) vers le fragment HTML statique accueil.frag.html (cf. [supra](../home_page));
*``sommaire.html`` pointe vers la route qui permet de générer le sommaire d’un document (cf. [supra](../toc/#sommaire-dune-edition)).
**accueil.html* pointe (généralement) vers le fragment HTML statique accueil.frag.html (cf. [supra](../home_page));
**sommaire.html* pointe vers la route qui permet de générer le sommaire d’un document (cf. [supra](../toc/#sommaire-dune-edition)).
```
<menu>
@@ -50,12 +50,12 @@ Dans l’exemple ci-dessous, le menu contient deux entrées principales (attribu
Pour les sous-entrées, au sein de l’élément `<entry type="main">`, un ou plusieurs éléments `<entry>` sont ajoutés : chacun possède un identifiant `<id>` ainsi qu’une cible `<target>`.
Dans l’exemple ci-contre, le menu contient deux entrées principales *accueil* et *sommaire*. L’entrée *accueil* pointe vers l’URL `http://[host]:[port]/[edition]/accueil.html` et contient deux sous-entrées *introduction_oeuvre* et *presentation_oeuvre* dont les URL sont respectivement :
Dans l'exemple ci-contre, le menu contient deux entrées principales *accueil* et *sommaire*. L’entrée *accueil* pointe vers l’URL `http://[host]:[port]/[edition]/accueil.html` et contient deux sous-entrées *introduction_oeuvre* et *presentation_oeuvre* dont les URL sont respectivement :
L’entrée *sommaire* pointe vers l’URL `http://[host]:[port]/[edition]/sommaire.html`.
L’entrée *sommaire* pointe vers l'URL `http://[host]:[port]/[edition]/sommaire.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*]()../glossary/#i)), 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**[AG : à reformuler et à mettre dans le glossaire ?]**), 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,9 +127,9 @@ Ce fichier est construit à partir des identifiants que l’on a choisi dans le
```
###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/max_tei_demo/ui/xsl/menu_left.xsl** en **editions/max_tei_demo/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**.
Faire de même avec le template HTML, en renommant le fichier **editions/max_tei_demo/ui/templates/_template.html** en **editions/max_tei_demo/ui/templates/template.html**.
