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. This plugin is made available through Sonatype and is synchronized with the central Maven repository.

Release

The current release version is 1.0.3, using jsdoc3 3.2.

Example POM: Recurse subdirectories only

<plugin>
    <groupId>com.github.phasebash</groupId>
    <artifactId>jsdoc3-maven-plugin</artifactId>
    <version>1.0.3</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</groupId>
    <artifactId>jsdoc3-maven-plugin</artifactId>
    <version>1.0.3</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</groupId>
    <artifactId>jsdoc3-maven-plugin</artifactId>
    <version>1.0.3</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.
• tutorialsDirectory (Optional) - File: A file indicating where jsdoc tutorial resources can be found.
• configFile (Optional) - File: A configuration file to be passed to jsdoc for more detailed project configuration.

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.