docbkx-maven-plugin非常慢

Question

我将现有的docbook项目从ANT（使用dopus框架）转移到docbkx-maven-plugin。 经过一些麻烦后，我得到了正确的输出，但是性能却很慢。 ANT 24sec完成了处理。 使用maven插件需要花费6分钟以上的时间。

处理似乎停止在：

[INFO] Processing input file: manual.xml
[DEBUG] Xerces XInclude mode entered
[DEBUG] User Customization provided: ...doc\src\main\custom-cfg\fo.xsl
[DEBUG] User Customization provided: ...doc\src\main\custom-cfg\fo.xsl
[DEBUG] User Customization provided: ...doc\src\main\custom-cfg\fo.xsl
[DEBUG] Configure the transformer.
[INFO] Applying customization parameters after docbkx parameters

之后，每个目标约2-3分钟没有输出（对于JavaHelp和PDF，我有2个目标）。 如果我停用xincludeSupported，它运行速度非常快，但是显然输出是无用的。

任何帮助加快构建过程的帮助将不胜感激。

这是pom文件中的config部分：

    <configuration>
      <sourceDirectory>src/main/docbook</sourceDirectory>
      <foCustomization>src/main/custom-cfg/fo.xsl</foCustomization> 
      <includes>manual.xml</includes>
      <xincludeSupported>true</xincludeSupported>
      <chapterAutolabel>true</chapterAutolabel>
      <sectionAutolabel>true</sectionAutolabel> 
      <sectionAutolabelMaxDepth>5</sectionAutolabelMaxDepth>
      <sectionLabelIncludesComponentLabel>true</sectionLabelIncludesComponentLabel>

      <preProcess>
        <copy todir="${project.build.directory}/docbkx/javahelp/resource">
          <fileset dir="src/main/docbook/resource/"/>
        </copy>
      </preProcess>
    </configuration>

Answer 1

经过研究，我找到了原因。 在xml文件中定义了doctype：

<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
          "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd"
  [
    <!ENTITY % entities SYSTEM "../custom-cfg/local-entities.xml">
    %entities;
  ]
>

该构建尝试为每个文件下载dtd，网络流量导致构建缓慢。 通过增加

            <dependency>
                <groupId>docbook</groupId>
                <artifactId>docbook-xml</artifactId>
                <version>4.5</version>
                <scope>runtime</scope>
            </dependency>

到我的docbkx-maven-plugin依赖项，我可以解决问题。 （此依赖关系对于不同的docbook版本是不同的，为此，还需要一个存储库条目，如http://docbkx-tools.sourceforge.net/docbkx-samples/manual.html#d5e28中所述 ）