2011-12-29 2 views
2

우리 팀이 webservice 프로젝트를 진행하고 있으며 웹 서비스 API 문서를 만드는 중입니다. 필자는 사용자 정의 JavaDoc 도크 렛을 사용하여 사용 가능한 메소드의 두 xml 출력을 작성했습니다. 하나는 내부 개발자 용이고 다른 하나는 외부 개발자 용입니다.Jboss Maven JdocBook Plugin, Multiple Executions

이제 우리는 Jboss Maven Jdocbook 플러그인을 사용하여 다른 xml 파일과 함께 DocBook 출력을 만들어 웹 서비스 용 사용자 안내서를 작성합니다.

내가하고 싶은 일은 Maven JdocBook 플러그인을 두 번 (내부 메소드를 사용하고 외부 메소드에 한 번) 두 번 실행하면 내부 또는 외부 개발자를 위해 두 개의 서로 다른 master.xml 파일을 사용하여 두 개의 개별 사용자 안내서를 작성합니다. POM을 파일 :

<build> 
    <defaultGoal>generate</defaultGoal> 
    <plugins> 
    <plugin> 
     <groupId>org.jboss.maven.plugins</groupId> 
     <artifactId>maven-jdocbook-plugin</artifactId> 
     <extensions>true</extensions> 
     <goals> 
      <goal>generate</goal> 
     </goals> 
     <configuration> 
      <formats> 
       <format> 
       <formatName>html</formatName> 
       </format> 
       <format> 
       <formatName>html_single</formatName> 
       </format> 
      </formats> 
     </configuration> 
     <executions> 
      <execution> 
       <id>internal</id> 
       <phase>compile</phase> 
       <configuration> 
       <baseOutputDirectory>../../Test/JavaDocTest/internal/</baseOutputDirectory> 
       <sourceDocumentName>masterInternal.xml</sourceDocumentName> 
       </configuration> 
      </execution> 
      <execution> 
       <id>external</id> 
       <phase>compile</phase> 
       <configuration> 
       <baseOutputDirectory>../../Test/JavaDocTest/external/</baseOutputDirectory> 
       <sourceDocumentName>masterExternal.xml</sourceDocumentName> 
       </configuration> 
      </execution> 
     </executions> 
    </plugin> 
    <plugin> 
     <groupId>org.jboss.maven.plugins</groupId> 
     <artifactId>maven-jdocbook-style-plugin</artifactId> 
     <version>1.0.0</version> 
     <extensions>true</extensions> 
    </plugin> 
    </plugins> 

내가에서 실행하고 문제에 내가 (실행 섹션의 외부와 포맷의 섹션에서) 기본 구성에 sourceDocumentName을 넣어하지 않는 빌드가하는 것입니다 다른 소스 문서 이름을 인식하지 못합니다. 표준 마스터 파일은 master.xml이며, NetBeans에서 컴파일 할 때 master.xml이 존재하지 않으므로 찾을 수없고 생성을 건너 뜁니다.

위와 같이 여러 번 실행하여 빌드를 실행하려고하면 실행 섹션을 건너 뛰는 것처럼 보입니다. 실행 섹션을 건너 뛰는 이유는 무엇입니까?

나는 실행의 단계 태그와 관련이있을 것이라고 생각하지만 http://www.jboss.org/maven-jdocbook-plugin/에 따르면 프로세스 리소스, 컴파일, 패키지, 설치, 배포의 단계가 불과 며 모든 단계를 시도했습니다. 그들 중 누구도 일하는 것 같지 않습니다.
미리 감사드립니다.

+0

내 그룹은 주 구성 영역에 sourceDocumentName을 설정해야한다는 것을 알았습니다. docbook은 주 구성 섹션을 사용하여 한 번 생성 된 다음 다른 실행을 찾아 실행을위한 특정 하위 구성을 사용하여 실행합니다. 앞으로 도움이되기를 바랍니다. – sterbap1

답변

2

내 그룹은 주 구성 영역에 sourceDocumentName을 설정해야한다는 것을 알았습니다. docbook은 주 구성 섹션을 사용하여 한 번 생성 된 다음 다른 실행을 찾아 실행을위한 특정 하위 구성을 사용하여 실행합니다.

앞으로 도움이되기를 바랍니다.