You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by "Mark R. Diggory" <md...@latte.harvard.edu> on 2004/02/15 17:08:08 UTC
Move Commons projects below "Project Documentation" in Navigation
This idea has been proposed before, only people thought it not possible.
However, after some digging, I found out it is.
<j:if test="${date == 'navigation-top'}">
<div id="lastPublished">Last published: ${build.date}</div>
</j:if>
<x:if select="$nav">
<jsl:applyTemplates select="$nav/body/menu[not(@type) |
@type='header'] | $nav/body/search"/>
</x:if>
<jsl:applyTemplates select="$projectNav/body/menu"/>
<!-- allows user to put menu items after standard reports -->
<x:if select="$nav">
<jsl:applyTemplates select="$nav/body/menu[@type='footer']"/>
</x:if>
http://cvs.apache.org/viewcvs.cgi/maven-plugins/xdoc/src/plugin-resources/site.jsl
in the site.jsl when processing the navigation, if the following
'type="footer" attribute is added to any menu tag, then the navigation
menu shows up "after" the Project Documentation.
This should solve alot of the complaints about showing all the Commons
Project in the navigation, because everyone is really trying to get to
the Project Doc.
-Mark
--
Mark Diggory
Software Developer
Harvard MIT Data Center
http://www.hmdc.harvard.edu
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org
Re: Move Commons projects below "Project Documentation" in Navigation
Posted by "Mark R. Diggory" <md...@latte.harvard.edu>.
To move the Site Documentation up you need to upgrade your xdoc plugin
to the latest (version 1.5), caution, this also changes the css style of
the site.
the command to upgrade the xdoc plugin is:
%maven -DgroupId=maven -DartifactId=maven-xdoc-plugin -Dversion=1.5
plugin:download
-Mark
Mark R. Diggory wrote:
> It looks like this feature is pretty new to the xdoc plugin cvs and not
> currently in this release candidate. I suspect it will be in the next,
> otherwise I can recommend that we upgrade all our xdoc plugin tot eh
> latest release.
>
> I'll test this further later today.
>
> -Mark
>
> Stephen Colebourne wrote:
>
>> From: "robert burrell donkin" <ro...@blueyonder.co.uk>
>>
>>> i like this sounds of this (regardless of whether we find a way to make
>>> the menus collapse or not.
>>
>>
>>
>> +0. I still think we should add explicit links in the top section for
>> each
>> project.
>>
>> I was thinking that maybe the Sandbox projects should _not_ be linked
>> on the
>> side of every page. These projects are not released, and can move and
>> vary
>> more over time. Perhaps the best combination is for links for each
>> commons
>> proper project, and a single link for the sandbox. I would like to demote
>> the sandbox a bit - it might have the effect of pushing some projects to
>> promote ;-)
>>
>> Stephen
>>
>>
>> ---------------------------------------------------------------------
>> To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
>> For additional commands, e-mail: commons-dev-help@jakarta.apache.org
>>
>
--
Mark Diggory
Software Developer
Harvard MIT Data Center
http://www.hmdc.harvard.edu
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org
Re: Move Commons projects below "Project Documentation" in Navigation
Posted by "Mark R. Diggory" <md...@latte.harvard.edu>.
Martin Cooper wrote:
>
>>-----Original Message-----
>>From: Mark R. Diggory [mailto:mdiggory@latte.harvard.edu]
>>Sent: Sunday, February 15, 2004 5:15 PM
>>To: Jakarta Commons Developers List
>>Subject: Re: Move Commons projects below "Project Documentation" in
>>Navigation
>>
>>
>>
>>
>>Martin Cooper wrote:
>>
>>
>>>>It looks like this feature is pretty new to the xdoc plugin cvs and not
>>>>currently in this release candidate. I suspect it will be in the next,
>>>>otherwise I can recommend that we upgrade all our xdoc plugin tot eh
>>>>latest release.
>>>
>>>
>>>It seems to me that this is, at least in part, why Maven has not even
>>>reached a 1.0 release, after it's been around, and been used,
>>
>>for so long.
>>
>>>If they're adding new features in a release candidate, I don't have much
>>>confidence that there ever will be a 1.0 final release. ;-(
>>>
>>>--
>>>Martin Cooper
>>>
>>
>>Hmm, but Maven itself hasn't changed, its the natural evolution of the
>>plugins alone. the xdoc and site plugins are naturally going to advance
>>in feature as more users provide input.
>>
>>You can "upgrade" the plugins very easily in Maven, if anything this
>>flexibility makes Maven even stronger. I disagree with the comment about
>>a 1.0 release, the features in a specific plugin arn't going to define
>>or limit the release of Maven itself.
>
>
> That's all very nice, but it doesn't matter to me as a regular Maven user
> any more than whether it's a standard plugin or the core itself that's
> broken when I have a problem with Eclipse. From my perspective, if I
> download Maven and something isn't working, Maven is broken, regardless of
> whether it's a plugin or the core. (For example, as far as I'm concerned,
> Maven RC1 is broken because it generates incorrect Ant build files, where
> prior versions worked. It doesn't matter to me if that's because of a plugin
> bug, it's still broken.)
>
> --
> Martin Cooper
>
Sigh...
Every situation can be viewed from anywhere within a continuum of
negative to positive perspectives. How often we are quick to levy blame
when what is really needed is a helping hand.
I'd rather see my discussions stay on topic. This one no longer is...
--
Mark Diggory
Software Developer
Harvard MIT Data Center
http://www.hmdc.harvard.edu
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org
RE: Move Commons projects below "Project Documentation" in Navigation
Posted by Martin Cooper <ma...@apache.org>.
> -----Original Message-----
> From: Mark R. Diggory [mailto:mdiggory@latte.harvard.edu]
> Sent: Sunday, February 15, 2004 5:15 PM
> To: Jakarta Commons Developers List
> Subject: Re: Move Commons projects below "Project Documentation" in
> Navigation
>
>
>
>
> Martin Cooper wrote:
>
> >>
> >>It looks like this feature is pretty new to the xdoc plugin cvs and not
> >>currently in this release candidate. I suspect it will be in the next,
> >>otherwise I can recommend that we upgrade all our xdoc plugin tot eh
> >>latest release.
> >
> >
> > It seems to me that this is, at least in part, why Maven has not even
> > reached a 1.0 release, after it's been around, and been used,
> for so long.
> > If they're adding new features in a release candidate, I don't have much
> > confidence that there ever will be a 1.0 final release. ;-(
> >
> > --
> > Martin Cooper
> >
>
> Hmm, but Maven itself hasn't changed, its the natural evolution of the
> plugins alone. the xdoc and site plugins are naturally going to advance
> in feature as more users provide input.
>
> You can "upgrade" the plugins very easily in Maven, if anything this
> flexibility makes Maven even stronger. I disagree with the comment about
> a 1.0 release, the features in a specific plugin arn't going to define
> or limit the release of Maven itself.
That's all very nice, but it doesn't matter to me as a regular Maven user
any more than whether it's a standard plugin or the core itself that's
broken when I have a problem with Eclipse. From my perspective, if I
download Maven and something isn't working, Maven is broken, regardless of
whether it's a plugin or the core. (For example, as far as I'm concerned,
Maven RC1 is broken because it generates incorrect Ant build files, where
prior versions worked. It doesn't matter to me if that's because of a plugin
bug, it's still broken.)
--
Martin Cooper
>
> See my other post concerning how to upgrade the xdoc plugin with one
> command line option.
>
> -Mark
>
> --
> Mark Diggory
> Software Developer
> Harvard MIT Data Center
> http://www.hmdc.harvard.edu
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> For additional commands, e-mail: commons-dev-help@jakarta.apache.org
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org
Re: Move Commons projects below "Project Documentation" in Navigation
Posted by "Mark R. Diggory" <md...@latte.harvard.edu>.
Martin Cooper wrote:
>>
>>It looks like this feature is pretty new to the xdoc plugin cvs and not
>>currently in this release candidate. I suspect it will be in the next,
>>otherwise I can recommend that we upgrade all our xdoc plugin tot eh
>>latest release.
>
>
> It seems to me that this is, at least in part, why Maven has not even
> reached a 1.0 release, after it's been around, and been used, for so long.
> If they're adding new features in a release candidate, I don't have much
> confidence that there ever will be a 1.0 final release. ;-(
>
> --
> Martin Cooper
>
Hmm, but Maven itself hasn't changed, its the natural evolution of the
plugins alone. the xdoc and site plugins are naturally going to advance
in feature as more users provide input.
You can "upgrade" the plugins very easily in Maven, if anything this
flexibility makes Maven even stronger. I disagree with the comment about
a 1.0 release, the features in a specific plugin arn't going to define
or limit the release of Maven itself.
See my other post concerning how to upgrade the xdoc plugin with one
command line option.
-Mark
--
Mark Diggory
Software Developer
Harvard MIT Data Center
http://www.hmdc.harvard.edu
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org
RE: Move Commons projects below "Project Documentation" in Navigation
Posted by Martin Cooper <ma...@apache.org>.
> -----Original Message-----
> From: Mark R. Diggory [mailto:mdiggory@latte.harvard.edu]
> Sent: Sunday, February 15, 2004 9:50 AM
> To: Jakarta Commons Developers List
> Subject: Re: Move Commons projects below "Project Documentation" in
> Navigation
>
>
> It looks like this feature is pretty new to the xdoc plugin cvs and not
> currently in this release candidate. I suspect it will be in the next,
> otherwise I can recommend that we upgrade all our xdoc plugin tot eh
> latest release.
It seems to me that this is, at least in part, why Maven has not even
reached a 1.0 release, after it's been around, and been used, for so long.
If they're adding new features in a release candidate, I don't have much
confidence that there ever will be a 1.0 final release. ;-(
--
Martin Cooper
>
> I'll test this further later today.
>
> -Mark
>
> Stephen Colebourne wrote:
>
> > From: "robert burrell donkin" <ro...@blueyonder.co.uk>
> >
> >>i like this sounds of this (regardless of whether we find a way to make
> >>the menus collapse or not.
> >
> >
> > +0. I still think we should add explicit links in the top
> section for each
> > project.
> >
> > I was thinking that maybe the Sandbox projects should _not_ be
> linked on the
> > side of every page. These projects are not released, and can
> move and vary
> > more over time. Perhaps the best combination is for links for
> each commons
> > proper project, and a single link for the sandbox. I would like
> to demote
> > the sandbox a bit - it might have the effect of pushing some projects to
> > promote ;-)
> >
> > Stephen
> >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> > For additional commands, e-mail: commons-dev-help@jakarta.apache.org
> >
>
> --
> Mark Diggory
> Software Developer
> Harvard MIT Data Center
> http://www.hmdc.harvard.edu
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> For additional commands, e-mail: commons-dev-help@jakarta.apache.org
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org
Re: Move Commons projects below "Project Documentation" in Navigation
Posted by "Mark R. Diggory" <md...@latte.harvard.edu>.
It looks like this feature is pretty new to the xdoc plugin cvs and not
currently in this release candidate. I suspect it will be in the next,
otherwise I can recommend that we upgrade all our xdoc plugin tot eh
latest release.
I'll test this further later today.
-Mark
Stephen Colebourne wrote:
> From: "robert burrell donkin" <ro...@blueyonder.co.uk>
>
>>i like this sounds of this (regardless of whether we find a way to make
>>the menus collapse or not.
>
>
> +0. I still think we should add explicit links in the top section for each
> project.
>
> I was thinking that maybe the Sandbox projects should _not_ be linked on the
> side of every page. These projects are not released, and can move and vary
> more over time. Perhaps the best combination is for links for each commons
> proper project, and a single link for the sandbox. I would like to demote
> the sandbox a bit - it might have the effect of pushing some projects to
> promote ;-)
>
> Stephen
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> For additional commands, e-mail: commons-dev-help@jakarta.apache.org
>
--
Mark Diggory
Software Developer
Harvard MIT Data Center
http://www.hmdc.harvard.edu
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org
Re: Move Commons projects below "Project Documentation" in Navigation
Posted by Stephen Colebourne <sc...@btopenworld.com>.
From: "Martin Cooper" <ma...@apache.org>
> > From: Stephen Colebourne [mailto:scolebourne@btopenworld.com]
> > I was thinking that maybe the Sandbox projects should _not_ be
> > linked on the
> > side of every page. These projects are not released, and can move and
vary
> > more over time. Perhaps the best combination is for links for each
commons
> > proper project, and a single link for the sandbox. I would like to
demote
> > the sandbox a bit - it might have the effect of pushing some projects to
> > promote ;-)
>
> I strongly disagree with decreasing the visibility of sandbox components.
> One of the reasons they are in the sandbox is often because they still
need
> to form a community around themselves. The chances of that happening are
> going to be lower if people don't even know the components exist. Recall
> that quite recently we had a long discussion about many sandbox components
> not having a web presence, and the concensus was to create a web presence
> for them so as to *increase* their visibility.
I am happy for links to sandbox components from the commons home page. I am
just questioning whether they need/should be linked from every commons
proper page. Its a balance.
Stephen
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org
RE: Move Commons projects below "Project Documentation" in Navigation
Posted by Martin Cooper <ma...@apache.org>.
> -----Original Message-----
> From: Stephen Colebourne [mailto:scolebourne@btopenworld.com]
> Sent: Sunday, February 15, 2004 9:00 AM
> To: Jakarta Commons Developers List
> Subject: Re: Move Commons projects below "Project Documentation" in
> Navigation
>
>
> From: "robert burrell donkin" <ro...@blueyonder.co.uk>
> > i like this sounds of this (regardless of whether we find a way to make
> > the menus collapse or not.
>
> +0. I still think we should add explicit links in the top section for each
> project.
>
> I was thinking that maybe the Sandbox projects should _not_ be
> linked on the
> side of every page. These projects are not released, and can move and vary
> more over time. Perhaps the best combination is for links for each commons
> proper project, and a single link for the sandbox. I would like to demote
> the sandbox a bit - it might have the effect of pushing some projects to
> promote ;-)
I strongly disagree with decreasing the visibility of sandbox components.
One of the reasons they are in the sandbox is often because they still need
to form a community around themselves. The chances of that happening are
going to be lower if people don't even know the components exist. Recall
that quite recently we had a long discussion about many sandbox components
not having a web presence, and the concensus was to create a web presence
for them so as to *increase* their visibility.
--
Martin Cooper
>
> Stephen
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> For additional commands, e-mail: commons-dev-help@jakarta.apache.org
>
>
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org
Re: Move Commons projects below "Project Documentation" in Navigation
Posted by Stephen Colebourne <sc...@btopenworld.com>.
From: "robert burrell donkin" <ro...@blueyonder.co.uk>
> i like this sounds of this (regardless of whether we find a way to make
> the menus collapse or not.
+0. I still think we should add explicit links in the top section for each
project.
I was thinking that maybe the Sandbox projects should _not_ be linked on the
side of every page. These projects are not released, and can move and vary
more over time. Perhaps the best combination is for links for each commons
proper project, and a single link for the sandbox. I would like to demote
the sandbox a bit - it might have the effect of pushing some projects to
promote ;-)
Stephen
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org
Re: Move Commons projects below "Project Documentation" in Navigation
Posted by robert burrell donkin <ro...@blueyonder.co.uk>.
i like this sounds of this (regardless of whether we find a way to make
the menus collapse or not.
- robert
On 15 Feb 2004, at 16:08, Mark R. Diggory wrote:
> This idea has been proposed before, only people thought it not
> possible. However, after some digging, I found out it is.
>
> <j:if test="${date == 'navigation-top'}">
> <div id="lastPublished">Last published:
> ${build.date}</div>
> </j:if>
> <x:if select="$nav">
> <jsl:applyTemplates select="$nav/body/menu[not(@type) |
> @type='header'] | $nav/body/search"/>
> </x:if>
> <jsl:applyTemplates select="$projectNav/body/menu"/>
> <!-- allows user to put menu items after standard reports
> -->
> <x:if select="$nav">
> <jsl:applyTemplates
> select="$nav/body/menu[@type='footer']"/>
> </x:if>
>
> http://cvs.apache.org/viewcvs.cgi/maven-plugins/xdoc/src/plugin-
> resources/site.jsl
>
> in the site.jsl when processing the navigation, if the following
> 'type="footer" attribute is added to any menu tag, then the navigation
> menu shows up "after" the Project Documentation.
>
> This should solve alot of the complaints about showing all the Commons
> Project in the navigation, because everyone is really trying to get to
> the Project Doc.
>
> -Mark
>
> --
> Mark Diggory
> Software Developer
> Harvard MIT Data Center
> http://www.hmdc.harvard.edu
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> For additional commands, e-mail: commons-dev-help@jakarta.apache.org
>
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org