Did you know...

The Maven Site plugin uses by default the apt format. Although it is a simple and straight forward format I personally prefer the Confluence markup and DocBook. Confluence I use for my personal Wiki and at various projects I use DocBook for the documentation.

Under the hood of the Maven site plugin runs the Doxia plugin. The documentation of the Site plugin is not really clear on this part. I stumbled on this some time ago.

By adding the appropriate doxia module as a dependency to the site plugin you can use the following formats:

Apt	Almost Plain Text	`doxia-module-apt`
Confluence	Confluence Enterprise Wiki	`doxia-module-confluence`
Simplified DocBook	Simplified DocBook XML Standard	`doxia-module-docbook-simple`
FML	FAQ Markup Language	`doxia-module-fml`
iText	iText PDF Library	`doxia-module-itext`
FO^*	XSL formatting objects (XSL-FO)	`doxia-module-fo`
LaTeX	LaTeX typesetting system	`doxia-module-latex`
Markdown^*	Markdown markup language	`doxia-module-markdown`
RTF	Microsoft Rich Text Format	`doxia-module-rtf`
TWiki	TWiki Structured Wiki	`doxia-module-twiki`
Xdoc	XML Documentation Format	`doxia-module-xdoc`
XHTML	Extensible Hypertext Markup Language	doxia-module-xhtml

Adding the following code snippet to you pom allows you to use the specified markup language for you site.

<pluginManagement>
  <plugins>
    <plugin>
      <groupId>org.apache.maven.plugins</groupId>
      <artifactId>maven-site-plugin</artifactId>
      <version>2.1.1</version>
      <configuration>
        <locales>en</locales>
      </configuration>
      <dependencies>
        <dependency>
          <groupId>org.apache.maven.doxia</groupId>
          <artifactId>doxia-module-confluence</artifactId>           <version>1.1.3</version>
        </dependency>
      </dependencies>
    </configuration>
  </plugin>
 </plugins>
</pluginManagement>