Discussion :

[2000]

Hello,

Je souhaite generer un site pour un projet multimodule.

L'arborescence du projet se décompose ainsi :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
 
- aaa
     - mod1
     - mod2

- aaa est le projet principal. Il contient le pom.xml pere dont tous les sous composants heritent. il a un packaging pom
- mod1 et mod2 sont des modules enfants de aaa avec un packaging jar.

au niveau de la generation du site pour chaque module le path est celui par defaut à savoir mod1/target/site.

Lorsque je genere le site, le menu généré (grâce au <menu ref="modules"/> du site.xml) comporte automatiquement un lien sur les modules (cool) mais avec des liens invalides (uncool). Ainsi au lieu de générer le lien sur le module sur le chemin aaa/mod1/target/site/index.html, le lien généré est sur aaa/target/site/mod1/index.html.

J'ai donc contourné le problème en changeant :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
 
<menu ref="modules"/>

en

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
 
<menu name="modules">
   <item name="mod1" href="file:///${basedir}/mod1/target/src" />
</menu>

Ce qui est bien car ainsi le lien généré est correct. Le problème est que alors ce lien est hérité par les sites enfants.

Voici donc mes questions :
1 - Comment configurer mes site.xml parent/enfants pour que les liens sur les sous-modules générés automatiquement soient corrects ?
2 - Comment faire pour qu'un lien dans le site parent ne soit pas hérité dans le menu du site enfant ?

Merci de votre retour.

[romaintaz]

Bonjour,

Le problème que tu rencontres n'est pas vraiment un problème.
Quand tu construis le site pour un projet multimodules, tous les sites et sous sites vont se retrouver dans les répertoires projet/target/site. Du coup, les liens sont effectivement inopérants sur le site du projet parent.
Pour que tout fonctionne correctement, il faut déployer le site quelque part, grâce à la commande mvn site-deploy.

Tu définiras l'endroit où devra être déployé le site dans le pom.xml :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
3
4
5
6
7
8
9
...
    <distributionManagement>
        <site>
            <id>website</id>
            <url>
                ... (chemin où déployer le site)
            </url>
        </site>
    </distributionManagement>

[supermanu]

Si tu veux déployer ton site en local sur ton pc, tu peux faire :

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

1
2
 
mvn site:stage -DstagingDirectory=c:\dossierTemporaire

Et ainsi tu pourras tester facilement les liens

[rseM2]

Bonjour,

Pour information, il semble que ce soit mieux de déployer son site en local via la commande

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

mvn site:deploy -Dsite.deployment.url=file:pathToMyStagingDirectory

plutôt que par le staging

Code :

Sélectionner tout - Visualiser dans une fenêtre à part

mvn site:stage -DstagingDirectory=pathToMyStagingDirectory

En effet, le staging a parfois des comportements différents que le site:deploy et est donc moins sûr. Cf. Site staging versus local deploy.

Rémy

[2000]

Bonjour,

Merci pour le retour - le staging repond tout à fait à mon probleme.

Note : j'ai remarqué que le staging fonctionnait bien que si on lui donnait exlicitelment un staging directory. Dans le staging directory par defaut (staging) il n'aggrege pas les sites multi-modules.

En tout cas : merci !

[rseM2]

Bonjour,

Effectivement le staging fonctionne bien pour certains contextes mais malheureusement par pour tous. On a par exemple eu des différences avec l'internationalisation avec plusieurs langues.

Rémy