Commit 818c25c4 authored by Marie Bisson's avatar Marie Bisson
Browse files

maj de la reunion

parent 073b4340
Loading
Loading
Loading
Loading
+0 −9
Original line number Diff line number Diff line
@@ -68,12 +68,6 @@ classDef default color:#274868, fill:#fff, stroke:#274868;
    
        => On retrouve la même organisation (dossier **ui**) de ces sous-dossiers pour la configuration d’une édition particulière (cf. ci-dessous [Le dossier projet-editions](#le-dossier-projet-editions))

        
|Nota Bene Julia|
|---------------|
|Je ne comprends pas très bien cette phrase. Une idée pour éclaircir ? |
|MB : on a modifié un peu (ag/sp/moi): est-ce lus clair ?|

* **package.json** : fichiers des dépendances Javascript,
* **max.xq** : « contrôleur »* RestXQ de MaX.

@@ -136,6 +130,3 @@ classDef default color:#274868, fill:#fff, stroke:#274868;
* **ui** : contient les dossiers pour les css, les xsl, le template html, les images, les polices, etc.,
* **xq** : contient les fichiers de requêtes spécifiques à l’édition.
|Nota Bene Julia|
|----------|
|Dans les fragments, on a que "accueil.frag.html" et "footer.frag.html"] par défaut ? J'ai aussi about.frag.html, contacts.frag.html et projet.frag.html (mais c'est peut-être un ajout manuel effectué après)|
+1 −4
Original line number Diff line number Diff line
@@ -40,11 +40,8 @@ MaX, pour Moteur d’Affichage XML, est un moteur d’affichage qui permet la c
 ![Alt text](/images/schemaMax.png)

 
|Nota bene Julia|
|---------|
|L'image ne s'affiche pas| 

Pour afficher une page d'une édition hébergée par MaX, le cœur applicatif de MaX se base sur l'URL interrogée. Celle-ci définit le contexte de configuration de base pour l'ensemble des traitements :
Pour afficher une page dune édition hébergée par MaX, le cœur applicatif de MaX se base sur lURL interrogée. Celle-ci définit le contexte de configuration de base pour lensemble des traitements :

* requêtage,
* transformation XSL,
+7 −28
Original line number Diff line number Diff line
@@ -13,13 +13,10 @@

Pour chaque projet, l’éditeur aura besoin : 

