Maven 사이트 (Maven 3)가 빈 사이트 폴더를 생성합니다.

Question

maven 사이트 플러그인을 사용하여 기본 Maven 사이트를 만들려고합니다. 더 출력이 없다 이상한 것을,

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

을 그리고 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> 

흠을 실행 : 그래서 난 내 치어이 추가되었습니다. 그래서 내가 타겟/사이트를 체크 할 때 비어 있습니다. 유일한 폴더는 images /, css/및 WEB-INF /이며 일부 일반 사진으로 채워져 있습니다. javadoc 및 사이트 없음.

이 무슨 이상한 것은 제가 2.2.1을 받는다는 다시 가서 성공적으로 사이트를 생성 할 수있다 (분명히에만 기본적으로 2.0.1을 사용하고 싶어 받는다는)

mvn site:site 및 mvn org.apache.maven.plugins:maven-site-plugin:2.2:site로 재현. 그러나 3.0.1-RC1 (Netbeans과 함께 사용)을 사용하면 실패합니다.

사이트 플러그인을 3.0.1에서는 실패하지만 2.2.1에서는 실패하게 만드는 것은 무엇입니까?

Answer 1

아마도 Maven Site Plugin 3.x을 사용해보세요. 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

동일한 문제가있었습니다. 주제에 대해 blog post을 찾았습니다.

(강조 광산) 블로그를 인용 : 당신이 등 코드 품질 메트릭, javadoc의 보고서를 생성하고 pom.xml 파일의보고 섹션을 사용하고있는 경우

이

, 당신은 조금있을 수 있습니다 이 기능을 Maven 3으로 마이그레이션하는 작업. 실제로 reporting 및 reportSets 섹션은 더 이상 사용되지 않으며 (Maven 3에서는 오류가 발생하지 않고 단지으로 무시 됨) reportPlugins 섹션으로 대체되었습니다. maven-site-plugin 자체의 구성 블록에 있습니다. 이 사용되지 대한 경고없이 이전 <reporting>를 무시

조금 무례 보이지만, 어쨌든 ...

그래서 당신은 기본적으로 그냥 새의 구성 섹션에 이전보고 플러그인을 이동 maven-site-plugin.

A는 section of the maven-plugin-site 그들이 removed of all reporting logic from the core of Maven는 "Doxia에서 메이븐 코어를 분리하고 임의의보고 시스템이 개발 될 수 있도록."것을 설명 말이된다.

Answer 3

마지막으로 Maven 3에서 사이트 플러그인 (http://maven.apache.org/plugins/maven-site-plugin/)의 사용이 해결 된 것으로 보입니다. (비 베타) 버전이 릴리스되었으며 pom.xml 선언에 버전 2 스타일 <reporting> 구조를 사용할 수있는 기능이 다시 추가되었습니다.

Maven 3과 사이트 플러그인에 관한 실질적이지만 조직화되지 않은 중복 된 문서를 탐색하는 것은 어렵지 만 한 페이지 (http://maven.apache.org/plugins/maven-site-plugin/maven-3.html)에는 새 "플러그인 플러그인"에 대한 이전 스타일이 권장됩니다. "스타일 :

참고 : 메이븐 3, 새로운 형식의 보고서 플러그인 구성 상속을 지원하지 않습니다 MSITE-484을 참조하십시오. 이 형식은 Maven 3에서보고 논리를 제거하는 데 기술적으로 필요했지만 이전 형식만큼 유연하게 만들려면 Maven 3에 새로운 상속 메커니즘을 추가해야합니다. 따라서 새로운 형식은 현재 바로 사용할 수있는 상태가 아닙니다.

보고서 구성을위한 예제 페이지 http://maven.apache.org/plugins/maven-site-plugin/examples/configuring-reports.html에는 "새로운"형식 지정 방법이 언급되어 있지 않습니다.

이것이 "모범 사례"형식인지는 모르겠지만 몇 가지 추가 보고서로 나를 위해 작동하는 예제보고 섹션은 다음과 같습니다. 원하는대로 자신의 플러그인을 선택하십시오. 당신이 당신의 리딩을 편집 이클립스의 m2e 플러그인을 사용하는 경우 여담으로

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

는, 당신은 당신에게 현재 버전의 목록을 제공하는 플러그인의 버전 섹션에 코드 완성 기능을 사용할 수 있습니다. 매우 편리합니다.