Subject: Re: simplifying htdocs build procedure (long term)
To: Jan Schaumann <>
From: Roland Illig <>
List: netbsd-docs
Date: 01/30/2006 03:05:18
Jan Schaumann wrote:
> Roland Illig <> wrote:
>>Jan Schaumann wrote:
>>>I'd like to start a detailed discussion about how we can make this
>>>happen.  I think we should first figure out what exactly our goals are
>>>in the documentation management framework.  Here's what I came up with:
>>>- we want to have a consistent layout, look and feel for all pages
>>- including some links for easy navigation -- preferably in the header 
>>of each page.
> Hmmm.  If you refer to something like we currently have (<link rel>),
> then I'm not sure I find that very useful for a regular website (in
> contrast to a consistent and self-contained section like the Guide).  A
> normal website doesn't really have a hierarchical structure, I think.
> But maybe I misunderstood, and you ment having a common set of links in
> the header or footer that go to, say
> 'Home Page'  'Search'  'Documentation' 'About'

For example, &head.navi; could expand to

[[NetBSD]] -> [[Documentation]] -> [[Hardware]] -> [[...]]

for a web page in the hardware section.