Subject: better HTML
To: docs <netbsd-docs@netbsd.org>
From: James K. Lowden <jklowden@schemamania.org>
List: netbsd-docs
Date: 11/30/2003 14:11:21
I use meta-pkgs/netbsd-doc to convert DocBook -> HTML.  I've noticed that
other people get nicer HTML than I do from the same sources.  Does anyone
know what we need to upgrade to get their output?  

Specifically, I'm talking about two things:

1.  For <note>, <tip>, and <warning> other converters will include little
gifs of a hand pointing a finger, or a yield sign, and so on.  Much
prettier to look at than text.  

2.  In generating names of HTML pages, other converters will use the
section's "id" attribute, if present, to form the name.  Ours insists on
names like "a2698.htm".  

I've been living with these shortcomings, but I've found out that Google
is indexing some pages I've written [1].  If people are finding them
useful, I'd like to control their names, the better not to break the links
when the document is updated.  

I'm pretty sure this is a style-sheet issue, but I've never been able to
sort it out.  The documentation I find is mostly about how to find/use
style-sheets.  Beneath that is general-purpose DSSSL discussion, which I
find almost inpenetrable (and, thus, hard to apply).  

If anyone knows what needs to be done, I'd be interested in doing it. 
Thanks.  

--jkl

[1] If you plug "unicode UCS-2 UTF-8" into Google, the 3rd entry returned
is http://www.freetds.org/userguide/a2698.htm