Subject: Re: while speaking of simplifying htdocs/XML ...(auto)layout
To: Hubert Feyrer <hubert@feyrer.de>
From: Daniel de Kok <danieldk@pobox.com>
List: netbsd-docs
Date: 11/29/2006 14:26:40
On Wed, Nov 29, 2006 at 12:27:25AM +0100, Hubert Feyrer wrote:
> we maintain htdocs/layout.html, generate autolayout.xml and some navigation 
> headers in the HTML files from that. I guess the idea here is to have a 
> site map of htdocs or something, but I wonder if that's worth the effort:
> 1) where is that site map, I've never seen it
> 2) the next/prev navigation links in the generated HTML files are
>    outdates, as not everything is committed on re-generation.
> 
> I guess I'm missing something important here, but maybe someone (Jan?) can 
> tell me the deeper idea behind layout.xml, autolayout.xmk etc.?

layout and autolayout.xml/xsl are used for making a "database" of all
documents and IDs. This is necessary, because the website consists of
a bunch of XML files (rather than just one). This is the reason why
inter-werbsite links are often incorrect if a page is not added to
layout.xml.

-- Daniel