jsdoc3-maven-plugin

An automatic documentation generator for JavaScript within the Maven build lifecycle.

What is the jsdoc3-maven-plugin?

The jsdoc3-maven-plugin is a modern maven plugin built for the purposes of generating jsdoc along with the Maven build lifecycle. By default, the plugin will bind to the site phase, though this is configurable as with any other Maven plugin with goals.

Getting Started

The following examples enumerate the most common POM configurations for the jsdoc3-maven-plugin. Please note, this plugin will soon be available in Sonatype.

Example POM: Recurse subdirectories only

<plugin>
    <groupId>com.github.phasebash.jsdoc</groupId>
    <artifactId>jsdoc3-maven-plugin</artifactId>
    <version>${jsdoc3-maven-plugin.version}</version>
    <configuration>
        <recursive>true</recursive>
        <directoryRoots>
            <directoryRoot>${basedir}/src/main/webapp/resources/js</directoryRoot>
            <directoryRoot>${basedir}/src/main/javascript</directoryRoot>
        </directoryRoots>
    </configuration>
    <executions>
        <execution>
            <goals>
                <goal>jsdoc3</goal>
            </goals>
        </execution>
    </executions>
</plugin>

Example POM: Recurse subdirectories + errant files

<plugin>
    <groupId>com.github.phasebash.jsdoc</groupId>
    <artifactId>jsdoc3-maven-plugin</artifactId>
    <version>${jsdoc3-maven-plugin.version}</version>
    <configuration>
        <recursive>true</recursive>
        <directoryRoots>
            <directoryRoot>${basedir}/src/main/webapp/resources/js</directoryRoot>
            <directoryRoot>${basedir}/src/main/javascript</directoryRoot>
        </directoryRoots>
        <sourceFiles>
            <sourceFile>${baseDir}/src/main/resources/js/classic.js</sourceFile>
        </sourceFiles>
    </configuration>
    <executions>
        <execution>
            <goals>
                <goal>jsdoc3</goal>
            </goals>
        </execution>
    </executions>
</plugin>

Example POM: Cherry pick

<plugin>
    <groupId>com.github.phasebash.jsdoc</groupId>
    <artifactId>jsdoc3-maven-plugin</artifactId>
    <version>${jsdoc3-maven-plugin.version}</version>
    <configuration>
        <sourceFiles>
            <sourceFile>${baseDir}/src/main/resources/js/menu.js</sourceFile>
            <sourceFile>${baseDir}/src/main/resources/js/header.js</sourceFile>
            <sourceFile>${baseDir}/src/main/resources/js/content.js</sourceFile>
            <sourceFile>${baseDir}/src/main/resources/js/ads.js</sourceFile>
        </sourceFiles>
    </configuration>
    <executions>
        <execution>
            <goals>
                <goal>jsdoc3</goal>
            </goals>
        </execution>
    </executions>
</plugin>

Mojo Parameters

directoryRoots - File[]: An Array of Files which will be used as directory roots, any file within this directory will be included into the final jsdoc argument list.
recursive (Optional) - Boolean: A flag to indicate whether or not all directory roots should be searched and all files included recursively.
sourceFiles (Optional) - File[]: An Array of Files which will be included into the final jsdoc argument list.
outputDirectory (Optional) - File: The place where jsdoc should be written. default: "${project.build.directory}/site/jsdoc"
includePrivate (Optional) - Boolean: A flag to indicate whether @private symbols are included in the generated documentation.

Questions, Feedback?

Feel free to submit an issue ticket through github or contact me directly. I will help you.

License

The jsdoc3-maven-plugin has been released under Apache 2.0 as per all it's dependencies.

andrewdmay/jsdoc3-maven-plugin