Marklet is a custom Java Doclet which aims to generate a Javadoc in a markdown format which is ready to use in GitHub. You can check a Marklet generated javadoc on the following project :
In order to use it with Maven, adds the following configuration for the maven-javadoc-plugin
in your project POM :
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>2.9</version>
<configuration>
<doclet>fr.faylixe.marklet.Marklet</doclet>
<docletArtifact>
<groupId>fr.faylixe</groupId>
<artifactId>marklet</artifactId>
<version>1.0.5</version>
</docletArtifact>
<reportOutputDirectory>./</reportOutputDirectory>
<destDir>./</destDir>
<additionalparam>-d javadoc/</additionalparam>
<useStandardDocletOptions>false</useStandardDocletOptions>
</configuration>
</plugin>This will generate the javadoc report into the project directory under subfolder javadoc/.
##Current issues
The current version is a pre release with the following feature missing :
- Interfaces, inner classes, enumerations, and annotations has not been tested already and subject to bug.
If you do notice any other error, do not hesitate to submit pull request, or indicates it to the Gitter channel.