How to customize "Overview" page in JavaDoc?

When you are using Maven and its plugin for JavaDoc:

Put a file named overview.html into folder src/main/javadoc and run the command mvn javadoc:javadoc; the JavaDoc files are written into folder target/site/apidocs.

This is also possible when you want to generate JavaDoc files for the Unit Tests: Put a file named overview.html into folder src/test/javadoc and run the command mvn javadoc:test-javadoc; the JavaDoc files are written into folder target/site/testapidocs.


You can create an overview HTML file and place it anywhere you like in your source tree. The convention is to call it overview.html and place it at the root of your tree, but you are certainly not obligated to do so. In fact, you can create multiple overview files for different purposes. When you generate your javadocs, you use the -overview flag and pass it the path to the target overview file.

You can find more information about overview file requirements here.

Tags:

Java

Javadoc