Site Maven (Maven 3) génère dossier site vide

Question

Je tente de créer un site Maven de base en utilisant le plug-in du site Maven. Donc, j'ai ajouté à mon pom:

<reporting>
    <plugins>
        <!--JavaDoc setup-->
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-javadoc-plugin</artifactId>
            <version>2.7</version>
            <configuration>
                <defaultAuthor>Leon Blakey</defaultAuthor>
                <defaultVersion>${project.version}</defaultVersion>
                <links>
                    <link>http://download.oracle.com/javase/6/docs/api</link>
                </links>
            </configuration>
        </plugin>
    </plugins>
</reporting>

RAN mvn site --errors

[INFO] Error stacktraces are turned on.
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building pircbotx 1.3-SNAPSHOT
[INFO] ------------------------------------------------------------------------
[INFO]
[INFO] --- maven-site-plugin:2.0.1:site (default-site) @ pircbotx ---
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 2.688s
[INFO] Finished at: Wed Jan 12 18:08:00 EST 2011
[INFO] Final Memory: 5M/13M
[INFO] ------------------------------------------------------------------------
W:\programming\pircbot-hg>

Hmm, bizarre qu'il n'y a pas de sortie. Alors, quand je vérifie cible / site, son vide. Les seuls dossiers sont des images /, css / et WEB-INF /, rempli de quelques images génériques. Pas javadoc et pas de site.

est reproductible avec mvn site:site et mvn org.apache.maven.plugins:maven-site-plugin:2.2:site (apparemment maven ne veut utiliser 2.0.1 par défaut)

Ce qui est étrange est que je peux revenir à Maven 2.2.1 et générer avec succès un site. Mais quand je l'utilise 3.0.1-RC1 (qui arrive à venir avec Netbeans), il échoue.

Qu'est-ce que je fais mal qui rendrait le site plugin échouent dans 3.0.1 mais pas 2.2.1?

Answer 1

Peut-être que vous pouvez essayer d'utiliser 3.x Plugin Maven site . Vous pouvez le faire en ajoutant ce qui suit dans votre pom.xml

<build>
    ...
    <plugins>
        ...
        <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-site-plugin</artifactId>
            <version>3.0-beta-3</version>
        </plugin>
    </plugins>
</build>

Answer 2

Je faisais le même problème. J'ai trouvé un billet de blog sur le sujet.

Citant le blog (Souligné par l'auteur):

  

Si vous avez utilisé la section de déclaration du fichier pom.xml pour générer des paramètres de qualité de code, les rapports javadoc, et ainsi de suite, vous pouvez avoir un peu de travail à faire pour migrer cette fonctionnalité dans Maven 3. En effet, les rapports et les articles de reportSets ont été désapprouvés ( il ne causera pas une erreur avec Maven 3, il sera simplement ignoré ), et ont été remplacés par une section reportPlugins dans le bloc de configuration du maven-site- plugin lui-même.

Ignorant l'ancien <reporting> sans aucun avertissement à ce sujet désapprouvée semble un peu grossier, mais quand même ...

  

Alors, vous fondamentalement juste vos anciens plugins déplacez de rapports dans la section de configuration du nouveau-plugin maven-site.

section du maven-plugin-site explique qu'ils retirés de toute logique de rapports à partir du noyau de Maven pour « découpler le cœur de Maven Doxia et permettre des systèmes de rapports arbitraires à développer « . Fait sens.

Answer 3

L'utilisation du plug-in site ( http://maven.apache.org/plugins/maven-site- plugin / ) avec Maven 3 semble enfin être résolu. La version (non-bêta) a été libéré, et la possibilité d'utiliser la version 2 structure style <reporting> dans la déclaration pom.xml a été rajoutée.

Bien qu'il soit (comme d'habitude) difficile de naviguer dans la documentation importante, mais non organisé et qui se chevauchent sur les Maven 3 et le plug-in du site, une page - http://maven.apache.org/plugins/maven-site-plugin/maven-3.html - indique que le style ancien est maintenant recommandé sur la nouvelle "plugin sur le site plugin" style:

  

Remarque: Dans Maven 3, le nouveau format ne supporte pas l'héritage de configuration des plugins de rapport: voir MSITE-484. Ce format était techniquement nécessaire de supprimer la logique de rapports de Maven 3, mais un nouveau mécanisme d'héritage doit encore être ajouté à Maven 3 pour le rendre aussi flexible que l'ancien format. Ainsi, le nouveau format n'est pas prêt à être utilisé directement pour l'instant.

La page exemple http://maven.apache.org/plugins/ maven-plugin site / examples / configuration-reports.html pour la configuration des rapports ne mentionne même pas la méthode mise en forme "nouvelle".

Je ne sais pas si cela est sous forme de « meilleure pratique », mais un exemple de la section des rapports de pom qui travaille pour moi avec deux rapports supplémentaires est suit comme; sélectionnez vos propres plug-ins comme vous le souhaitez.

    ...
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-site-plugin</artifactId>
                <version>3.0</version>
          </plugin>
       </plugins>
    </build>

    <reporting>
        <plugins>

            <!-- Default Site Pages -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-project-info-reports-plugin</artifactId>
                <version>2.4</version>
            </plugin>

            <!-- Java Documentation -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-javadoc-plugin</artifactId>
                <version>2.8</version>
            </plugin>

            <!-- Source Code Cross-Reference -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-jxr-plugin</artifactId>
                <version>2.3</version>
            </plugin>
            ...
        </plugins>
    </reporting>

En aparté, si vous utilisez le plugin M2e dans Eclipse pour modifier votre POMs, vous pouvez utiliser la complétion de code dans la section version d'un plugin pour vous donner une liste de ses versions actuelles. Très pratique.