Discussion :

[sylsau]

Bonjour,

Je teste maven 2 depuis quelques jours et j'ai vu qu'il y avait la possibilité de générer un site permettant de regrouper la documentation du projet.

Mon projet a l'arborescence suivante :

- pom.xml (super POM)
- moduleA/ qui contient un pom.xml
- moduleB/ qui contient un pom.xml

Le contenu du super POM est le suivant :

Code :

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
 
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>fr.projet</groupId>
  <artifactId>projet</artifactId>
  <packaging>pom</packaging>
  <version>0.1</version>
  <name>Projet !</name>
 
  <modules>
	<module>moduleA</module>
	<module>moduleB</module>
  </modules>
 
  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>
  </dependencies>
 
<reporting>
  <plugins>
 
    <plugin>
      <!-- Javadoc du projet -->
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-javadoc-plugin</artifactId>
 
      <configuration>
        <minmemory>128m</minmemory>
        <maxmemory>512m</maxmemory>
      </configuration>
    </plugin>
 
     <!-- Source sur le site -->
              <plugin>
                  <groupId>org.apache.maven.plugins</groupId>
                  <artifactId>maven-jxr-plugin</artifactId>
              </plugin>
 
	  <plugin>
        <artifactId>maven-clover-plugin</artifactId>
      </plugin>
 
  </plugins>
</reporting>
 
 
</project>

Les fichiers pom des 2 modules ont à peu de choses près la même forme à savoir :

Code :

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
 
<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <artifactId>moduleA</artifactId>
  <packaging>jar</packaging>
  <name>Module A</name>
 
    <parent>
    <groupId>fr.projet</groupId>
    <artifactId>projet</artifactId>
    <version>0.1</version>
    <relativePath>../pom.xml</relativePath>
  </parent>
 
 
</project>

Lorsque je tape la commande mvn site, un site est bien généré. Un dossier target est crée dans le même répertoire que le super POM, mais également un dossier target pour chacun des modules définis dans ce super POM.

Lorsque j'affiche le site, dans la partie modules en haut à gauche, j'ai bien mes 2 modules qui apparaissent mais les liens vers lesquels ils pointent considèrent que les parties site du module auraient du être générées dans le dossier target du super POM.

Du coup le lien ne marche pas. Je pensais pouvoir corriger ça en bidouillant la balise url dans les pom de mes modules, cela marche mais n'est pas très propre je pense.

Y aurait il une meilleure façon de préciser les emplacements des dossiers contenant les parties sites de ces modules ou de les faire générer dans le dossier target du super POM ?

Merci d'avance de votre aide.

Sylvain

[cpuman_38]

Dans le cas de la génération du site d'un projet multi-modules, il te faut utiliser la commande

Code :

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

mvn site:stage -DstagingDirectory=C:\fullsite

--
Grégory

[tchize_]

site ne fait que générer la structure dans le target de chaque module. Ce sera stage (pour les essais) ou site:deploy qui regrouperont tout ces fichier dans une arborescence commune et navigable.

[romaintaz]

En effet, il faut utiliser mvn site:site site:deploy ou plus simplement mvn site-deploy pour déployer le site multi-modules de "façon correcte".