Living Documentation Maven Plugin
Objective
Use maven plugin to generate project documentation.
Glossary
- description
-
Generate a glossary document from code analysis :
-
the entry is a the name of a class marked with a specific annotation
-
the definition is the javadoc of this class
-
- mojo
-
glossary
Configuration
- annotation
-
the short name of annotation used to find glossary entries (default is
Glossary
) - format
-
the format of output document :
asciidoc
,html
(default ishtml
) - sources
-
the source folder to scan (default is
src/main/java
) - outputDirectory
-
the outpout directory (default is
target/generated-docs
)
Usage
/**
A little pet with a pv and hp
*/
@Glossary
public class Pokemon {
...
}
<plugin>
<groupId>io.github.livingdocumentation</groupId>
<artifactId>livingdoc-maven-plugin</artifactId>
<version>${plugin.livingdoc-maven-plugin.version}</version>
<executions>
<execution>
<id>glossary</id>
<phase>generate-resources</phase>
<goals>
<goal>glossary</goal>
</goals>
</execution>
</executions>
</plugin>
Word Cloud
- description
-
Generate a word cloud from code analysis :
-
the entry is a the name of a class marked with a specific annotation
-
the definition is the javadoc of this class
-
- mojo
-
wordcloud
Configuration
- sources
-
the source folder to scan (default is
src/main/java
) - outputDirectory
-
the outpout directory (default is
target/generated-docs
)
The plugin need the maven-remote-resources-plugin
to import html dependencies (js, css) for the doc.
Usage
<plugin>
<groupId>io.github.livingdocumentation</groupId>
<artifactId>livingdoc-maven-plugin</artifactId>
<version>${plugin.livingdoc-maven-plugin.version}</version>
<executions>
<execution>
<id>wordcloud</id>
<phase>generate-resources</phase>
<goals>
<goal>wordcloud</goal>
</goals>
</execution>
</executions>
</plugin>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-remote-resources-plugin</artifactId>
<version>1.5</version>
<configuration>
<resourceBundles>
<resourceBundle>io.github.livingdocumentation:shared-resources:${plugin.livingdoc-maven-plugin.version}</resourceBundle>
</resourceBundles>
<outputDirectory>target/generated-docs</outputDirectory>
</configuration>
<executions>
<execution>
<goals>
<goal>process</goal>
</goals>
</execution>
</executions>
</plugin>