You are viewing a plain text version of this content. The canonical link for it is here.
Posted to user@forrest.apache.org by Howard Lewis Ship <hl...@gmail.com> on 2004/10/27 17:05:34 UTC

Issues upgrading from 0.5 to 0.6

I'm aware of what I should be doing and much of it used to work in Forrest 0.5.

See the diffs:

http://cvs.apache.org/viewcvs.cgi/jakarta-hivemind/src/documentation/content/xdocs/site.xml?r1=1.26%3Arelease-1-0&tr1=1.28&r2=text&tr2=1.28&diff_format=h

I had to strip out a lot of stuff that makes sense to work around bugs in 0.6. 

I'm still finding more problems; for example when trying to build
wholesite.xml, I get:

     [java] X [0]                                     wholesite.html  
 BROKEN: java.lang.RuntimeException:
org.apache.cocoon.ResourceNotFoundException: Resource not found.: o
rg.apache.excalibur.source.SourceNotFoundException:
file:/C:/workspace/jakarta-hivemind/target/forrest-composite/content/xdocs/hivedocs/index.xml
doesn't exist.

Even though my cli.xconf contains:

   <exclude pattern="hivedocs/**"/>
   <exclude pattern="**/hivedocs/**"/>
   <exclude pattern="**/apidocs/**"/>
   <exclude pattern="**/clover/**"/>

I also just noticed that top-level, non-menu elements in my site.xml
don't appear.  Example:

		<reference label="Reference">
			<services label="Services" href="services.html"/>
			<configurations label="Configurations" href="configurations.html"/>
			<hivedoc label="HiveDoc" href="hivedoc.html"/>
			<descriptor label="Module  Descriptor" href="descriptor.html"/>
			<rules label="Contribution Processing Rules" href="rules.html"/>
      <dependencies label="Dependencies" href="dependencies.html"/>
 		</reference>

		<changes label="Change Log" href="changes.html"/>
    <todo label="TODO" href="todo.html"/>
    
    <mailinglists label="Mailing Lists"
href="http://jakarta.apache.org/site/mail2.html#HiveMind"/>
    
		<downloads href="downloads.html" label="Downloads"/>
		<bugs href="http://issues.apache.org/jira/secure/BrowseProject.jspa?id=10500"
label="Bugs"/>
		
		<cvs href="cvs.html" label="CVS Access"/>
		
		<tutorials label="Tutorials and Information">

The "Reference" and "Tutorials and Information" menus appear, but none
of the others do.



On 27 Oct 2004 12:46:05 +1000, David Crossley <cr...@apache.org> wrote:
> Howard Lewis Ship wrote:
> > I eventually did get the HiveMind site building properly, but it took
> > a LOT of effort.
> 
> Phew. Very glad to see that you got there, and that
> we could help in some places. Your situation was extra
> difficult due to the integration of Forrest into your
> build system. That should be possible, so we have some
> work to do.
> 
> > I've documented my experiences on my blog:
> >
> > http://howardlewisship.com/blog/2004/10/upgraded-hivemind-to-forrest-06.html
> 
> I will check it out soon.
> 
> > Results are visible online:
> >
> > http://jakarta.apache.org/hivemind/
> 
> Great. I see that the breadcrumb trail has one extra "HiveMind".
> You probably need to tweak your skinconf.xml to remove that.
> 
> > There's definately a bug afoot where the system thinks all
> > "index.html" files are exactly the same, regardless of the folder!
> 
> Well this works with no problems for other sites,
> so it must be something peculiar to yours.
> 
> Looking for the differences between your site.xml
> and the one for our Forrest site. For each menu
> that belongs to a "tab", we have a "href" attribute
> on its top-level element to point to the directory,
> e.g. on your <hivemind-examples> element.
> 
> --
> David Crossley
> 
> 


-- 
Howard M. Lewis Ship
Independent J2EE / Open-Source Java Consultant
Creator, Jakarta Tapestry
Creator, Jakarta HiveMind
http://howardlewisship.com

Re: Issues upgrading from 0.5 to 0.6

Posted by Howard Lewis Ship <hl...@gmail.com>.
On 28 Oct 2004 13:24:40 +1000, David Crossley <cr...@apache.org> wrote:

> I am not with you here. What bugs in 0.6?

I had a long thread last week or so about my many travails trying to
upgrade from 0.5 to 0.6. The thread is titled "Upgrade to 0.6:
validation issues".  I've also documented on my blog some of these
issues:

http://howardlewisship.com/blog/2004/10/upgraded-hivemind-to-forrest-06.html

I was able to resolve most of them, but one particularily nasty bug
resulted in the index.html in each directory being exactly the same.

