You are viewing a plain text version of this content. The canonical link for it is here.
Posted to users@maven.apache.org by Geoffrey De Smet <ge...@gmail.com> on 2006/09/07 15:50:03 UTC

site.xml inheritence

Are there any examples of this available?

The docs doesn't show how to make a module site.xml "extend" from the 
parent project's site.xml.

-- 
With kind regards,
Geoffrey De Smet


---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org


Re: site.xml inheritence

Posted by Geoffrey De Smet <ge...@gmail.com>.
I 've found it! (finally)

Thanks for your svn references, they did it.


Apparently if the <url> tag in the parent pom is missing, the whole 
site.xml inheritence system is ignored. I made a jira (to either fix 
this or document it):
http://jira.codehaus.org/browse/MSITE-180


With kind regards,
Geoffrey De Smet


Geoffrey De Smet wrote:
> Are you using site-2.0-beta5 (the latest site plugin release)?
> I've been trying to replicate this behavior, but I am not succeeding.
> I even made a simple new project with one module, with no success.
> 
> With kind regards,
> Geoffrey De Smet
> 
> 
> Phil Steitz wrote:
>> Better links (specifying svn revision numbers, so links are stable)
>>
>>> Parent pom:
>>> http://svn.apache.org/repos/asf/jakarta/commons/trunks-sandbox/pom.xml
>> http://svn.apache.org/viewvc/jakarta/commons/trunks-sandbox/pom.xml?revision=437831 
>>
>>> Parent site.xml:
>>> http://svn.apache.org/repos/asf/jakarta/commons/trunks-sandbox/src/site/site.xml 
>>>
>> http://svn.apache.org/viewvc/jakarta/commons/trunks-sandbox/src/site/site.xml?revision=430908 
>>
>>> Child pom:
>>> http://svn.apache.org/repos/asf/jakarta/commons/sandbox/csv/trunk/pom.xml 
>>>
>> http://svn.apache.org/viewvc/jakarta/commons/sandbox/csv/trunk/pom.xml?revision=430702 
>>
>>> Child site.xml:
>>> http://svn.apache.org/repos/asf/jakarta/commons/sandbox/csv/trunk/src/site/site.xml 
>>>
>> http://svn.apache.org/viewvc/jakarta/commons/sandbox/csv/trunk/src/site/site.xml?revision=437546 
>>
>>
>> Phil


---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org


Re: site.xml inheritence

Posted by Geoffrey De Smet <ge...@gmail.com>.
Are you using site-2.0-beta5 (the latest site plugin release)?
I've been trying to replicate this behavior, but I am not succeeding.
I even made a simple new project with one module, with no success.

With kind regards,
Geoffrey De Smet


Phil Steitz wrote:
> Better links (specifying svn revision numbers, so links are stable)
> 
>> Parent pom:
>> http://svn.apache.org/repos/asf/jakarta/commons/trunks-sandbox/pom.xml
> http://svn.apache.org/viewvc/jakarta/commons/trunks-sandbox/pom.xml?revision=437831 
> 
>> Parent site.xml:
>> http://svn.apache.org/repos/asf/jakarta/commons/trunks-sandbox/src/site/site.xml 
>>
> http://svn.apache.org/viewvc/jakarta/commons/trunks-sandbox/src/site/site.xml?revision=430908 
> 
>> Child pom:
>> http://svn.apache.org/repos/asf/jakarta/commons/sandbox/csv/trunk/pom.xml
> http://svn.apache.org/viewvc/jakarta/commons/sandbox/csv/trunk/pom.xml?revision=430702 
> 
>> Child site.xml:
>> http://svn.apache.org/repos/asf/jakarta/commons/sandbox/csv/trunk/src/site/site.xml 
>>
> http://svn.apache.org/viewvc/jakarta/commons/sandbox/csv/trunk/src/site/site.xml?revision=437546 
> 
> 
> Phil


---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org


Re: site.xml inheritence

Posted by Phil Steitz <ph...@gmail.com>.
Better links (specifying svn revision numbers, so links are stable)

> Parent pom:
> http://svn.apache.org/repos/asf/jakarta/commons/trunks-sandbox/pom.xml
http://svn.apache.org/viewvc/jakarta/commons/trunks-sandbox/pom.xml?revision=437831
> Parent site.xml:
> http://svn.apache.org/repos/asf/jakarta/commons/trunks-sandbox/src/site/site.xml
http://svn.apache.org/viewvc/jakarta/commons/trunks-sandbox/src/site/site.xml?revision=430908
> Child pom:
> http://svn.apache.org/repos/asf/jakarta/commons/sandbox/csv/trunk/pom.xml
http://svn.apache.org/viewvc/jakarta/commons/sandbox/csv/trunk/pom.xml?revision=430702
> Child site.xml:
> http://svn.apache.org/repos/asf/jakarta/commons/sandbox/csv/trunk/src/site/site.xml
http://svn.apache.org/viewvc/jakarta/commons/sandbox/csv/trunk/src/site/site.xml?revision=437546

