Maven sitio (Maven 3) genera carpeta del sitio vacía

Question

Estoy intentando crear un sitio experto básica usando el plugin sitio experta. Así que he añadido esto a mi 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>

y corrió 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, extraño que no hay salida. Así que cuando compruebo objetivo / sitio, su vacío. Las únicas carpetas son imágenes /, css / y WEB-INF /, lleno de algunas imágenes genéricas. Sin javadoc y ningún sitio.

Este es reproducible con mvn site:site y mvn org.apache.maven.plugins:maven-site-plugin:2.2:site (aparentemente experto sólo quiere utilizar por defecto 2.0.1)

¿Cuál es extraño es que puedo volver a Maven 2.2.1 y generar con éxito un sitio. Pero cuando se utiliza 3.0.1-RC1 (que pasa a venir con Netbeans), falla.

¿Qué estoy haciendo mal que haría que el sitio plugin fracasan en 3.0.1 pero no 2.2.1?

Answer 1

Tal vez usted puede intentar usar Maven sitio plugin 3.x . Puede hacerlo añadiendo lo siguiente en su 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

Yo estaba teniendo el mismo problema. Me encontré con un entrada de blog sobre el tema.

Citando el blog (el énfasis es mío):

Si usted ha estado utilizando la sección de informes de la pom.xml para generar métricas de calidad de código, javadoc informes, y así sucesivamente, es posible que tenga un poco de trabajo por hacer para migrar esta característica en Maven 3. En efecto, la presentación de informes y secciones reportSets han quedado en desuso ( que no causa un error con Maven 3, se acaba de ser ignorado ), y han sido sustituidos por una sección reportPlugins en el bloque de configuración de la maven-sitio- propio plugin.

Haciendo caso omiso de la vieja <reporting> sin ninguna advertencia acerca de ser obsoleto parece un poco grosero, pero de todos modos ...

Por lo que están, básicamente, sólo moviendo sus viejos plugins de informes en la sección de configuración de la nueva experta en-sitio-plugin.

A sección del-plugin-sitio maven removidos de toda lógica de informes desde el núcleo de Maven "desacoplarse el núcleo Maven de Doxia y para permitir que se desarrollen los sistemas de notificación arbitrarias ". Tiene sentido.

Answer 3

El uso del Sitio Plugin ( http://maven.apache.org/plugins/maven-site- Programas / ) con Maven 3, finalmente parece estar resuelto. El (no beta) versión ha sido liberado, y la capacidad de utilizar la versión de la estructura <reporting> 2 estilo en la declaración pom.xml se ha añadido de nuevo.

A pesar de que es (como es habitual) difícil de navegar la documentación sustancial, pero no organizado y la superposición sobre Maven 3 y el plugin de sitio, una página - http://maven.apache.org/plugins/maven-site-plugin/maven-3.html - establece que el viejo estilo se recomienda ahora sobre la nueva "plugin al sitio plug-in" de estilo:

Nota: En Maven 3, el nuevo formato no soporta la herencia de configuración de los plugins de informes: ver MSITE-484. Este formato fue técnicamente necesario para eliminar la lógica de presentación de informes de Maven 3, pero un nuevo mecanismo de herencia aún necesita ser añadido a Maven 3 para que sea tan flexible como el formato antiguo. Por lo que el nuevo formato no está listo para su uso directo por ahora.

La página http://maven.apache.org/plugins/ experta en el lugar-plugin / ejemplos / configurar-reports.html para la configuración de los informes ni siquiera menciona el "nuevo" método de formateo.

No estoy seguro si esto es en una forma de "mejores prácticas", sino una sección de informes pom ejemplo que funciona para mí con un par de informes adicionales es el siguiente; elegir sus propios plugins según se desee.

    ...
    <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>

Como acotación al margen, si utiliza el plugin M2e en Eclipse para editar su POM, entonces usted puede usar el completado de código en la sección de versión de un plugin para darle una lista de sus versiones actuales. Muy práctico.