So I have this:

<modules>
  <module>maven</module>
  <module>tools</module>
  <module>modules</module>
</modules>

And I was hoping the site generated from this top-level pom.xml would
contain links to the lower level modules.  It does not.

Actualy, the lower level modules do not have their own associated sites,
but sub-directories of these higher directories do.  Perhaps if I just
put dummy sites in the intermediate places I would get full linkage down
the stack.

I'll give that a try.

Thanks for the help.

John Wells (Aziz)
[EMAIL PROTECTED]


-----Original Message-----
From: Dennis Lundberg [mailto:[EMAIL PROTECTED] 
Sent: Friday, January 06, 2006 1:35 PM
To: Maven Users List
Subject: Re: [m2] site.xml documentation? How to create a site

John Wells wrote:
> So, I have a hierarchy of Maven builds.
> 
> I was hoping, that the site I generated from the top would contain
links
> to the sub-sites.  Looks like that does not happen by default, all I
get
> from the "top" layer is a site that is about the top layer pom (not
very
> interesting, really).
> 
> So I wondered:
> 
> OK, let me go a bit deeper.  Ah, I see, there is something called a
> site.xml that seems like it will let me do a bit more with the site.
> 
> Unfortunately, the documentation for this is non-existent.  It says it
> replaces the Maven 1.0 navigation.xml, but it doesn't give any
reference
> for it, or description of how it supposed to be used.

You are correct in this, documentation is sparse. The format is pretty 
much the same as for navigation.xml. You can have a look at this .mdo 
file from doxia that is used to understand the site.xml file:
 
http://svn.apache.org/viewcvs.cgi/maven/doxia/trunk/doxia-decoration-mod
el/src/main/mdo/decoration.mdo?rev=359931&view=markup

It reads pretty much like an xsd file.

> Is there anyway someone could help me?  Is there better documentation
> anywhere out there about "site.xml".  Is it the same format or
different
> from "navigation.xml"?  How do I get nice links to all the several
> sub-projects (and some of them have children too)?

Put this section into your top level pom.xml specifying the sub modules 
you want.

   <modules>
     <module>module-1</module>
     <module>module-2</module>
     ...
   </modules>

-- 
Dennis Lundberg

---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]


---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]

Reply via email to