The plugin is ignoring my directory src/main/javadoc/resources
I want to put in background images for my stylesheet to use, and I want to overwite inherit.gif (to one with a transparent background, a Java problem since I started with Java back before 1.0, sigh). So I put a bg.gif and a new inherit.gif in src/main/javadoc/resources. It is not copied. I do have <docfilessubdirs> set to true.
I have attached a subset of my project that demonstrates the problem. Unzip and then run mvn javadoc:javadoc. If you look at target/site/apidocs/resources, the file contains only one file, while src/main/javadoc/resources contains three.
Description
The plugin is ignoring my directory src/main/javadoc/resources
I want to put in background images for my stylesheet to use, and I want to overwite inherit.gif (to one with a transparent background, a Java problem since I started with Java back before 1.0, sigh). So I put a bg.gif and a new inherit.gif in src/main/javadoc/resources. It is not copied. I do have <docfilessubdirs> set to true.
I have attached a subset of my project that demonstrates the problem. Unzip and then run mvn javadoc:javadoc. If you look at target/site/apidocs/resources, the file contains only one file, while src/main/javadoc/resources contains three.
After a little more experimentation – the plugin seems only to be looking for files that might otherwise live in the java source tree – overview.html et al, and doc-files dirs. This seems overly restrictive – the reason for the doc-files subdir in a well-formed java source tree is to avoid intermixing the java source and doc files. By separating them out into a javadoc tree, you have already gotten away from this problem.
However, this still leaves me stymied without a way to add overall resources to the javadoc run, and especially without a way to override anything but the stylesheet (which is handled as a special case). I can work around my background image problem by putting it in a top-level doc-files dir, but I can't override inherit.gif that way. I should be able to set the resources dir. (Imagine, for example, a doclet that needed its own resource comparable to inherit.gif – where could it put it, how could it be supported in the plugin?)
Ken Arnold added a comment - 04/Sep/09 11:51 AM After a little more experimentation – the plugin seems only to be looking for files that might otherwise live in the java source tree – overview.html et al, and doc-files dirs. This seems overly restrictive – the reason for the doc-files subdir in a well-formed java source tree is to avoid intermixing the java source and doc files. By separating them out into a javadoc tree, you have already gotten away from this problem.
However, this still leaves me stymied without a way to add overall resources to the javadoc run, and especially without a way to override anything but the stylesheet (which is handled as a special case). I can work around my background image problem by putting it in a top-level doc-files dir, but I can't override inherit.gif that way. I should be able to set the resources dir. (Imagine, for example, a doclet that needed its own resource comparable to inherit.gif – where could it put it, how could it be supported in the plugin?)
After a little more experimentation – the plugin seems only to be looking for files that might otherwise live in the java source tree – overview.html et al, and doc-files dirs. This seems overly restrictive – the reason for the doc-files subdir in a well-formed java source tree is to avoid intermixing the java source and doc files. By separating them out into a javadoc tree, you have already gotten away from this problem.
However, this still leaves me stymied without a way to add overall resources to the javadoc run, and especially without a way to override anything but the stylesheet (which is handled as a special case). I can work around my background image problem by putting it in a top-level doc-files dir, but I can't override inherit.gif that way. I should be able to set the resources dir. (Imagine, for example, a doclet that needed its own resource comparable to inherit.gif – where could it put it, how could it be supported in the plugin?)