Bug#144109: want to maintain docbook-book?

[Yann Dirson <ydirson@altern.org>]

[CC'd to the wnpp bug for the record]

On Mon, May 13, 2002 at 02:23:32PM -0800, Britton wrote:
> 
> Good deal.  I'll have a loot at your package next time I need t owrite new
> documentation.  Who knows, maybe you'll find out how to make all the
> symbols show up in the html version :)

It will be quite tricky :)

My status:

- we can't use the provided build mechanism, as it would build-depend on
saxon (contrib) - bad deal

- everything is not dealt with in the provided built mechanism AFAICT - I
still have to run saxon using it :) - anyway, Norm told me that the build
machanism was incomplete

- I could produce an HTML version using Norm's dsssl stylesheets, but it
lacks index (I had to investigate how collateindex.pl works, for sgml2x,
anyway), doesn't have crosslinks between elements/entities/etc, doesn't do
anything with version attributes (those shown in ToC with version glyphs),
and probably a good deal of other things.

So here are my plans:

- try to see whether the saxon built mechanism actually does something

- investigate collateindex and add support for it in sgml2x (I had planned
to do this post-1.0, but hey, that's life ;)

[update: actually started this one - existing support for HTML only it
seems.  Bah, that's the minimum we want.]

- write a small customisation layer over Norm's html/docbook.dsl, to handle
the specificities of the defguide, and another one in between for
general-usage (in the spirit of what I did for bookarticle.dsl (see
alcovebook package)

- write a nice CSS that will format the HTML in a pretty way

If you have any ideas, just express them :)

-- 
Yann Dirson    <ydirson@altern.org> |    Why make M$-Bill richer & richer ?
Debian-related: <dirson@debian.org> |   Support Debian GNU/Linux:
Pro:    <yann.dirson@fr.alcove.com> |  Freedom, Power, Stability, Gratuity
     http://ydirson.free.fr/        | Check <http://www.debian.org/>


-- 
To UNSUBSCRIBE, email to debian-wnpp-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org