Return-Path: 
 <forrest-dev-return-2827-apmail-xml-forrest-dev-archive=xml.apache.org@xml.apache.org>
Delivered-To: apmail-xml-forrest-dev-archive@xml.apache.org
Received: (qmail 32643 invoked by uid 500); 27 Oct 2002 07:26:23 -0000
Mailing-List: contact forrest-dev-help@xml.apache.org; run by ezmlm
Precedence: bulk
list-help: <mailto:forrest-dev-help@xml.apache.org>
list-unsubscribe: <mailto:forrest-dev-unsubscribe@xml.apache.org>
list-post: <mailto:forrest-dev@xml.apache.org>
Reply-To: forrest-dev@xml.apache.org
Delivered-To: mailing list forrest-dev@xml.apache.org
Received: (qmail 32634 invoked from network); 27 Oct 2002 07:26:23 -0000
Received: from new-smtp1.ihug.com.au (203.109.250.27)
  by daedalus.apache.org with SMTP; 27 Oct 2002 07:26:23 -0000
Received: from p387-apx1.syd.ihug.com.au (expresso.localdomain)
 [203.173.141.133]
	by new-smtp1.ihug.com.au with esmtp (Exim 3.22 #1 (Debian))
	id 185hof-0006L1-00; Sun, 27 Oct 2002 18:26:33 +1100
Received: from jeff by expresso.localdomain with local (Exim 3.35 #1 (Debian))
	id 185hsC-0001L9-00
	for <forrest-dev@xml.apache.org>; Sun, 27 Oct 2002 18:30:12 +1100
Date: Sun, 27 Oct 2002 18:30:11 +1100
From: Jeff Turner <jefft@apache.org>
To: forrest-dev@xml.apache.org
Subject: Re: Here we go again
Message-ID: <20021027073011.GC1980@expresso.localdomain>
Mail-Followup-To: forrest-dev@xml.apache.org
References: <3DBB6A6F.8000807@bossicard.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <3DBB6A6F.8000807@bossicard.com>
User-Agent: Mutt/1.4i
X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N
Status: O
X-Status: 
X-Keywords: 

On Sat, Oct 26, 2002 at 09:24:15PM -0700, Vladimir R. Bossicard wrote:
> I'm now following the "using Forrest" howto and I am rewriting the 
> Xindice documentation.
> 
> I don't know if I made a mistake, but the files I already wrote 
> suddenly disapeared.  I don't know if it is after a
> "forrest seed" or one of my numerous mv/rm commands, so I will only 
> blame myself.

I hope it wasn't Forrest.. the 'seed' target will only generate template
docs if the content directory didn't previously exist.  Eg, trying to
clobber Forrest's docs:

jeff@expresso:~/apache/xml/xml-forrest$ forrest seed

.....
ensure-nocontent:

------------------------------------------------
This project already has content in
/home/jeff/apache/xml/xml-forrest/src/documentation/content/xdocs.
------------------------------------------------
BUILD FAILED
file:/home/jeff/apache/xml/xml-forrest/build/dist/shbat/bin/../forrest.build.xml:403:
Project already has content

> I started from scratch and have the following problems:
> 
> - I copied the Forrest howto directory in my project directory (I know 
> that I have problems with the howtos so I wanted to start with something 
> that worked).  I modify the tabs.xml with:
> 
>         <tab label="How-Tos" dir="howto/"/>
> 
> when the mouse goes over the link (in the index.html file), I can see 
> "http://localhost:8080/Xindice-documentation/howto/" but when I click on 
> the link the browser lands at "http://localhost:8080/howto/index.html" 
> and since the "Xindice-documentation" is missing, I have a "not found 
> resource".

The Forrest webapp has the same problem :/  I thought I fixed it long
ago.. will have a look.

> - When I add "Xindice-documentation" I can successfully see the pages 
> but their content is empty.  The first page is ok (index.html) but the 
> individual how-tos are empty (the border, menus are ok but not the 
> content).  I already had problems with how-tos and taking the one from 
> Forrest unfortunately doesn't help.
> 
> - When I copied them into "xdocs/community/howto"... it works!

Short answer: I just fixed the default sitemap to allow '*howto' directories
anywhere.  Eg /howto, /foo/howto, /foo-howto.  Only community/howto is treated
specially, with revisions.  I hope this behaviour meets the majority of
use-cases.  It's done by adding this rule:

<!-- Any other howto directories get transformed, without revisions -->
<map:match pattern="body-**howto/*.xml">
  <map:generate src="content/xdocs/{1}howto/{2}.xml"/>
  <map:transform src="library/xslt/howto2document.xsl" label="content"/>
  <map:call resource="skinit">
    <map:parameter name="type" value="document2html"/>
    <map:parameter name="resource" value="{3}"/>
    <map:parameter name="dir" value="{1}howto/"/>
  </map:call>
</map:match>

and tweaking howto2document.xsl to allow XMLs without revisions.


Long answer:

The default sitemap has this rule:

 <map:match pattern="body-community/*/*/**.xml">
   ...
     <map:part src="content/xdocs/community/{1}/{2}/{3}.xml"/>
   ...
   <map:transform src="library/xslt/{1}2document.xsl" label="content"/>
   ...
 </map:match>

So only community/howto/*/*.xml files are treated as 'howto's.

In the long term, we intend to fix this with content-aware pipelines (CAPs),
which infer the document type by examining the DOCTYPE declaration (and other
stuff).  CAPs are implemented but not integrated into the sitemap, so for now,
a special sitemap rule needs to be added, as documented at:

http://xml.apache.org/forrest/your-project.html#N10132

(which I've just done)

> I let work on this one for the moment...
> 
> -Vladimir
> 
> PS: good job but unfortunately not ready to be used by everyone.  You 
> still need a lot of patience...

Yes, Forrest inherits Cocoon's ability to be infuriating ;)

--Jeff

> Vladimir R. Bossicard
> www.bossicard.com