Maven Website (Maven 3) erzeugt Baulücke Ordner

Question

Ich versuche, eine grundlegende Maven Site Plugin mit der Maven-Website zu erstellen. So habe ich das meinem 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>

Und 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, seltsam, dass es keinen Ausgang. Also, wenn ich überprüfen Ziel / site, seine leer. Die einzigen Ordner sind Bilder / CSS / und WEB-INF / mit einigen generischen Bildern gefüllt. Keine javadoc und keine Website.

Dies ist reproduzierbar mit mvn site:site und mvn org.apache.maven.plugins:maven-site-plugin:2.2:site (scheinbar Maven nur will 2.0.1 standardmäßig verwendet)

Was seltsam ist, dass ich zu Maven 2.2.1 zurückgehen kann und erfolgreich eine Website generieren. Aber wenn ich 3.0.1-RC1 (geschieht mit Netbeans kommen), scheitert es.

Was mache ich falsch, dass die Website machen würde Plugin 3.0.1 scheitert aber nicht 2.2.1?

Answer 1

Vielleicht können Sie versuchen, mit Maven Site-Plugin 3.x . Sie können das tun, indem Sie die folgenden in Ihrem pom.xml

Hinzufügen

<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

Ich habe das gleiche Problem. Ich fand einen Blog-Post über das Thema.

Zitiert den Blog (Hervorhebung von mir):

Wenn Sie den Berichtsabschnitt der pom.xml-Datei verwendet haben Code Qualitätsmetriken, javadoc Berichte zu generieren und so weiter, können Sie eine wenig Arbeit zu tun haben, diese Funktion in Maven zu migrieren 3. In der Tat, die Berichterstattung und reportSets Abschnitte wurden als veraltet ( es wird nicht Ursache eines Fehlers mit Maven 3, es wird einfach ignoriert werden ), und wurden von einem reportPlugins Abschnitt in der Konfigurationsblock des Maven-Site- ersetzt Plugin selbst.

Das Ignorieren des alten <reporting> ohne Vorwarnung über sie veraltet ist, scheint ein bisschen unhöflich, aber trotzdem ...

Sie sind also im Grunde nur Ihren alten Reporting Plugins in den Konfigurationsabschnitt der neuen Maven-Site-Plugin zu bewegen.

Abschnitt der maven-plugin-Website erklärt, dass sie alle Berichtslogik aus dem Kern von Maven entfernt „entkoppeln der Maven Kern aus doxia und willkürlichen Berichtssystemen zu ermöglichen, entwickelt werden.“ Das macht Sinn.

Answer 3

Die Nutzung der Website Plugin ( http://maven.apache.org/plugins/maven-site- plugin / ) mit Maven 3 scheint endlich gelöst zu werden. Die (nicht-beta) Version freigegeben wurde, und die Fähigkeit, die Version 2 Stil <reporting> Struktur in der pom.xml Anmeldung zu verwenden, wird wieder hinzugefügt.

Auch wenn es (wie üblich) schwierig ist, die wesentliche, aber unorganisiert und überlappenden Dokumentation über Maven 3 und die Website-Plugin, eine Seite zu navigieren - http://maven.apache.org/plugins/maven-site-plugin/maven-3.html - besagt, dass der alte Stil wird jetzt über die neuen empfohlen "Plugin Site Plugin" Stil:

Hinweis: In Maven 3, das neue Format nicht Bericht Plugins Konfigurationsvererbung: siehe MSITE-484. Dieses Format war technisch notwendige Berichtslogik von Maven 3, aber ein neuen Vererbungsmechanismus muss noch Maven 3 hinzugefügt werden, um sie zu entfernen, so flexibel wie das alte Format zu machen. So das neue Format ist für den direkten Einsatz vorerst nicht bereit.

Die Beispielseite http://maven.apache.org/plugins/ maven-Site-Plugin / examples / Konfiguration-reports.html Berichte zur Konfiguration die "neue" Formatierung Methode nicht einmal erwähnt.

Nicht sicher, ob dies in einer „best practice“ Form, sondern ein Beispiel pom Berichtsabschnitt, das funktioniert für mich mit ein paar zusätzlichen Berichte ist wie folgt; Wählen Sie Ihre eigenen Plug-in wie gewünscht.

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

Als Nebenwirkung Wenn Sie das M2e-Plugin in Eclipse bearbeiten Ihre POMs verwenden, dann können Sie die Code-Vervollständigung in der Version Abschnitt eines Plugins Sie eine Liste der aktuellen Versionen zu geben, verwenden. Sehr praktisch.