I am having difficulties getting the maven-javadoc-plugin to utilize my
custom stylesheet.
(I am new to Maven)
In pom.xml, I have:
<project>
...
<reporting>
<plugins>
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<reportSets>
<reportSet>
<id>html</id>
<configuration>
<stylesheetfile>${basedir}/src/main/javadoc/stylesheet.css</stylesheetfile>
<overview>${basedir}/src/main/javadoc/overview.html</overview>
...
</configuration>
</reportSet>
</reportSets>
</plugins>
</reporting>
...
</project>
----------------------
If I invoke
mvn clean site
my stylesheet file is utilized:
Building tree for all the packages and classes...
Generating
c:/ws/SofaCommonsMvn/target/site/apidocs\com/fsb/commons/configuration/\SofaConfiguration.html...
...
Copying file c:\ws\SofaCommonsMvn\src\main\javadoc\stylesheet.css to
file c:\ws\SofaCommonsMvn\target\site\apidocs\stylesheet.css...
...
Building index for all the packages and classes...
Generating
c:/ws/SofaCommonsMvn/target/site/apidocs\overview-tree.html...
Generating c:/ws/SofaCommonsMvn/target/site/apidocs\index-all.html...
Generating
c:/ws/SofaCommonsMvn/target/site/apidocs\deprecated-list.html...
Building index for all classes...
Generating
c:/ws/SofaCommonsMvn/target/site/apidocs\allclasses-frame.html...
Generating
c:/ws/SofaCommonsMvn/target/site/apidocs\allclasses-noframe.html...
Generating c:/ws/SofaCommonsMvn/target/site/apidocs\index.html...
Generating
c:/ws/SofaCommonsMvn/target/site/apidocs\overview-summary.html...
Generating c:/ws/SofaCommonsMvn/target/site/apidocs\help-doc.html...
----------------------
If I then invoke:
rm -rf target/site/apidocs ; mvn javadoc:javadoc
my stylesheet is NOT utilized:
Building tree for all the packages and classes...
...
Building index for all the packages and classes...
Generating
c:/ws/SofaCommonsMvn/target/site/apidocs\overview-tree.html...
Generating c:/ws/SofaCommonsMvn/target/site/apidocs\index-all.html...
Generating
c:/ws/SofaCommonsMvn/target/site/apidocs\deprecated-list.html...
Building index for all classes...
Generating
c:/ws/SofaCommonsMvn/target/site/apidocs\allclasses-frame.html...
Generating
c:/ws/SofaCommonsMvn/target/site/apidocs\allclasses-noframe.html...
Generating c:/ws/SofaCommonsMvn/target/site/apidocs\index.html...
Generating
c:/ws/SofaCommonsMvn/target/site/apidocs\overview-summary.html...
Generating c:/ws/SofaCommonsMvn/target/site/apidocs\help-doc.html...
Generating c:/ws/SofaCommonsMvn/target/site/apidocs\stylesheet.css...
Thoughts? Am I using these goals incorrectly?
J. Thomas Halliley
IT Architecture & Infrastructure Team
Flagstar Bank
This e-mail may contain data that is confidential, proprietary or
non-public personal information, as that term is defined in the
Gramm-Leach-Bliley Act (collectively, Confidential Information).
The Confidential Information is disclosed conditioned upon your
agreement that you will treat it confidentially and in accordance
with applicable law, ensure that such data isn't used or disclosed
except for the limited purpose for which it's being provided and
will notify and cooperate with us regarding any requested or
unauthorized disclosure or use of any Confidential Information.
By accepting and reviewing the Confidential information, you agree
to indemnify us against any losses or expenses, including
attorney's fees that we may incur as a result of any unauthorized
use or disclosure of this data due to your acts or omissions. If a
party other than the intended recipient receives this e-mail, he or
she is requested to instantly notify us of the erroneous delivery
and return to us all data so delivered.
