This plugin generates xdoc documents from some basic HTML documentation which can then be styled by the xdoc goal to use a uniform CSS style and add the common navigation links etc.
This means that normal vanilla HTML can be used to create documentation using a WYSIWYG editing tool like Mozilla or MS FrontPage.
Most end user documentation only requires basic formatting (bold, italic, bullets) along with headings and images and links so using normal HTML for documentation with a WYSIWYG tool is a good idea.
The properties that allow you to customize the execution are documented here.
To enable HTML to xdoc conversion, either set the
maven.html2xdoc.enabled
property,
or add the following to your maven.xml
:
<preGoal name="xdoc:init"> <attainGoal name="html2xdoc"/> </preGoal>