You are viewing a plain text version of this content. The canonical link for it is here.
Posted to users@maven.apache.org by "David C. Hicks" <dh...@i-hicks.org> on 2009/07/13 04:54:03 UTC
Examples of multi-module site generation?
Can anyone point me to anything that actually works? I've tried every
example I can find via Google (what few there are), and I cannot get the
modules to generate a link back to the parent project. Breadcrumbs
don't seem to behave, either. Maybe I'm an oddball and the only person
who doesn't know the absolute URL where my pages will reside, but I
would think that relative URLs would work.
Any help?
Thanks,
Dave
---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
For additional commands, e-mail: users-help@maven.apache.org
Re: Examples of multi-module site generation?
Posted by Roman Kournjaev <ko...@gmail.com>.
Yep , like stated in the mail before
On Mon, Jul 13, 2009 at 3:27 PM, Mohan KR <km...@gmail.com> wrote:
> Do you have the following element in your child modules site.xml?
>
> <menu ref="parent" />
>
>
> Thanks,
> mohan kr
>
> -----Original Message-----
> From: David C. Hicks [mailto:dhicks@i-hicks.org]
> Sent: Sunday, July 12, 2009 9:54 PM
> To: Maven Users
> Subject: Examples of multi-module site generation?
>
> Can anyone point me to anything that actually works? I've tried every
> example I can find via Google (what few there are), and I cannot get the
> modules to generate a link back to the parent project. Breadcrumbs
> don't seem to behave, either. Maybe I'm an oddball and the only person
> who doesn't know the absolute URL where my pages will reside, but I
> would think that relative URLs would work.
>
> Any help?
> Thanks,
> Dave
>
>
> ---------------------------------------------------------------------
> 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
>
>
RE: Examples of multi-module site generation?
Posted by Mohan KR <km...@gmail.com>.
Do you have the following element in your child modules site.xml?
<menu ref="parent" />
Thanks,
mohan kr
-----Original Message-----
From: David C. Hicks [mailto:dhicks@i-hicks.org]
Sent: Sunday, July 12, 2009 9:54 PM
To: Maven Users
Subject: Examples of multi-module site generation?
Can anyone point me to anything that actually works? I've tried every
example I can find via Google (what few there are), and I cannot get the
modules to generate a link back to the parent project. Breadcrumbs
don't seem to behave, either. Maybe I'm an oddball and the only person
who doesn't know the absolute URL where my pages will reside, but I
would think that relative URLs would work.
Any help?
Thanks,
Dave
---------------------------------------------------------------------
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
Re: Examples of multi-module site generation?
Posted by Jacob Robertson <ja...@gmail.com>.
Are you seeing this problem after running site:deploy, or are you seeing it
inside of target?
These links will only hook together properly after a site:deploy.
Re: Examples of multi-module site generation?
Posted by "David C. Hicks" <dh...@i-hicks.org>.
Hi Roman,
Thanks for the example, but I think I've already got that stuff
covered. Here is my sub-module site.xml...
<project name="Module A">
<version position="navigation-top"/>
<publishDate position="right"/>
<bannerLeft>
<name>Allure Global Solutions</name>
<href>http://www.allureglobal.com/</href>
</bannerLeft>
<body>
<menu ref="parent"/>
<menu name="Module A">
<item name="Overview" href="index.html"/>
</menu>
<menu ref="reports"/>
<menu ref="modules"/>
</body>
</project>
I have an index.apt file in the "apt" directory with the "Overview"
information. The breadcrumbing stuff is gone, for now. I never could
figure out how to make that work. It would create the breadcrumb trail
on the final page, but the links never pointed where I expected them
to. My main project site.xml looks very similar to the above.
Originally, I was counting on it being inherited by the modules, but I
created individual files and source trees after that failed to work out.
Jacob Robertson asked if I had deployed. Yes, and distribution
management set up to send it to a file: location. The pages all look
exactly as I would expect them to, except that I can not get a link back
to the parent from either of the modules, nor can I get breadcrumbing to
work. My real project only has one level of modules, so breadcrumbing
isn't as valuable. is the <menu ref="parent"/> that I can't get to play
nice.
<distributionManagement>
<site>
<id>sitetest.ihicks.org</id>
<name>Site Test</name>
<url>file:///Users/dhicks/Documents/workspace/test_site</url>
</site>
</distributionManagement>
This is a very simple test project with two modules. I set it up
because it takes about 12 to 15 minutes to generate the site for my real
project. I figured I could do something like this to help speed up the
"development" while I figure out how to get these things to work.
Thanks for the feedback guys.
Dave
Roman Kournjaev wrote:
> Hi Dave
>
> I dont think you are the only person that does not want to know the absolute
> URL of your pages, I think that absolutely OK. :-)
>
> Here is what i have that actually works sometimes and generates a parent
> link from the child projects.
> What you will have to do is to point the maven site plugin relatively to the
> following site.xml file
>
> <?xml version="1.0" encoding="UTF-8"?>
>
> <project name="DBWC">
> <bannerLeft>
> <name>Maven</name>
> <src>http://maven.apache.org/images/apache-maven-project.png</src>
> <href>http://maven.apache.org/</href>
> </bannerLeft>
> <bannerRight>
> <src>http://www.quest.com/images/common/quest_logo.gif</src>
> <href>http://www.quest.com/</href>
> </bannerRight>
> <body>
>
> <links>
> <item name="Apache" href="http://www.apache.org/" />
> <item name="Maven 1.x" href="http://maven.apache.org/maven-1.x/"/>
> <item name="Maven 2" href="http://maven.apache.org/"/>
> </links>
>
>
> <menu ref="parent" />
>
> <menu ref="modules" />
>
> <menu ref="reports" />
>
> </body>
>
>
> </project>
>
> The important thing there is the yellow colored link to the parent project.
>
> If you cant create a realive link to the that file , then just create a
> src/main/site directory in each of your projects and place this xml there
> too.
> Dont forget put the link to the site-plugin
>
> <plugin>
> <groupId>org.apache.maven.plugins</groupId>
> <artifactId>maven-site-plugin</artifactId>
> <version>2.0</version>
> <configuration>
> <port>9000</port>
>
> <tempWebappDirectory>${site.dir}/tempdir</tempWebappDirectory>
> <stagingSiteURL>${url.site}</stagingSiteURL>
> <siteDirectory>{relative_link}</siteDirectory>
> </configuration>
> </plugin>
>
> Frankly i still have sometimes problems with that configuration, I didn't
> figure it out when it does not work well, but there are some cases that it
> doesnt.
> Good Luck with that.. :-)
>
>
> On Mon, Jul 13, 2009 at 5:54 AM, David C. Hicks <dh...@i-hicks.org> wrote:
>
>
>> Can anyone point me to anything that actually works? I've tried every
>> example I can find via Google (what few there are), and I cannot get the
>> modules to generate a link back to the parent project. Breadcrumbs
>> don't seem to behave, either. Maybe I'm an oddball and the only person
>> who doesn't know the absolute URL where my pages will reside, but I
>> would think that relative URLs would work.
>>
>> Any help?
>> Thanks,
>> Dave
>>
>>
>> ---------------------------------------------------------------------
>> 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
Re: Examples of multi-module site generation?
Posted by Roman Kournjaev <ko...@gmail.com>.
Hi Dave
I dont think you are the only person that does not want to know the absolute
URL of your pages, I think that absolutely OK. :-)
Here is what i have that actually works sometimes and generates a parent
link from the child projects.
What you will have to do is to point the maven site plugin relatively to the
following site.xml file
<?xml version="1.0" encoding="UTF-8"?>
<project name="DBWC">
<bannerLeft>
<name>Maven</name>
<src>http://maven.apache.org/images/apache-maven-project.png</src>
<href>http://maven.apache.org/</href>
</bannerLeft>
<bannerRight>
<src>http://www.quest.com/images/common/quest_logo.gif</src>
<href>http://www.quest.com/</href>
</bannerRight>
<body>
<links>
<item name="Apache" href="http://www.apache.org/" />
<item name="Maven 1.x" href="http://maven.apache.org/maven-1.x/"/>
<item name="Maven 2" href="http://maven.apache.org/"/>
</links>
<menu ref="parent" />
<menu ref="modules" />
<menu ref="reports" />
</body>
</project>
The important thing there is the yellow colored link to the parent project.
If you cant create a realive link to the that file , then just create a
src/main/site directory in each of your projects and place this xml there
too.
Dont forget put the link to the site-plugin
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-site-plugin</artifactId>
<version>2.0</version>
<configuration>
<port>9000</port>
<tempWebappDirectory>${site.dir}/tempdir</tempWebappDirectory>
<stagingSiteURL>${url.site}</stagingSiteURL>
<siteDirectory>{relative_link}</siteDirectory>
</configuration>
</plugin>
Frankly i still have sometimes problems with that configuration, I didn't
figure it out when it does not work well, but there are some cases that it
doesnt.
Good Luck with that.. :-)
On Mon, Jul 13, 2009 at 5:54 AM, David C. Hicks <dh...@i-hicks.org> wrote:
> Can anyone point me to anything that actually works? I've tried every
> example I can find via Google (what few there are), and I cannot get the
> modules to generate a link back to the parent project. Breadcrumbs
> don't seem to behave, either. Maybe I'm an oddball and the only person
> who doesn't know the absolute URL where my pages will reside, but I
> would think that relative URLs would work.
>
> Any help?
> Thanks,
> Dave
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: users-unsubscribe@maven.apache.org
> For additional commands, e-mail: users-help@maven.apache.org
>
>