Question

我设置了docbkx-maven-plugin来为源项目生成PDF文档。在父pom中，我指定了要使用的版本以及对要使用的docbook版本的引用：

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

在实际项目中，我使用配置：

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

无论我指定的目标或我提供的内容，插件都不会执行（！）操作。没有创建目标目录，我在命令行上看不到任何有意义的输出。结果如下：

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

至少目录target / Usermanual是greate，但它仍然是空的。为什么还没有输出？我是否有机会从docbkx获取有意义的日志文件？ mvn ... -X并不多见。

Answer 1

您的最新示例包含两个包含无效maven配置的配置选项。

我的建议是停止尝试覆盖所有这些默认设置并接受docbook source xml的默认位置，至少在您熟悉插件时可以诊断出哪些问题来自哪些更改。

无论如何，您的<includes>应该只是您尝试生成的文档的根xml文件，因为它存在于<sourceDirectory>中。您不需要包含所有的xml文件，而是需要遵循xincludes方法，因为您声明了它的用法。有许多使用此机制的项目可以查看和复制。

的用法

我们的是：https://github.com/jetty-project/jetty-documentation

由于我们使用maven过滤插件来避免不得不混淆实体等，因此我们有一些更复杂的用法。回到包含用法，如果您的顶级docbook文件是index.xml，那么您的包含只会是：

<includes>index.xml</includes>

不需要任何表达式或整体，您可以在需要时带有<xi:include>标记的其他xml文档。

docbkx-maven-plugin：插件运行期间没有输出

1 个答案: