Mailing-List: contact forrest-dev-help@xml.apache.org; run by ezmlm
Precedence: bulk
Reply-To: forrest-dev@xml.apache.org
Message-ID: <1085353278.40b12d3e81536@secure.solidusdesign.com>
Date: Sun, 23 May 2004 19:01:18 -0400
From: Dave Brondsema <dave@brondsema.net>
To: forrest-dev@xml.apache.org
Subject: Re: Generating files with extensions other than .html
References: <m34qq7c63c.fsf@arrakis.hashbang.de>
In-Reply-To: <m34qq7c63c.fsf@arrakis.hashbang.de>
MIME-Version: 1.0
Content-Type: text/plain; charset=ISO-8859-1
Content-Transfer-Encoding: 8bit
User-Agent: Internet Messaging Program (IMP) 3.2.1

Quoting Vlad Berditchevskiy <vlad@hashbang.de>:

> Hi there!
> 
> How can I generate HTML files with other extensions than .html? I looked
> into sitemap.xmap and replaced all .html through .shtml, but there is
> still one problem: when I generate static pages, the main page is called
> index.html[1] and the navigation on that page is broken (in a webapp
> everything is ok[2]). :-( Where does this filename come from? I can't find
> it.
> 
> ____
> [1] Actually I had to make rules for both .html and .shtml, otherwise
>     forrest would abort after the attempt to generate the first file,
>     which is index.html.
> 
> [2] With the exception that I had to supply the indexfile attribute in
>     tabs.xml, otherwise all tabs would point to index.html, which does
>     not exist.

First, it might be easiest to just have a script to rename all the html files
afterwards.  Hrm, maybe I could include this as a post-process target in the
forrestbot.  At any rate, using this method would also allow you to easily
upgrade forrest without worring about merging your changes.

Did you change cli.xconf?  You can either provide one in your own project at
(IIRC): src/documentation/conf/cli.xconf or modify Forrest's at
core/context/WEB-INF/cli.xconf  

I'm not sure exactly how this file gets interpreted, but basically the cocoon
static file generator (CLI) uses this file as it spiders through links, generate
pages as it goes.  Documentation is at
http://wiki.cocoondev.org/Wiki.jsp?page=CommandLine

Of course you want to change <default-filename>.  You might also want to
specifically include index.shtml by using a <uri>.  And maybe have an <exclude
pattern="**/*.html"/>

-- 
Dave Brondsema : dave@brondsema.net 
http://www.brondsema.net : personal 
http://www.splike.com : programming 
http://csx.calvin.edu : student org