On 2010-07-01 18:11, Benjamin Wootton wrote: > Ah indeed it was the project/URL. I didn't realise that was actually used as > part of the site generation. Removing it from the default value fixes up the > links. > > Out of interest, is there any document that describes how the URL works in > relation to sites. The pom reference describes it as "a nice gesture" for the > project users.
AFAIK it is not documented. I'll add it to the Site Plugin FAQ, as this question pops up on this list from time to time. > > Thanks again > > Ben > > On 1 Jul 2010, at 16:56, Stephen Connolly <stephen.alan.conno...@gmail.com> > wrote: > >> well one assumes that you have correctly defined the /project/url parameter. >> >> there are a number of multi-module releases at apache and codehaus all of >> which deploy their site via >> >> mvn site-deploy >> >> or via mvn release:perform >> >> and I have not seen issues with the links in the deployed sites as long as >> the /project/url xml value has been correctly defined / omitted for each >> project in the multimodual build >> >> I have not tried with file:/// as a protocol onlt webdav via https:// [for >> the mojo ones] and scp [for the apache ones] >> >> It might help if you shared what version of maven and the maven-site-plugin >> you are using >> >> -Stephen >> >> On 1 July 2010 16:25, Benjamin Wootton <bswoot...@googlemail.com> wrote: >> >>> Hi Stephen >>> >>> I am talking about the deployed site - though I'm actually deploying to a >>> file:// URL on the same server. Would this make a difference over an scp? >>> >>> Thanks >>> Ben >>> >>> On 1 Jul 2010, at 16:05, Stephen Connolly <stephen.alan.conno...@gmail.com> >>> wrote: >>> >>>> On 1 July 2010 15:02, <benjamin.woot...@ubs.com> wrote: >>>> >>>>> I am experiencing the common problem of links broken in multi module >>>>> sites with parent pons >>>>> >>>>> I understand that* mvn site* builds individual module sites but doesn't >>>>> link them, and the* mvn site:deploy* should repair the links. The >>> latter >>>>> however doesn't happen. >>>>> >>>>> From here *http://maven.apache.org/plugins/maven-site-plugin/faq.html*< >>> http://maven.apache.org/plugins/maven-site-plugin/faq.html> >>>>> >>>>> *Why don't the links between parent and child modules work when I run >>> "mvn >>>>> site"?* >>>>> *What "mvn site" will do for you, in a multi-project build, is to run >>> "mvn >>>>> site" for the parent and all its modules individually. The links between >>>>> parent and child will not work here. They will however work when you >>>>> deploy the site. If you want to test this, prior to deployment, you can >>>>> run the **site:stage*< >>> http://maven.apache.org/plugins/maven-site-plugin/stage-mojo.html> >>>>> * goal as described in the **usage documentation*< >>> http://maven.apache.org/plugins/maven-site-plugin/usage.html> >>>>> * instead.* >>>>> >>>>> Indeed, if I do a mvn site:stage then the site is built with links in >>> place >>>>> from the parent to child. However, a mvn site:deploy fails. >>>>> >>>>> mvn clean site site:stage-deploy <-- Correct links >>>>> mvn clean site site:deploy <-- Incorrect links - all point at index.html >>>>> >>>> are you talking about the links on the deployed site or the links in the >>>> target/site folders on your local disk >>>> >>>> the links on the deployed (to remote server) should be correct >>>> >>>>> Any comments appreciated. Is this behaviour by design as I may >>>>> contribute a patch if not. >>>>> >>>>> Visit our website at http://www.ubs.com >>>>> >>>>> This message contains confidential information and is intended only >>>>> for the individual named. If you are not the named addressee you >>>>> should not disseminate, distribute or copy this e-mail. Please >>>>> notify the sender immediately by e-mail if you have received this >>>>> e-mail by mistake and delete this e-mail from your system. >>>>> >>>>> E-mails are not encrypted and cannot be guaranteed to be secure or >>>>> error-free as information could be intercepted, corrupted, lost, >>>>> destroyed, arrive late or incomplete, or contain viruses. The sender >>>>> therefore does not accept liability for any errors or omissions in the >>>>> contents of this message which arise as a result of e-mail transmission. >>>>> If verification is required please request a hard-copy version. This >>>>> message is provided for informational purposes and should not be >>>>> construed as a solicitation or offer to buy or sell any securities >>>>> or related financial instruments. >>>>> >>>>> UBS Limited is a company registered in England & Wales under company >>>>> number 2035362, whose registered office is at 1 Finsbury Avenue, >>>>> London, EC2M 2PP, United Kingdom. >>>>> >>>>> UBS AG (London Branch) is registered as a branch of a foreign company >>>>> under number BR004507, whose registered office is at >>>>> 1 Finsbury Avenue, London, EC2M 2PP, United Kingdom. >>>>> >>>>> UBS Clearing and Execution Services Limited is a company registered >>>>> in England & Wales under company number 03123037, whose registered >>>>> office is at 1 Finsbury Avenue, London, EC2M 2PP, United Kingdom. >>>>> >>>>> UBS reserves the right to retain all messages. Messages are protected >>>>> and accessed only in legally justified cases. >>>>> >>>>> >>>>> --------------------------------------------------------------------- >>>>> 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 >>> >>> > > --------------------------------------------------------------------- > To unsubscribe, e-mail: users-unsubscr...@maven.apache.org > For additional commands, e-mail: users-h...@maven.apache.org > > -- Dennis Lundberg --------------------------------------------------------------------- To unsubscribe, e-mail: users-unsubscr...@maven.apache.org For additional commands, e-mail: users-h...@maven.apache.org
