Site:stage relativization against a variable URL

[Lennart Jörelid <le...@gmail.com>]

Good evening, all.

Today, maven-site-plugin performs its site:stage goal by copying the site
of a project into a staging directory, and relativizing some URLs. The
latter part is done by calculating the difference between the current
project's ${project.distributionManagement.site.url} and
the ${project.distributionManagement.site.url}  of the topmost parent pom,
retrieved from the current project.

The MSITE-699 patch (https://jira.codehaus.org/browse/MSITE-669) currently
introduces an optional parameter to permit relativizing the URLs in a
staged site against the ${project.distributionManagement.site.url} of the
reactor root pom instead. This flexibility simplifies site:stage for
nonstandard reactor layouts.

However - I believe it could be more powerful/flexible/desirable to simply
add an optional parameter to the site:stage goal with the desired root URL
(i.e. giving the users the ability to supply the effective site:stage root
URL as a [command line] configuration parameter). This would enable users
to create staged sites for parts of a reactor with relative ease - which
would be an improvement to the current site:stage goal.

It would certainly be a simple patch to supply.
What do you think?

--
+==============================+
| Bästa hälsningar,
| [sw. "Best regards"]
|
| Lennart Jörelid
| EAI Architect & Integrator
|
| Phone
| (skype):    jgurueurope
+==============================+

Re: Site:stage relativization against a variable URL

[Lennart Jörelid <le...@gmail.com>]

Patch created and attached to the JIRA.
Feedback would be appreciated.

Lukas: Could we please include this patch into the upcoming release of the
site plugin?
It would simplify/enable the generation of big documentation sites where
the reactor structure does not map to the [parent] inheritance structure.


2013/1/29 Lukas Theussl <lt...@apache.org>

>
> Lennart Jörelid wrote:
> > Good evening, all.
> >
> > Today, maven-site-plugin performs its site:stage goal by copying the site
> > of a project into a staging directory, and relativizing some URLs. The
> > latter part is done by calculating the difference between the current
> > project's ${project.distributionManagement.site.url} and
> > the ${project.distributionManagement.site.url}  of the topmost parent
> pom,
> > retrieved from the current project.
> >
> > The MSITE-699 patch (https://jira.codehaus.org/browse/MSITE-669)
> currently
> > introduces an optional parameter to permit relativizing the URLs in a
> > staged site against the ${project.distributionManagement.site.url} of the
> > reactor root pom instead. This flexibility simplifies site:stage for
> > nonstandard reactor layouts.
> >
> > However - I believe it could be more powerful/flexible/desirable to
> simply
> > add an optional parameter to the site:stage goal with the desired root
> URL
> > (i.e. giving the users the ability to supply the effective site:stage
> root
> > URL as a [command line] configuration parameter). This would enable users
> > to create staged sites for parts of a reactor with relative ease - which
> > would be an improvement to the current site:stage goal.
> >
> > It would certainly be a simple patch to supply.
> > What do you think?
>
> This would be a more general solution than the current MSITE-699, sounds
> reasonable to me.
>
> -Lukas
>
> >
> > --
> > +==============================+
> > | Bästa hälsningar,
> > | [sw. "Best regards"]
> > |
> > | Lennart Jörelid
> > | EAI Architect & Integrator
> > |
> > | Phone
> > | (skype):    jgurueurope
> > +==============================+
> >
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: dev-unsubscribe@maven.apache.org
> For additional commands, e-mail: dev-help@maven.apache.org
>
>


-- 

--
+==============================+
| Bästa hälsningar,
| [sw. "Best regards"]
|
| Lennart Jörelid
| EAI Architect & Integrator
|
| jGuru Europe AB
| Mölnlycke - Kista
|
| Email: lj@jguru.se
| URL:   www.jguru.se
| Phone
| (skype):    jgurueurope
| (intl):     +46 708 507 603
| (domestic): 0708 - 507 603
+==============================+

Re: Site:stage relativization against a variable URL

[Lukas Theussl <lt...@apache.org>]

Lennart Jörelid wrote:
> Good evening, all.
> 
> Today, maven-site-plugin performs its site:stage goal by copying the site
> of a project into a staging directory, and relativizing some URLs. The
> latter part is done by calculating the difference between the current
> project's ${project.distributionManagement.site.url} and
> the ${project.distributionManagement.site.url}  of the topmost parent pom,
> retrieved from the current project.
> 
> The MSITE-699 patch (https://jira.codehaus.org/browse/MSITE-669) currently
> introduces an optional parameter to permit relativizing the URLs in a
> staged site against the ${project.distributionManagement.site.url} of the
> reactor root pom instead. This flexibility simplifies site:stage for
> nonstandard reactor layouts.
> 
> However - I believe it could be more powerful/flexible/desirable to simply
> add an optional parameter to the site:stage goal with the desired root URL
> (i.e. giving the users the ability to supply the effective site:stage root
> URL as a [command line] configuration parameter). This would enable users
> to create staged sites for parts of a reactor with relative ease - which
> would be an improvement to the current site:stage goal.
> 
> It would certainly be a simple patch to supply.
> What do you think?

This would be a more general solution than the current MSITE-699, sounds
reasonable to me.

-Lukas

> 
> --
> +==============================+
> | Bästa hälsningar,
> | [sw. "Best regards"]
> |
> | Lennart Jörelid
> | EAI Architect & Integrator
> |
> | Phone
> | (skype):    jgurueurope
> +==============================+
> 

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