Quote from http://maven.apache.org/doxia/references/index.html
Add this to pom.xml
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-site-plugin</artifactId>
<version>3.2</version>
<dependencies>
<dependency>
<groupId>org.apache.maven.doxia</groupId>
<artifactId>doxia-module-markdown</artifactId>
<version>1.3</version>
</dependency>
</dependencies>
</plugin>
Then start adding pages under src/site/markdown/
with .md
extension.
For every page add menu item like in sniplet below:
<body>
<!-- http://maven.apache.org/doxia/doxia-sitetools/doxia-decoration-model/decoration.html
<item collapse=.. ref=.. name=.. href="README" img=.. position=.. alt=.. border=.. width=.. height=.. target=.. title=.. >
-->
<menu name="User guide">
<item href="README.html" name="README" />
</menu>
<menu ref="reports" inherit="bottom" />
</body>
Than use mvn site
to generate site.
Look at target/site
to review results.
mvn site:stage -DstagingDirectory=C:\TEMP\fullsite
to get multi-modular project site in one folder.
Read more about maven-site-plugin.
I recommend to use maven-fluido-skin. It is newest style, based on Twitter Bootstrap Add this to site.xml
<project name="xxx">
[...]
<skin>
<groupId>org.apache.maven.skins</groupId>
<artifactId>maven-fluido-skin</artifactId>
<version>1.3.0</version>
</skin>
[...]
</project>
See also https://github.com/winterstein/Eclipse-Markdown-Editor-Plugin