PDF generation

It is possible to generate a PDF document rather than an HTML site. You need to set the following command-line argument or configuration property:

• "outputType" set to "pdf"

Configuration

There are specific properties used for the document generation.

Syntax support

There is a limited level of support for the syntax in the pdf generation.

Custom CSS support

There is a limited level of support for the Custom StyleSheet in the pdf generation.

Support for Hand-written html articles

For the moment there is notsupport for the Hand-written html articles in the pdf generation.

Generation algorithm

By default the generator will generate:

• One introduction chapter with only the content of the index file
• One chapter for each category
• For each category, one sub-chapter for each article in the category. Each article will however be only in one chapter, even if it is in more than one category

It is possible to configure the structure of the PDF file by specifying the "chaptersContent" property. See PDF content specification.

Configuration

A few specific properties or arguments allow to specifically configure the generation for the PDF format:

• "fileName": The PDF file will be generated in the output directory. By default the name of the file will be "wiki.pdf", but this property allows to change the name of the file
• "docFile": the path of the PDF file. In that case the output directory will be the parent directory of this file
• "defaultChapter": the name of the default chapter, used for articles which belong in no category
• "chaptersContent": the path of an XML file allowing to configure much more precisely the structure of the PDF document. See PDF content specification.

Limitations

There are a few limitations compared to the HTML result:

• pre elements can't have colored background
• The font size of sentences can't be set
• resource elements don't link to their associated resource content
• Internal wikilinks on img elements are not taken into account
• Each article is only present in one category

Example

      java -jar docGenerator.jar -input=wiki/input -output=wiki/output -outputType=pdf

Example of generation with ant

   <java classname="org.docgene.main.DocGenerator">
      <arg value="-input=wiki/input"/>
      <arg value="-output=wiki/output"/>
      <arg value="-fileName=docGeneratorWiki"/>
      <arg value="-chaptersContent=docContent.xml"/>
      <arg value="-outputType=pdf"/>
      <classpath>
         <pathelement path="docGenerator.jar"/>
      </classpath>
   </java>