1

我正在使用PDFDocletwithmaven-javadoc-plugin并且我现在已经走了很长一段路。我的 maven 和 javadoc 配置几乎已经足够好了，但我现在的直接问题是我不知道如何将项目版本号推送到 PDF 标题页中。

在您通过告诉我使用 Maven<resource>过滤来回答我的问题之前，让我概述一下为什么这不起作用。

过滤的工作原理是从文件夹中的某个位置获取原始文件src，进行变量替换并将输出放入target文件夹中。

Javadoc 通过读取文件src/main/java和src/main/javadocAFAIK 将结果输出到target. 这意味着过滤对 Javadoc 没有用，因为它不会从target

我的结果表明，javadoc 注释中的任何 maven 变量都不会被替换。

我可以使用什么技巧将这些变量替换到 javadoc 中？

该解决方案不能涉及在 site:site 任务之后过滤 javadoc 输出，除非资源过滤适用于 PDF。

这是配置，FWIW：

  <plugin>
    <groupId>org.apache.maven.plugins</groupId>
    <artifactId>maven-javadoc-plugin</artifactId>
    <version>2.10.3</version>
    <configuration>
      <show>package</show>
      <docfilessubdirs>true</docfilessubdirs>
      <tags>
        <tag>
          <name>pdfInclude</name>
          <placement>X</placement>
          <head></head>
        </tag>
      </tags>
    </configuration>
    <reportSets>
      <reportSet>
        <id>PDF</id>
        <reports>
          <report>javadoc</report>
        </reports>
        <configuration>
          <name>PDF</name>
          <description>PDF doc</description>
          <destDir>pdf</destDir>
          <doclet>com.tarsec.javadoc.pdfdoclet.PDFDoclet</doclet>
          <docletPath>${basedir}/pdfdoclet/pdfdoclet-1.0.3-all.jar</docletPath>
          <useStandardDocletOptions>false</useStandardDocletOptions>
          <additionalparam>-pdf my_tech_doc-${project.version}.pdf
            -config ${basedir}/pdfdoclet/pdfdoclet.properties</additionalparam>
        </configuration>
      </reportSet>
    </reportSets>
  </plugin>

和pdfdoclet.properties：

    # http://pdfdoclet.sourceforge.net/configuration.html
    #
    #Lets the doclet print additional output in the console and to a logfile.
    debug=true 
    #Print "Author" tags
    author=false  
    #Print "Version" tags
    version=true
    #Print "since" tags
    tag.since=true
    #Create summary tables
    summary.table=false
    #Create hyperlinks
    create.links=true
    #Encrypt the PDF file
    encrypted=false
    #Allow printing of the PDF file
    allow.printing=true 
    #Create a bookmark frame
    create.frame=true
    #Print a title page
    api.title.page=true
    api.copyright=None
    api.author=Hansruedi
    #Enables the tag-based filter
    filter=true
    filter.tags=pdfInclude
    font.text.name=resources/arial.ttf
    page.orientation=portrait

-PDFDoclet特定api.*属性应该导致标题页作为 PDF 的第一页，但它不起作用。如果我在这里错过了一个技巧并且我可以制作该标题页，那么这也可能允许以某种方式解决这个问题。

4

1 回答 1

0

我意识到我可以使用 maven<resources>功能进行快速而肮脏的 hack：

  <resource>
    <directory>${basedir}/src/main/resources</directory>
    <targetPath>${basedir}/src/main/javadoc</targetPath>
    <filtering>true</filtering>
    <includes>
      <include>**/overview.html</include>
    </includes>
  </resource>

这会复制我的overview.html并过滤它，将其输出到javadoc源目录中。

肮脏的是，这个过滤后的版本可能会意外地受到版本控制，尽管使用svn我可以将它添加到ignore列表中。

于 2015-12-29T15:06:32.500 回答