With much thrashing, I made the changes shown in that diff to force
forrest/cocoon to generate the correct content in each index.html.



-- 
Howard M. Lewis Ship
Independent J2EE / Open-Source Java Consultant
Creator, Jakarta Tapestry
Creator, Jakarta HiveMind
http://howardlewisship.com

Re: Issues upgrading from 0.5 to 0.6

Posted by David Crossley <cr...@apache.org>.
Howard Lewis Ship wrote:
> I'm aware of what I should be doing and much of it used to work in Forrest 0.5.
> 
> See the diffs:
> 
> http://cvs.apache.org/viewcvs.cgi/jakarta-hivemind/src/documentation/content/xdocs/site.xml?r1=1.26%3Arelease-1-0&tr1=1.28&r2=text&tr2=1.28&diff_format=h

Hmmm, but this is what i was referring to below.
I wonder if you do need the href="hivemind-examples/"
part which you removed.

> I had to strip out a lot of stuff that makes sense to work around bugs in 0.6. 

I am not with you here. What bugs in 0.6?

> I'm still finding more problems; for example when trying to build
> wholesite.xml, I get:
> 
>      [java] X [0]                                     wholesite.html  
>  BROKEN: java.lang.RuntimeException:
> org.apache.cocoon.ResourceNotFoundException: Resource not found.: o
> rg.apache.excalibur.source.SourceNotFoundException:
> file:/C:/workspace/jakarta-hivemind/target/forrest-composite/content/xdocs/hivedocs/index.xml
> doesn't exist.
> 
> Even though my cli.xconf contains:
> 
>    <exclude pattern="hivedocs/**"/>
>    <exclude pattern="**/hivedocs/**"/>
>    <exclude pattern="**/apidocs/**"/>
>    <exclude pattern="**/clover/**"/>

We know that there are problems with whole-site aggregation
and someone already advised you to leave it out for now.

> I also just noticed that top-level, non-menu elements in my site.xml
> don't appear.

This sounds like it is related to the missing href attributes.

--David

> Example:
> 
> 		<reference label="Reference">
> 			<services label="Services" href="services.html"/>
> 			<configurations label="Configurations" href="configurations.html"/>
> 			<hivedoc label="HiveDoc" href="hivedoc.html"/>
> 			<descriptor label="Module  Descriptor" href="descriptor.html"/>
> 			<rules label="Contribution Processing Rules" href="rules.html"/>
>       <dependencies label="Dependencies" href="dependencies.html"/>
>  		</reference>
> 
> 		<changes label="Change Log" href="changes.html"/>
>     <todo label="TODO" href="todo.html"/>
>     
>     <mailinglists label="Mailing Lists"
> href="http://jakarta.apache.org/site/mail2.html#HiveMind"/>
>     
> 		<downloads href="downloads.html" label="Downloads"/>
> 		<bugs href="http://issues.apache.org/jira/secure/BrowseProject.jspa?id=10500"
> label="Bugs"/>
> 		
> 		<cvs href="cvs.html" label="CVS Access"/>
> 		
> 		<tutorials label="Tutorials and Information">
> 
> The "Reference" and "Tutorials and Information" menus appear, but none
> of the others do.
> 
> 
> 
> On 27 Oct 2004 12:46:05 +1000, David Crossley <cr...@apache.org> wrote:
> > Howard Lewis Ship wrote:
> > > I eventually did get the HiveMind site building properly, but it took
> > > a LOT of effort.
> > 
> > Phew. Very glad to see that you got there, and that
> > we could help in some places. Your situation was extra
> > difficult due to the integration of Forrest into your
> > build system. That should be possible, so we have some
> > work to do.
> > 
> > > I've documented my experiences on my blog:
> > >
> > > http://howardlewisship.com/blog/2004/10/upgraded-hivemind-to-forrest-06.html
> > 
> > I will check it out soon.
> > 
> > > Results are visible online:
> > >
> > > http://jakarta.apache.org/hivemind/
> > 
> > Great. I see that the breadcrumb trail has one extra "HiveMind".
> > You probably need to tweak your skinconf.xml to remove that.
> > 
> > > There's definately a bug afoot where the system thinks all
> > > "index.html" files are exactly the same, regardless of the folder!
> > 
> > Well this works with no problems for other sites,
> > so it must be something peculiar to yours.
> > 
> > Looking for the differences between your site.xml
> > and the one for our Forrest site. For each menu
> > that belongs to a "tab", we have a "href" attribute
> > on its top-level element to point to the directory,
> > e.g. on your <hivemind-examples> element.
> > 
> > --
> > David Crossley
> > 
> > 
>