Merge branch 'mb/doc' into pdn/doc

    B-->B7

    B-->B8

    A-->C

    A1["mon-edition_config_inc.xml"]

    B1-->D3

    A1("mon-edition_config_inc.xml")

    B["ui"]

    B1["css"]

    B2["fonts"]

    B8["xsl"]

    D["fragments"]

    C["xq"]

    E["menu.xml"]

    D1["accueil.frag.html"]

    D2["footer.frag.html"]

    E("menu.xml")

    D1("accueil.frag.html")

    D2("footer.frag.html")

    D3("mon-edition.css")

</div>

* **mon-edition_config_inc.xml** : le fichier de configuration de l’édition qui permet de : 

    C["projet-editions"] 

</div>

<img src="../images/liensSymboliques.png" alt="liens symboliques" style="width:80%;" />

## Procédure

4) Ajouter les deux bibliothèques suivantes dans le dossier lib de basex :

1. saxon9he.jar pour utiliser les XSL, 

1. saxon*[9he]*.jar pour utiliser les XSL, 

2. FOP.jar pour générer les PDF avec XSL-FO. 

Pour les télécharger : 

6) Renommer le dossier MaX

(``cd ../``)    

``mv MaX projet-MaX``

Se placer au niveau du dessus en faisant ``cd ..`` 

Puis : ``mv MaX projet-MaX``

7) Initialiser MaX et installer des [dépendances*](../glossary/#i)

 ``cd ../../projet-BaseX/webapp``     

 `sudo ln -s ../../projet-MaX MaX` 

 `ln -s ../../projet-MaX MaX` 

En faisant un ``ls -l`` vous pouvez vérifier que votre lien symbolique a bien été créé :

    lrwxr-xr-x   1 anne  staff     9 11 mar 15:57 max -> ../../MaX

|Nota Bene |

|----------|

|Le sudo est-il obligatoire ?|

9) Lancer le serveur HTTP de BaseX

`cd ../../projet-BaseX/bin`    

`cd ../bin`    

`./basexhttp &`

=> Pour vérifier l’installation, consulter [http://localhost:8984/max.html](http://localhost:8984/max.html)

## Mise en page

Le template de mise en page par défaut se trouve dans **ui/templates/[tei ou ead].html**.

Il est possible de remplacer cette mise en page en créant son propre template dans `editions/[projectId]/ui/templates/template.html`.

|Nota Bene OVP|

|---------|

|Il y a aussi la méthode en ajoutant dans mon-edition\_config\_inc.xml un élément \<layout template="chemin-vers-mon-template"/> mais est-elle encore pertinente ?|

Il est possible de remplacer cette mise en page en créant son propre template dans `editions/[edition]/ui/templates/template.html`.

Le template contient des références à des variables qui seront remplacées par le contenu correspondant à l’affichage. Les paramètres disponibles sont : 

|---------|

|Je ne sais pas quel cas d’usage on a pour ce dernier paramètre.|

<br/>

Il peut être également pratique, dans certains cas, de faire référence à un template autrement nommé ou qui se trouve dans une autre édition. Dans ce cas, il est possible d’ajouter dans mon-edition\_config\_inc.xml un élément :

```

<template file="le/chemin/vers/le/templateCustomisé.html"/>

```

````xml

<!-- Exemple de template -->

`cd projet-MaX/tools`

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

=> 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`

> Renseigner le chemin complet vers le dossier où se trouvent les sources XML. 

      Exemple : /Users/nom/Documents/fichiersBaseX/tei/sources/

      Exemple : /Users/nom/Documents/fichiersbasex/tei/sources/

* Please type your BaseX login/password :

- **editions** ;

- **plugins** (quand ceux-ci sont activés).

Voir [Organisation des fichiers > le dossier projet-editions](../files#le-dossier-projet-editions)

```

<img src="images/ramusio.png" alt="alignement pour ramusio" style="width:80%; border:2px solid #bbb" />

<img src="../images/ramusio.png" alt="alignement pour ramusio" style="width:80%; border:2px solid #bbb" />

```xml