docbkx-maven-plugin : 플러그인 실행 중 출력이 없습니다.

Question

소스 프로젝트에 대한 PDF 문서를 생성하기 위해 docbkx-maven-plugin을 설정했습니다. 상관없이 목표

<build> 
<plugins> 
<plugin> 
    <groupId>com.agilejava.docbkx</groupId> 
    <artifactId>docbkx-maven-plugin</artifactId> 
    <executions> 
     <execution> 
      <id>usersmanual</id> 
      <phase>generate-resources</phase> 
      <goals> 
       <goal>generate-pdf</goal> 
      </goals> 
      <configuration> 
       <includes>${basedir}/UserManual/*.xml</includes> 
       <includes>${basedir}/UserManual/src/*.xml</includes> 
           <targetDirectory>${project.build.directory}/UserManual</targetDirectory> 
       <chunkedOutput>true</chunkedOutput> 
      </configuration> 
     </execution> 
    </executions> 
</plugin> 
</plugins> 
</build> 

:

<build> 
<pluginManagement> 
    <plugins> 
     <plugin> 
      <groupId>com.agilejava.docbkx</groupId> 
      <artifactId>docbkx-maven-plugin</artifactId> 
      <version>2.0.14</version> 
      <dependencies> 
       <dependency> 
        <groupId>net.sf.docbook</groupId> 
        <artifactId>docbook-xml</artifactId> 
        <version>5.0-all</version> 
        <type>zip</type> 
        <classifier>resources</classifier> 
        <scope>runtime</scope> 
       </dependency> 
      </dependencies> 
     </plugin> 
    </plugins> 
</build> 
</pluginManagement> 

을 실제 프로젝트에서 내가 구성을 사용하지 다음의 DocBook 버전에 대한 참조가 사용으로 부모 치어에서 나뿐만 아니라 사용되는 버전을 지정 (들)을 지정했거나 제공 한 내용을 포함하면 플러그인은 아무런 (!) 작업도 수행하지 않습니다. 대상 디렉토리가 작성되지 않았으므로 명령 행에 의미있는 출력이 표시되지 않습니다. 결과는 다음과 같습니다.

[INFO] --- docbkx-maven-plugin:2.0.14:generate-pdf (usersmanual) @ documentation --- 
[INFO] 

Maven 3.0.3을 사용합니다.

무엇이 여기에 있습니까? 아직 제공되지 않은 구성이 있습니까? 플러그인이 일부 작업을 시작합니까?

업데이트 :

<plugin> <groupId>com.agilejava.docbkx</groupId> <artifactId>docbkx-maven-plugin</artifactId> <version>2.0.14</version> <dependencies> <dependency> <groupId>net.sf.docbook</groupId> <artifactId>docbook-xml</artifactId> <version>5.0-all</version> <type>zip</type> <classifier>resources</classifier> </dependency> </dependencies> <executions> <execution> <goals> <goal>generate-pdf</goal> </goals> <phase>prepare-package</phase> <configuration> <sourceDirectory>${project.basedir}/UserManual</sourceDirectory> <xincludeSupported>true</xincludeSupported> <includes>${project.basedir}/UserManual/UserManual.xml</includes> <includes>${project.basedir}/UserManual/**/*.xml</includes> <targetDirectory>${project.build.directory}/UserManual</targetDirectory> </configuration> </execution> </executions> </plugin> 

는 적어도 디렉토리 대상/Usermanual가 greated하게되지만 여전히 비어 : 이 내가 지금 가지고있는 것입니다. 출력이없는 이유는 무엇입니까? docbkx에서 의미있는 로그 파일을 얻을 기회가 있습니까? mvn ... -X는별로 말하지 않습니다.

Answer 1

최근 예제에는 유효한 구성이 아닌 두 가지 구성 옵션이 포함되어 있습니다.

필자가 권장하는 것은 이러한 모든 기본값을 무시하고 적어도 초기에는 docbook 소스 xml의 기본 위치를 그대로 사용하는 것을 중지하고 플러그인에 익숙해지고 어떤 변경 사항으로 인해 어떤 문제가 발생했는지 진단 할 수 있습니다.

어쨌든 <>은 < sourceDirectory>에 존재하는> 생성하려는 문서의 루트 xml 파일이어야합니다. 모두 xml 파일을 포함 할 필요가 없으며 사용법을 선언 했으므로 xincludes 방법을 따라야합니다. 이 메커니즘을 사용하여 여러 사용법을 검토하고 복사 할 수있는 프로젝트가 있습니다.

우리의 운명은 우리가 실체 등을 엉망으로 피하기 위해 받는다는 필터링 플러그인을 사용하기 때문에 https://github.com/jetty-project/jetty-documentation

우리는 좀 더 복잡한 사용법이있다. 최상위 수준의 DocBook 파일이 Index.xml 인 경우에 다시 얻는 것은, 사용을 포함 다음은 단순히 것 포함

<는이 Index.xml <는 />

어떤 식 또는 필요 globs와, 당신은 가져 오지 포함> 포함 xml :xi : include> 태그가있는 다른 xml 문서에서.

건배!