You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@commons.apache.org by Kris Nuttycombe <Kr...@noaa.gov> on 2006/09/20 19:28:02 UTC
How to make site updates?
Hi, all,
What is the general process for making updates to a project site? There
have been a number of changes to the pipeline documentation and the
javadocs need to be regenerated. How do I go about making these changes
visible? The project is using maven2 and the default templates for site
generation, so how do I go about getting the standard commons look & feel?
Thanks,
Kris
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org
Re: How to make site updates?
Posted by Dennis Lundberg <de...@apache.org>.
Dennis Lundberg wrote:
> Kris Nuttycombe wrote:
>> Hi, all,
>>
>> What is the general process for making updates to a project site?
>> There have been a number of changes to the pipeline documentation and
>> the javadocs need to be regenerated. How do I go about making these
>> changes visible? The project is using maven2 and the default templates
>> for site generation, so how do I go about getting the standard commons
>> look & feel?
>>
>> Thanks,
>>
>> Kris
>
> Hi Kris
>
> You should get the standard look & feel automatically by pom
> inheritance.
Sorry, the above should be site.xml inheritance instead of pom inheritance.
</snip>
--
Dennis Lundberg
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org
Re: How to make site updates?
Posted by Kris Nuttycombe <Kr...@noaa.gov>.
Great, I have everything working now. For the time being, I simply
removed the height setting in order to deploy the new site. Thanks very
much for all your help!
Kris
Dennis Lundberg wrote:
> Kris Nuttycombe wrote:
>> One thing I'm finding with the site generation: the height setting
>> for the breadcrumbs bar is fouling up the flow of both the pipeline
>> and compress sites:
>>
>> #breadcrumbs {
>> background-color: #ccc;
>> border-top: 1px solid #aaa;
>> height: 13px;
>> }
> >
>> If I remove this height setting, the pages display fine. If I do not
>> do so, the problem is that the navigation bar, since it's floated to
>> the left, is getting wrapped up a line and is placed to the right of
>> the last generation date.
>
> I'll look into it.
>
>> With respect to deployment, I think you may still be misunderstanding
>> my question. In looking around people.apache.org, I noticed that all
>> of the project sites are under /www - which is jakarta group
>> writeable. Is this where I should put the updated pages for the site?
>> I didn't see individual project directories in the SVN repository
>> that you refer to below.
>
> To create the site and deploy it to the production server you need to
> run this command:
>
> mvn site-deploy
>
> This will create the site locally, bundle it together into an archive
> and upload that archive to people.apache.org. After that the archive
> is expanded into the correct directory on the server.
>
> After a couple of hours the site will be synced over to the production
> machine jakarta.apache.org in this case.
>
>
>>
>> Thanks for your help,
>>
>> Kris
>>
>> Dennis Lundberg wrote:
>>> The Jakarta site is a module of its own in svn:
>>> https://svn.apache.org/repos/asf/jakarta/site/
>>>
>>> Check the README-files for more info.
>>>
>>
>> ---------------------------------------------------------------------
>> 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: How to make site updates?
Posted by Dennis Lundberg <de...@apache.org>.
Kris Nuttycombe wrote:
> One thing I'm finding with the site generation: the height setting for
> the breadcrumbs bar is fouling up the flow of both the pipeline and
> compress sites:
>
> #breadcrumbs {
> background-color: #ccc;
> border-top: 1px solid #aaa;
> height: 13px;
> }
>
> If I remove this height setting, the pages display fine. If I do not do
> so, the problem is that the navigation bar, since it's floated to the
> left, is getting wrapped up a line and is placed to the right of the
> last generation date.
I'll look into it.
> With respect to deployment, I think you may still be misunderstanding my
> question. In looking around people.apache.org, I noticed that all of the
> project sites are under /www - which is jakarta group writeable. Is this
> where I should put the updated pages for the site? I didn't see
> individual project directories in the SVN repository that you refer to
> below.
To create the site and deploy it to the production server you need to
run this command:
mvn site-deploy
This will create the site locally, bundle it together into an archive
and upload that archive to people.apache.org. After that the archive is
expanded into the correct directory on the server.
After a couple of hours the site will be synced over to the production
machine jakarta.apache.org in this case.
>
> Thanks for your help,
>
> Kris
>
> Dennis Lundberg wrote:
>> The Jakarta site is a module of its own in svn:
>> https://svn.apache.org/repos/asf/jakarta/site/
>>
>> Check the README-files for more info.
>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> For additional commands, e-mail: commons-dev-help@jakarta.apache.org
>
--
Dennis Lundberg
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org
Re: How to make site updates?
Posted by Kris Nuttycombe <Kr...@noaa.gov>.
One thing I'm finding with the site generation: the height setting for
the breadcrumbs bar is fouling up the flow of both the pipeline and
compress sites:
#breadcrumbs {
background-color: #ccc;
border-top: 1px solid #aaa;
height: 13px;
}
If I remove this height setting, the pages display fine. If I do not do
so, the problem is that the navigation bar, since it's floated to the
left, is getting wrapped up a line and is placed to the right of the
last generation date.
With respect to deployment, I think you may still be misunderstanding my
question. In looking around people.apache.org, I noticed that all of the
project sites are under /www - which is jakarta group writeable. Is this
where I should put the updated pages for the site? I didn't see
individual project directories in the SVN repository that you refer to
below.
Thanks for your help,
Kris
Dennis Lundberg wrote:
> The Jakarta site is a module of its own in svn:
> https://svn.apache.org/repos/asf/jakarta/site/
>
> Check the README-files for more info.
>
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org
Re: How to make site updates?
Posted by Dennis Lundberg <de...@apache.org>.
The Jakarta site is a module of its own in svn:
https://svn.apache.org/repos/asf/jakarta/site/
Check the README-files for more info.
--
Dennis Lundberg
Kris Nuttycombe wrote:
> I'm quite familiar with the site plugin; the question is, once I've
> generated the site, how do I actually go about updating the content
> that's visible from the Jakarta home page? This is what is out of date
> and needs to be replaced with the newly generated site documentation.
>
> Kris
>
> Dennis Lundberg wrote:
>> You can find out a lot about the Maven site plugin, which is used to
>> generate and deploy the site, on this page:
>> http://maven.apache.org/plugins/maven-site-plugin/howto.html
>>
>> Better documentation has been developed, but has not been officially
>> published yet.
>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> For additional commands, e-mail: commons-dev-help@jakarta.apache.org
>
--
Dennis Lundberg
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org
Re: How to make site updates?
Posted by Kris Nuttycombe <Kr...@noaa.gov>.
I'm quite familiar with the site plugin; the question is, once I've
generated the site, how do I actually go about updating the content
that's visible from the Jakarta home page? This is what is out of date
and needs to be replaced with the newly generated site documentation.
Kris
Dennis Lundberg wrote:
> You can find out a lot about the Maven site plugin, which is used to
> generate and deploy the site, on this page:
> http://maven.apache.org/plugins/maven-site-plugin/howto.html
>
> Better documentation has been developed, but has not been officially
> published yet.
>
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org
Re: How to make site updates?
Posted by Dennis Lundberg <de...@apache.org>.
You can find out a lot about the Maven site plugin, which is used to
generate and deploy the site, on this page:
http://maven.apache.org/plugins/maven-site-plugin/howto.html
Better documentation has been developed, but has not been officially
published yet.
--
Dennis Lundberg
Kris Nuttycombe wrote:
> The site looks pretty good, although it appears that there may be some
> CSS problems - the left navigation bar is floated over the body content
> in both Firefox and Konqueror; I'm not sure how it shows up in IE.
>
> So, how do I go about deploying the site?
>
> Kris
>
> Dennis Lundberg wrote:
>> Kris Nuttycombe wrote:
>>> Hi, all,
>>>
>>> What is the general process for making updates to a project site?
>>> There have been a number of changes to the pipeline documentation and
>>> the javadocs need to be regenerated. How do I go about making these
>>> changes visible? The project is using maven2 and the default
>>> templates for site generation, so how do I go about getting the
>>> standard commons look & feel?
>>>
>>> Thanks,
>>>
>>> Kris
>>
>> Hi Kris
>>
>> You should get the standard look & feel automatically by pom
>> inheritance. It doesn't look exactly like the Maven 1 generated sites
>> yet, but we're slowly getting there. Please post any differences you
>> spot here, and I'll try to fix them. The long-term solution for this
>> is to create a commons-skin for Maven 2.
>>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
> For additional commands, e-mail: commons-dev-help@jakarta.apache.org
>
--
Dennis Lundberg
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org
Re: How to make site updates?
Posted by Kris Nuttycombe <Kr...@noaa.gov>.
The site looks pretty good, although it appears that there may be some
CSS problems - the left navigation bar is floated over the body content
in both Firefox and Konqueror; I'm not sure how it shows up in IE.
So, how do I go about deploying the site?
Kris
Dennis Lundberg wrote:
> Kris Nuttycombe wrote:
>> Hi, all,
>>
>> What is the general process for making updates to a project site?
>> There have been a number of changes to the pipeline documentation and
>> the javadocs need to be regenerated. How do I go about making these
>> changes visible? The project is using maven2 and the default
>> templates for site generation, so how do I go about getting the
>> standard commons look & feel?
>>
>> Thanks,
>>
>> Kris
>
> Hi Kris
>
> You should get the standard look & feel automatically by pom
> inheritance. It doesn't look exactly like the Maven 1 generated sites
> yet, but we're slowly getting there. Please post any differences you
> spot here, and I'll try to fix them. The long-term solution for this
> is to create a commons-skin for Maven 2.
>
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org
Re: How to make site updates?
Posted by Dennis Lundberg <de...@apache.org>.
Kris Nuttycombe wrote:
> Hi, all,
>
> What is the general process for making updates to a project site? There
> have been a number of changes to the pipeline documentation and the
> javadocs need to be regenerated. How do I go about making these changes
> visible? The project is using maven2 and the default templates for site
> generation, so how do I go about getting the standard commons look & feel?
>
> Thanks,
>
> Kris
Hi Kris
You should get the standard look & feel automatically by pom
inheritance. It doesn't look exactly like the Maven 1 generated sites
yet, but we're slowly getting there. Please post any differences you
spot here, and I'll try to fix them. The long-term solution for this is
to create a commons-skin for Maven 2.
--
Dennis Lundberg
---------------------------------------------------------------------
To unsubscribe, e-mail: commons-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: commons-dev-help@jakarta.apache.org