Hi,
I'm in the depths of generating a site for a hierarchy of projects and
have come across some issues. For the benefit of anyone trying something
similar and for background info, what I have done is
main
main/Beans
main/Beans/xdocs
main/Beans/xdocs/navigation.xml
main/App/
main/App/xdocs
main/App/xdocs/navigation.xml
main/xdocs
main/xdocs/navigation.xml
In the 2 sub-projects I have added a menu of the form
<menu name="Main Project">
<item name="[Main] Project" href="../../index.html"/>
<item name="App Project" href="../The Application/index.html"/>
</menu>
The plugin-generated main project pages automatically gets links down to
the sub-projects via the multiproject plugin, showing the sub-projects
in the side navigation bar. This menu above adds links back from the
sub-projects to the main in the side navigation bar (would be nice for
the multiproject to add this itself in a future release)
a). Personally I think that in the multiproject plugin, it would be
better to use project 'id' rather than 'name' in the generation of
directories under "docs/multiproject". The 'name' can be much longer,
whereas the id will be more concise and less likely to change - so for
example in my example above I could have just put 'App' instead of 'The
Application'.
b). The generation of the site seems to have changed in beta 10 (note
definite on this), but if i run a "maven site:generate" it does the
compile AFTER the javadoc. The only problem here is that I use xdoclet
to generate a series of interface classes, and hence these don't make
their way into the Javadoc since they are generated after the javadoc
(and hence javadoc complains about all sorts of missing classes). Seems
logical to change this so that it does a compile first of all ... any
problems with doing this ?
c). How do I get anything to appear under the "Project Info"->"Issue
Tracking" link ? Is there a section in project.xml for this ? (couldnt
find one).
d). Can I get rid of the "Development Process" link ? (I can change the
URL I know, but I want to remove it totally :-)).
[e. had to omit the main project from the multiproject generation
because of the bug spotted by Rafal Krzewski. - will be perfect when we
can enable this again, because at the moment it is ignoring generating
my own documentation for the top-level project].
TIA
--
Andy
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
