Karsten Wade wrote:
On Wed, 2004-09-15 at 15:12, Paul W. Frields wrote:
>I see your point, Tammy, but my feeling would be to opt for only two (or
>three) subheadings under the current "Docs" nav bar entry:
> by Title
> by FC Release
>*This would be that extra structure I mentioned; not really a FAQ, but
>an organization of questions that would link to the Title index.
I.e., "by Title" expands to have a list of all documents by title in
alpha order, and "by FC Release" expands to a short list of release
numbers, which then expand to a set of document titles that are just
part of that release?
One immediate problem I see is a maintenance nightmare. As much as we
would like to have a CMS, this is currently a manual process.
FWIW, if you built the site with the DocBook Website DTD &
stylesheets, the expanding ToC/navbar gets generated automatically.
(I wrote the dbwebsite code for that turns/expands the icons.) And
the really nice thing is that the source content of the site is -
you guessed it - XML:)
Doubt that the resources exist presently for a site rebuild based on
the DocBook Website package, but it may be worth investigating for
the long term.
Sites built from this package are ubiquitous. (Dave Pawson's is a
case in point, though he uses a horizontal ToC/navbar:)
A good example of the kind of navbar/ToC expansion you're talking
about is at http://docbook.org
. Click on the 'schema' link on the
navbar to see how the ToC expands and the icons flip to provide some
visual cues as to the present navigational context.
It wouldn't be too difficult to reproduce the current Fedora site
look-n-feel by customizing the website stylesheets, if someone had
the time & energy to do it.
Maintaining a website by hand-coding HTML is a painful process, but
'sounds like it's the best we've got for now.
to focus on a simple structure that works, and let Google do the
indexing for us. :)
Mark Johnson <mjohnson(a)redhat.com>
OS Product Documentation
Engineering, Red Hat, Inc. <http://www.redhat.com>
Tel: 919.754.4151 Fax: 919.754.3708
GPG fp: DBEA FA3C C46A 70B5 F120 568B 89D5 4F61 C07D E242