Phil

---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org


Re: site.xml inheritence

Posted by Phil Steitz <ph...@gmail.com>.
On 9/8/06, Geoffrey De Smet <ge...@gmail.com> wrote:
> I've already read that,
> there is no example of the child module's site.xml in there.
> I've been trying for ages to get the child module's site.xml to inherit
> the parent's site.xml (which is also the parent pom of it's own pom) and
> add a few links, with no luck.
>
Here is an example, which is in development and will likely change
(possibly to remove the site inheritence).  As of now, though, it does
illustrate how menus, links and style info can be inherited.

Parent pom:
http://svn.apache.org/repos/asf/jakarta/commons/trunks-sandbox/pom.xml
Parent site.xml:
http://svn.apache.org/repos/asf/jakarta/commons/trunks-sandbox/src/site/site.xml
Child pom:
http://svn.apache.org/repos/asf/jakarta/commons/sandbox/csv/trunk/pom.xml
Child site.xml:
http://svn.apache.org/repos/asf/jakarta/commons/sandbox/csv/trunk/src/site/site.xm

Installing or deploying the parent POM also deploys/installs the
parent site descriptor.  There is no reference to the parent in the
child site.xml.  Apparently, inheritance is triggered by the POM
dependency.  In the example, the child is not defined as a module of
the parent, but it used to be and that worked as well.  It could be
that in that case you need to do something like "mvn -N deploy" or
"mvn -N install" from the parent to get the parent descriptor
installed before building the child.

Style info, links and a menu are inherited in the example.  The inherited menu
<menu name="Commons" inherit="bottom">
uses the inherit attribute for positioning, as mentioned in the docs.

Phil

---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org


Re: site.xml inheritence

Posted by Nick Veys <ps...@gmail.com>.
The 'Inheritance' section is a child site.xml, though I have never
actually gotten what it says to do work. ;)

On 9/8/06, Geoffrey De Smet <ge...@gmail.com> wrote:
> I've already read that,
> there is no example of the child module's site.xml in there.
> I've been trying for ages to get the child module's site.xml to inherit
> the parent's site.xml (which is also the parent pom of it's own pom) and
> add a few links, with no luck.

---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org


Re: site.xml inheritence

Posted by Geoffrey De Smet <ge...@gmail.com>.
I've already read that,
there is no example of the child module's site.xml in there.
I've been trying for ages to get the child module's site.xml to inherit 
the parent's site.xml (which is also the parent pom of it's own pom) and 
add a few links, with no luck.

Phil Steitz wrote, On 2006-09-07 6:41 PM:
> On 9/7/06, Geoffrey De Smet <ge...@gmail.com> wrote:
>> Are there any examples of this available?
>>
>> The docs doesn't show how to make a module site.xml "extend" from the
>> parent project's site.xml.
> 
>>
> Have a look at the "inheritence" section in the site plugin howto:
> http://maven.apache.org/plugins/maven-site-plugin/howto.html
> As stated in the docs, when you publish the parent POM, the site
> descriptor is also published and available for inheritence, as long as
> the child inherits the parent POM.
> 
> Hope this helps.
> 
> Phil
>> -- 
> 
> 
>> With kind regards,
>> Geoffrey De Smet
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
>> For additional commands, e-mail: users-help@maven.apache.org
>>
>>

-- 
With kind regards,
Geoffrey De Smet


---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org


Re: site.xml inheritence

Posted by Phil Steitz <ph...@gmail.com>.
On 9/7/06, Geoffrey De Smet <ge...@gmail.com> wrote:
> Are there any examples of this available?
>
> The docs doesn't show how to make a module site.xml "extend" from the
> parent project's site.xml.

>
Have a look at the "inheritence" section in the site plugin howto:
http://maven.apache.org/plugins/maven-site-plugin/howto.html
As stated in the docs, when you publish the parent POM, the site
descriptor is also published and available for inheritence, as long as
the child inherits the parent POM.

Hope this helps.

Phil
> --


> With kind regards,
> Geoffrey De Smet
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
> For additional commands, e-mail: users-help@maven.apache.org
>
>

---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org