Re: Multi-module site generation?
Hi, just wondering if you were successful in the end as I'm facing a similar problem, cheers newton.dave wrote: --- On Fri, 9/12/08, Dave Newton lied: Running site-deploy works, as long as I define a file URI that isn't broken. Which I couldn't. Turns out site:deploy works just fine too (once the sites have been generated, I mean). Spoke too soon; I thought it had worked at one point but now the module links it's creating point to the parent POM directory + parent artifactId. Ah; removing *all* the url elements seems to have fixed it; I think my root POM's url messed up all the others. Curious; I'll look into it again tomorrow. Thanks again, Dave - To unsubscribe, e-mail: users-unsubscr...@maven.apache.org For additional commands, e-mail: users-h...@maven.apache.org -- View this message in context: http://old.nabble.com/Multi-module-site-generation--tp19466376p27026924.html Sent from the Maven - Users mailing list archive at Nabble.com. - To unsubscribe, e-mail: users-unsubscr...@maven.apache.org For additional commands, e-mail: users-h...@maven.apache.org
Re: Examples of multi-module site generation?
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
nameMaven/name
srchttp://maven.apache.org/images/apache-maven-project.png/src
hrefhttp://maven.apache.org//href
/bannerLeft
bannerRight
srchttp://www.quest.com/images/common/quest_logo.gif/src
hrefhttp://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
groupIdorg.apache.maven.plugins/groupId
artifactIdmaven-site-plugin/artifactId
version2.0/version
configuration
port9000/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 dhi...@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-unsubscr...@maven.apache.org
For additional commands, e-mail: users-h...@maven.apache.org
RE: Examples of multi-module site generation?
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:dhi...@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-unsubscr...@maven.apache.org For additional commands, e-mail: users-h...@maven.apache.org - To unsubscribe, e-mail: users-unsubscr...@maven.apache.org For additional commands, e-mail: users-h...@maven.apache.org
Re: Examples of multi-module site generation?
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?
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
nameAllure Global Solutions/name
hrefhttp://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
idsitetest.ihicks.org/id
nameSite Test/name
urlfile:///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
nameMaven/name
srchttp://maven.apache.org/images/apache-maven-project.png/src
hrefhttp://maven.apache.org//href
/bannerLeft
bannerRight
srchttp://www.quest.com/images/common/quest_logo.gif/src
hrefhttp://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
groupIdorg.apache.maven.plugins/groupId
artifactIdmaven-site-plugin/artifactId
version2.0/version
configuration
port9000/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 dhi...@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-unsubscr...@maven.apache.org
For additional commands, e-mail: users-h...@maven.apache.org
-
To unsubscribe, e-mail: users-unsubscr...@maven.apache.org
For additional commands, e-mail: users-h...@maven.apache.org
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-unsubscr...@maven.apache.org For additional commands, e-mail: users-h...@maven.apache.org
Re: Multi-module site generation?
On Fri, Sep 12, 2008 at 5:52 PM, Dave Newton [EMAIL PROTECTED] wrote:
Where should I look in TFM/TFW to find a canonical way for a multi-module
project to create a complete website including the modules?
Right now I've configured each module's site plugin's outputDirectory to
point at ../target/site/${artifactId} and set each modules's url to
${artifactId} but this feels hokey and wrong and makes me feel bad about
myself.
Should I just assemble the disparate module sites and get them to the final
site directory somehow?
What are you trying to do by setting those values? Preview it locally
before deploying it?
The site plugin builds each piece of the site under the module's
'target' directory, but the links won't work from there. You'll need
to deploy it somewhere for it to all work together. (I'd say stage
it, but I think some links are still broken using the stage-deploy
goal.)
--
Wendy
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
Re: Multi-module site generation?
--- On Fri, 9/12/08, Wendy Smoak wrote: What are you trying to do by setting those values? Preview it locally before deploying it? That was the initial goal, but it's likely the final site will be deployed to a local directory location on the CI machine. I've tried site:deploy with the following distributionManagement in the top-level POM in the hopes it would all get dumped to a directory in the parent site, but so far no joy; only the parent shows up. distributionManagement site urlfile://deployed-site/url /site /distributionManagement The parent and two module POMs are at http://pastebin.com/m1c8573cc. I'm assuming that there are multiple things wrong with what I'm doing (finally trying to figure out Maven) so any advice/criticisms/etc. are welcome. I also tried site:stage-deploy, which created the following hierarchy: target/staging/localhost/MultiModCli/... .../MultiModCore/... .../deployed-site/(the parent project) So I'd guess I'm just doing (one of many :) things all cow's legs up, 'cuz it's close. Thanks, Dave - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: Multi-module site generation?
On Fri, Sep 12, 2008 at 7:17 PM, Dave Newton [EMAIL PROTECTED] wrote: I've tried site:deploy with the following distributionManagement in the top-level POM in the hopes it would all get dumped to a directory in the parent site, but so far no joy; only the parent shows up. Try 'mvn site-deploy' instead, from a parent which has modules defined. It should work. http://maven.apache.org/guides/mini/guide-site.html (site-deploy is a lifecycle phase, while site:deploy means to run one specific goal of the site plugin.) (You may need an id for the site in distribution management. Wagon complained when I didn't have one...) -- Wendy - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: Multi-module site generation?
--- On Fri, 9/12/08, Wendy Smoak wrote: http://maven.apache.org/guides/mini/guide-site.html (site-deploy is a lifecycle phase, while site:deploy means to run one specific goal of the site plugin.) Oh. Hrm. Something new every day, and all that. Running site-deploy works, as long as I define a file URI that isn't broken. Which I couldn't. Turns out site:deploy works just fine too (once the sites have been generated, I mean). Sheesh :/ Thanks much, Dave - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: Multi-module site generation?
--- On Fri, 9/12/08, Dave Newton lied: Running site-deploy works, as long as I define a file URI that isn't broken. Which I couldn't. Turns out site:deploy works just fine too (once the sites have been generated, I mean). Spoke too soon; I thought it had worked at one point but now the module links it's creating point to the parent POM directory + parent artifactId. Ah; removing *all* the url elements seems to have fixed it; I think my root POM's url messed up all the others. Curious; I'll look into it again tomorrow. Thanks again, Dave - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
RE: About Multi-module site generation
Hi David, Have tried your menu ref=parent but seems it have nothing to do with the problem. It seems only create link to parent project in the 'inherited' project. I have also tried to add menu ref=modules and as I said before, no sub-module's link is included. Moreover, my top level project is not a parent project for inheritence, it is just a multi-module project. The reason I am trying to include the built artifact in the site is in fact I am trying to integrate with build server (Luntbuild). I want to put the build result in the provided directory. Is there really no way that I can build a full site (including the artifacts) for such purpose? If so I may need to find other way Thanks Adrian -Original Message- From: David Roussel [mailto:[EMAIL PROTECTED] Sent: Friday, August 29, 2008 11:29 PM To: users@maven.apache.org Subject: Re: About Multi-module site generation Adrian Shum wrote: 1) I tried to run mvn site , mvn clean install site and also mvn site:stage in myproj. The generated site in myproj only contains info on myproj. No link to sub-project under Module in the left panel. I have no special configuration in POM for the site generation. Do I need to do something to make an aggregated site? Try putting this in your site.xml: menu ref=parent inherit=bottom / For more info see: - http://maven.apache.org/plugins/maven-site-plugin/examples/sitedescripto r.html - http://www.sonatype.com/book/reference/site-generation.html Adrian Shum wrote: 2) Is that the built artifact will be put under the site? I have checked the target/site (or target/stage if I use site:stage), my JAR/WAR/EAR is not present in it. Do I need some configuration to achieve this? The built artifact is not put under target/site. If you run 'mvn install' your artifact will be in target, and if you run 'mvn deploy' it will be uploaded to your repo, if your pom is confifured correctly. See the manve book for more info. Thanks David -- View this message in context: http://www.nabble.com/About-Multi-module-site-generation-tp19217384p1922 2128.html Sent from the Maven - Users mailing list archive at Nabble.com. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED] This email is confidential. If you are not the intended recipient, please delete it from your system and notify the sender immediately. Any unauthorized use, disclosure, dissemination or copying of this email is prohibited. Taifook Securities Group, its group companies and their content providers (Parties) shall not be responsible for the accuracy or completeness of this email or its attachment, if any, which could contain virus, be corrupted, destroyed, incomplete, intercepted, lost or arrive late. The Parties do not accept liability for any damage caused by this email. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
About Multi-module site generation
Dear all, I am trying to use maven site feature for my multi-module project. Here is my project structure myproj/ + myproj-parent/ + myproj-main/ + myproj-web/ + myproj-ear/ There are 5 POMs in total. myproj/pom.xml is a simple POM which only define the 4 sub project as module. myproj-parent is the parent project (which defines dependencies management etc) for the other 3 project. myproj-main, myproj-web and myproj-ear is JAR, WAR and EAR project accordingly, and all of them inherit myproj-parent POM. 1) I tried to run mvn site , mvn clean install site and also mvn site:stage in myproj. The generated site in myproj only contains info on myproj. No link to sub-project under Module in the left panel. I have no special configuration in POM for the site generation. Do I need to do something to make an aggregated site? 2) Is that the built artifact will be put under the site? I have checked the target/site (or target/stage if I use site:stage), my JAR/WAR/EAR is not present in it. Do I need some configuration to achieve this? I am using maven 2.0.9. I have put pluginManagement in my POMs in order to use maven-site-plugin 2.0-beta-5, beta-6 and beta-7. All produce same result. Thanks Adrian This email is confidential. If you are not the intended recipient, please delete it from your system and notify the sender immediately. Any unauthorized use, disclosure, dissemination or copying of this email is prohibited. Taifook Securities Group, its group companies and their content providers (Parties) shall not be responsible for the accuracy or completeness of this email or its attachment, if any, which could contain virus, be corrupted, destroyed, incomplete, intercepted, lost or arrive late. The Parties do not accept liability for any damage caused by this email. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Re: About Multi-module site generation
Adrian Shum wrote: 1) I tried to run mvn site , mvn clean install site and also mvn site:stage in myproj. The generated site in myproj only contains info on myproj. No link to sub-project under Module in the left panel. I have no special configuration in POM for the site generation. Do I need to do something to make an aggregated site? Try putting this in your site.xml: menu ref=parent inherit=bottom / For more info see: - http://maven.apache.org/plugins/maven-site-plugin/examples/sitedescriptor.html - http://www.sonatype.com/book/reference/site-generation.html Adrian Shum wrote: 2) Is that the built artifact will be put under the site? I have checked the target/site (or target/stage if I use site:stage), my JAR/WAR/EAR is not present in it. Do I need some configuration to achieve this? The built artifact is not put under target/site. If you run 'mvn install' your artifact will be in target, and if you run 'mvn deploy' it will be uploaded to your repo, if your pom is confifured correctly. See the manve book for more info. Thanks David -- View this message in context: http://www.nabble.com/About-Multi-module-site-generation-tp19217384p19222128.html Sent from the Maven - Users mailing list archive at Nabble.com. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
Strange multi-module site generation problem with 2.0.9
I upgraded to Maven 2.0.9 this morning and later did a site-deploy of a multi-module project. Once the sites were deployed, I noticed that the sub-module sites didn't look right - they were missing navigation items. In my root src/site/site.xml, I have: project body menu ref=modules/ menu ref=reports/ /body /project And in each child: ?xml version=1.0 encoding=ISO-8859-1? project body menu name=Documentation item name=Introduction href=index.html/ item name=Classes Replaced href=classes_replaced.html/ /menu menu ref=reports / menu ref=parent/ /body /project When I do the site generation from the parent OR the child, the Introduction and Classes Replaced links aren't there, nor is the link to the parent. I rolled back to 2.0.8 and could not reproduce the issue. I have the site plugin configured in my POM to version 2.0-beta-6, so that should be a constant. Any ideas? Thanks, Justin -- View this message in context: http://www.nabble.com/Strange-multi-module-site-generation-problem-with-2.0.9-tp16757302s177p16757302.html Sent from the Maven - Users mailing list archive at Nabble.com. - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
RE: Strange multi-module site generation problem with 2.0.9
This is a problem with the beta-6 of the site plugin, try beta-5. -Original Message- From: justin_at_work [mailto:[EMAIL PROTECTED] Sent: Thursday, April 17, 2008 6:39 PM To: users@maven.apache.org Subject: Strange multi-module site generation problem with 2.0.9 I upgraded to Maven 2.0.9 this morning and later did a site-deploy of a multi-module project. Once the sites were deployed, I noticed that the sub-module sites didn't look right - they were missing navigation items. In my root src/site/site.xml, I have: project body menu ref=modules/ menu ref=reports/ /body /project And in each child: ?xml version=1.0 encoding=ISO-8859-1? project body menu name=Documentation item name=Introduction href=index.html/ item name=Classes Replaced href=classes_replaced.html/ /menu menu ref=reports / menu ref=parent/ /body /project When I do the site generation from the parent OR the child, the Introduction and Classes Replaced links aren't there, nor is the link to the parent. I rolled back to 2.0.8 and could not reproduce the issue. I have the site plugin configured in my POM to version 2.0-beta-6, so that should be a constant. Any ideas? Thanks, Justin -- View this message in context: http://www.nabble.com/Strange-multi-module-site-generation-problem-with- 2.0.9-tp16757302s177p16757302.html Sent from the Maven - Users mailing list archive at Nabble.com. - 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]
maven-site-plugin: multi-module site generation
Good afternoon, How can I create a full website for a project and its modules with the site-plugin? I've added the plugin to the build cycle in the parent project (pom packaging). When I generate the site using site:stage, only the site for the parent project is written to the staging directory. Although this website includes links to the child modules, the content behind those links is unavailable. The website are created though, in the resp. target directories of the modules, but they are not aggregated into the staging directory. Any thoughts? Cheers, Jo
Re: multi module site generation - module links not showing in index.html
Seconded. mvn site:stage generates a site where the submodule links work, but all the javadoc/jxr reports have blank index.html mvn site:deploy generates a site where the submodules are listed with strong tags, but no links, around them, however the actual submodule site content is properly generated. JA -- Jonathan S. Anderson -- [EMAIL PROTECTED] tel: 540.961.0229 (H) 540.818.2896 (C) www: http://andersoj.org/oddments pgp key: http://andersoj.org/personal/0xF0BE7EF8-pub.asc - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
multi module site generation - module links not showing in index.html
Wondering whether this is default behavior. When I generate the site for a multi module project the contained modules are displayed at the upper-left of the index.html page - but it is 'plain' text and no hyperlink. How come? - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
More multi-module site generation questions
I've got a multi-module project that is building properly, executing a number of reports (correctly) and then building the site. When I look at the target/site folder for each module, the information is correct. Folder layout is: + Main + Module1 + target + site + Module2 + target + site + target + site The problem I have is with the top level site. On the main project site, it contains links to the modules, but the link is to: Main/target/site/Module1/index.html while the files are actually in: Main/Module1/target/site/index.html Is there a setting I'm missing that will either combine the site docs or adjust the link? Thanks, -Sean __ Do You Yahoo!? Tired of spam? Yahoo! Mail has the best spam protection around http://mail.yahoo.com - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
