You are viewing a plain text version of this content. The canonical link for it is here.
Posted to users@maven.apache.org by Robert Wettergren <we...@gmail.com> on 2013/12/19 11:00:54 UTC

Maven PDF support

We have a need to archive site documentation (markdown) and Javadoc for
each release so I thought I'd generate these as pdf.
To my surprise this turned out to be really difficult.

The maven-pdf-plugin doesn't support markdown.
It's also unable to aggregate reports, like Javadoc, due to
http://jira.codehaus.org/browse/MPDF-48
The doxia-maven-plugin can produce pdf but requires new xml <book>
descriptors.
However, Doxia can only consume markdown through doxia-module-markdown and
that only extends the site plugin.
The site plugin doesn't generate pdf.

The maven javadoc plugin can produce pdf by configuring a doclet.
However, I have a requirement to inject the project version in the PDF and
none of the doclets I've tried (pdfdoclet, texdoclet and aurigadoclet) seem
able to do this without adding new configuration files.

There are currently two things I can't do:
1. Produce PDF from Markdown
2. Product PDF Javadoc containing the project version.

Does anybody know a way of doing these things?

Thanks,
Robert

Re: Maven PDF support

Posted by Markku Saarela <ma...@gmail.com>.
For me PDF plugin is working with Markdown:

         <plugin>
           <groupId>org.apache.maven.plugins</groupId>
           <artifactId>maven-pdf-plugin</artifactId>
           <version>1.2</version>
           <executions>
             <execution>
               <id>pdf</id>
               <phase>site</phase>
               <goals>
                 <goal>pdf</goal>
               </goals>
               <configuration>
<outputDirectory>${project.build.directory}</outputDirectory>
               </configuration>
             </execution>
           </executions>
           <dependencies>
             <dependency>
<groupId>org.apache.maven.doxia</groupId>
<artifactId>doxia-module-markdown</artifactId>
               <version>1.4</version>
             </dependency>
           </dependencies>
         </plugin>
       </plugins>
     </pluginManagement>

Cheers,

Markku

On 12/19/2013 12:00 PM, Robert Wettergren wrote:
> We have a need to archive site documentation (markdown) and Javadoc for
> each release so I thought I'd generate these as pdf.
> To my surprise this turned out to be really difficult.
>
> The maven-pdf-plugin doesn't support markdown.
> It's also unable to aggregate reports, like Javadoc, due to
> http://jira.codehaus.org/browse/MPDF-48
> The doxia-maven-plugin can produce pdf but requires new xml <book>
> descriptors.
> However, Doxia can only consume markdown through doxia-module-markdown and
> that only extends the site plugin.
> The site plugin doesn't generate pdf.
>
> The maven javadoc plugin can produce pdf by configuring a doclet.
> However, I have a requirement to inject the project version in the PDF and
> none of the doclets I've tried (pdfdoclet, texdoclet and aurigadoclet) seem
> able to do this without adding new configuration files.
>
> There are currently two things I can't do:
> 1. Produce PDF from Markdown
> 2. Product PDF Javadoc containing the project version.
>
> Does anybody know a way of doing these things?
>
> Thanks,
> Robert
>


---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org

Re: Maven PDF support

Posted by Markku Saarela <ma...@gmail.com>.
Hi,

At least I can produce PDF from Markdown:

        <plugin>
          <groupId>org.apache.maven.plugins</groupId>
          <artifactId>maven-pdf-plugin</artifactId>
          <version>1.2</version>
          <executions>
            <execution>
              <id>pdf</id>
              <phase>site</phase>
              <goals>
                <goal>pdf</goal>
              </goals>
              <configuration>

<outputDirectory>${project.build.directory}</outputDirectory>
              </configuration>
            </execution>
          </executions>
          <dependencies>
            <dependency>
              <groupId>org.apache.maven.doxia</groupId>
              <artifactId>doxia-module-markdown</artifactId>
              <version>1.4</version>
            </dependency>
          </dependencies>
        </plugin>
      </plugins>
    </pluginManagement>


Markku


2013/12/19 Robert Wettergren <we...@gmail.com>

> We have a need to archive site documentation (markdown) and Javadoc for
> each release so I thought I'd generate these as pdf.
> To my surprise this turned out to be really difficult.
>
> The maven-pdf-plugin doesn't support markdown.
> It's also unable to aggregate reports, like Javadoc, due to
> http://jira.codehaus.org/browse/MPDF-48
> The doxia-maven-plugin can produce pdf but requires new xml <book>
> descriptors.
> However, Doxia can only consume markdown through doxia-module-markdown and
> that only extends the site plugin.
> The site plugin doesn't generate pdf.
>
> The maven javadoc plugin can produce pdf by configuring a doclet.
> However, I have a requirement to inject the project version in the PDF and
> none of the doclets I've tried (pdfdoclet, texdoclet and aurigadoclet) seem
> able to do this without adding new configuration files.
>
> There are currently two things I can't do:
> 1. Produce PDF from Markdown
> 2. Product PDF Javadoc containing the project version.
>
> Does anybody know a way of doing these things?
>
> Thanks,
> Robert
>