- d’une application BaseX pouvant être téléchargée [ici](https://basex.org/download/),
- d’une application BaseX (.zip) pouvant être téléchargée [ici](https://basex.org/download/),
- d’une instance de MaX hébergée [ici](https://git.unicaen.fr/pdn-certic/MaX),
- d’autant d’éditions que de *corpus* à traiter différemment du point de vue graphique (sommaire, logos, pages statiques, options d’affichage, etc.).

|Rq SP |
|----------|
|Ce serait bien de préciser pour Basex qu’il faut prendre le zip et non pas uniquement le .jar, non ?|

L’organisation recommandée est donc la suivante :

@@ -85,19 +82,14 @@ classDef default color:#274868, fill:#fff, stroke:#274868;
Télécharger : 

- FOP : [ici](https://files.basex.org/modules/org/basex/modules/fop/FOP.jar)
- Saxon9 : [ici](https://sourceforge.net/projects/saxon/files/Saxon-HE/9.9/)
- Saxon : [ici](https://sourceforge.net/projects/saxon/files/Saxon-HE/)

|Nota Bene|
|----------|
|Faut-il préciser quel zip il faut récupérer ? |
|Faut-il tester saxon 10 |
|Faut-il préciser que le dossier SaxonHE9-9-1-8J.zip permet de récupérer la version saxon9he.jar|
|Il faut récupérer la dernière version zippée ; la dézipper et copier-coller le jar he (home-edition).  |

|Rq SP |
|----------|
|Je pense que c’est utile de préciser|

1) Récupérer le code source de MaX
4) Récupérer le code source de MaX

`git clone https://git.unicaen.fr/pdn-certic/MaX.git` 

@@ -114,27 +106,19 @@ Si besoin de la version en développement, se placer sur la branche dev :

`cd projet-MaX/tools`

• si les ports de BaseX n’ont pas été modifiés

``./max.sh -i``

• si les ports de BaseX ont été modifiés (suivre les étapes 9 à 12 ci-dessous pour changer)

|Nota Bene MB |
|-------------|
|il y a un problème ici|

``./max.sh -p 1234 -i``


=> Si le message suivant s’affiche ``Please install BaseX or set $BASEX_PATH environment variable``,  il faut alors indiquer le chemin vers le **[Julia : dossier ?]** 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`

Ensuite refaire ``./max.sh -i`` ou ``./max.sh -p 1234 -i`` selon le changement ou pas des ports.
Ensuite refaire ``./max.sh -i`` .
Cela permet d'ajouter le dossier nodes_modules dans le dossier *projet*-MaX.

1) Créer un lien symbolique depuis BaseX (*projet*-basex) pointant vers MaX (*projet*-MaX)
7) Créer un lien symbolique depuis BaseX (*projet*-basex) pointant vers MaX (*projet*-MaX)

 
 ``cd ../../projet-basex/webapp``
@@ -175,8 +159,3 @@ S’il est nécessaire de configurer les ports de manière spécifique pour le p
``http://localhost:1234/max.html`` 
[1234 étant le numéro du port déclaré dans le fichier jetty.xml]

|Rq SP |
|----------|
|J’ai testé l’installation, j’ai des messages d’erreur : ``configuration.xml`` does not exist, à la place j’ai configuration.dist.xml. et erreur dans le rxq/config.xqm Line : 62 |
+7 −25
Original line number Diff line number Diff line
@@ -20,28 +20,24 @@ Il existe deux éditions de démonstration :

## Déploiement de l’édition de démonstration

Pour déployer l’édition de démonstration, il faut :


<img src="/images/demoTei.png" alt="édition de démonstration"/ style="border:1px solid #bbb; padding:0px;width:60%;margin-top:10px">

Pour déployer l’édition de démonstration, il faut :

1) Se placer en ligne de commande dans le dossier *tools* : 

`cd projet-MaX/tools`


=> Si le message suivant apparaît, ``Please install BaseX or set $BASEX_PATH environment variable`` (si la commande *basexclient* n’est pas déjà dans votre PATH), il faut alors indiquer le chemin vers le **[dossier ?]** BaseX au moyen de la commande suivante :


=> Si le message suivant apparaît, ``Please install BaseX or set $BASEX_PATH environment variable`` , il faut alors indiquer le chemin vers le dossier de l’application BaseX au moyen de la commande suivante :

`export BASEX_PATH=../../projet-basex`

|Rq SP |
|----------|
|pas très clair (pour moi ?) cette commande *basexclient* est présente dans quel PATH, quel fichier?|


1) Lancer l’outil de création d’une édition de démonstration **si utilisation du port par défaut de BaseX (1984)** 
2) Lancer l’outil de création d’une édition de démonstration **si utilisation du port par défaut de BaseX (1984)** 

`./max.sh -d`

@@ -81,17 +77,12 @@ Pour déployer une nouvelle édition, il faut:
`cd projet-MaX/tools`


=> Si le message suivant apparaît ``Please install BaseX or set $BASEX_PATH environment variable`` (si la commande *basexclient* n’est pas déjà dans votre PATH), il faut alors indiquer le chemin vers le **[dossier ?]** BaseX au moyen de la commande suivante :

=> Si le message suivant s'affiche ``Please install BaseX or set $BASEX_PATH environment variable`` (si la commande *basexclient* n'est pas déjà dans le PATH), indiquer alors le chemin vers le BaseX au moyen de la commande suivante :
=> Si le message suivant apparaît ``Please install BaseX or set $BASEX_PATH environment variable`` , il faut alors indiquer le chemin vers le dossier de l’application BaseX au moyen de la commande suivante :

|Nota BENE MB|
|------------|
il faut choisir une formulation et s’y tenir ;-)|

`export BASEX_PATH=../../projet-BaseX`

1) Création de la nouvelle édition **si utilisation du port par défaut de BaseX (1984)** 
2) Création de la nouvelle édition **si utilisation du port par défaut de BaseX (1984)** 
 
`./max.sh -n`

@@ -135,13 +126,8 @@ il faut choisir une formulation et s’y tenir ;-)|
         - Password : admin


=> Vous pouvez alors vous connecter en local à l’adresse : `http://localhost:[numero_de_port]/[edition]`

=> Se connecter en local à l’adresse : `http://localhost:[numero_de_port]/NOM_PROJET`
=> Se connecter en local à l’adresse : `http://localhost:[numero_de_port]/[edition]`

|Nota Bene MB|
|------------|
|alors on choisit une formulation|

Exemple : [http://127.0.0.1:8984/mon-edition](http://127.0.0.1:8984/mon-edition)

@@ -151,11 +137,7 @@ Les éditions (`max_tei_demo` ; ``mon-edition`` ; etc.) sont créées dans le do

Si vous suivez les recommandations d’organisation des dossiers décrites dans la partie [Recommandations d’architecture](../install#recommandations_architecture), vous pouvez déplacer chaque nouvelle édition créée dans le dossier *projet*-editions. Puis, en vous plaçant au moyen du terminal (ou de l’invite de commande) dans le dossier *editions* de *projet-MaX*, créez un lien symbolique entre ce dossier et l’édition qui se trouve dans le dossier *projet*-editions.

Si les recommandations d’organisation des dossiers décrites dans la partie [Recommandations d’architecture](../install#recommandations_architecture) sont suivies, chaque nouvelle édition créée peut être déplacée dans le dossier projet-editions. Puis en se plaçant au moyen du terminal (ou de l’invite de commande) dans le dossier *editions* de *projet-MaX* créer un lien symbolique entre ce dossier et l’édition qui se trouve dans le dossier projet-editions.

|Nota Bene MB|
|------------|
|alors on choisit une formulation|


``cd projet-MaX/editions``
+0 −12
Original line number Diff line number Diff line
@@ -37,7 +37,6 @@ graph LR;
    E("text_hook.xsl")
</div>

<<<<<<< HEAD
Les XSL des [plugins](../plugins) activés qui respectent la convention de nommage `plugins/[NOM_PLUGIN]/[NOM_PLUGIN].xsl` sont automatiquement appliquées.

|Nota Bene MB|
@@ -77,8 +76,6 @@ let $document := doc($dbPath || '/' || $doc)
return base-uri($document)

````
=======
>>>>>>> ag/doc

Le résultat de cette requête est ensuite transformé par la xsl : :

@@ -131,11 +128,7 @@ Pour les éléments plus complexes, comme l’affichage de certains éléments

## Alignement

<<<<<<< HEAD
Cette fonctionnalité permet la consultation d’un fragment en deux versions alignées. Chaque couple de fragments alignés doit respecter une nomenclature d’identification : `[prefixlang1][identifiant]` et `[prefixlang2][identifiant]`
=======
Cette fonctionnalité permet la consultation d’un fragment en deux versions alignées. Chaque couple de fragment alignés doit respecter une nomenclature d’identification : `[prefixlang1][identifiant]` et `[prefixlang2][identifiant]`. Les parties de texte qui sont à aligner doivent donc avoir un identifiant identique avec le préfixe de la langue. 
>>>>>>> ag/doc

```
Exemple : fr_p1 et lat_p1
@@ -153,12 +146,7 @@ graph LR;
    C("mon-edition_config_inc.xq")
</div>

<<<<<<< HEAD
Il faut alors préciser le document (attribut `@document`) ainsi
que les préfixes d’identifications utilisés (attributs `@first-prefix` et `@second-prefix`) dans les sources. 
=======
Il faut alors préciser le document (attribut `@document`) ainsi que les préfixes d'identifications utilisés (attributs `@first-prefix` et `@second-prefix`) dans les sources. L'attribut `@first-prefix` correspondant à la langue qui sera affichée en colonne de gauche.
>>>>>>> ag/doc

Par exemple :

Loading