This is the mail archive of the
docbook-apps@lists.oasis-open.org
mailing list .
Re: [docbook-apps] DocBook/XML --> [tgn]roff
- From: "Dennis Grace" <dgrace at us dot ibm dot com>
- To: Yann Dirson <ydirson at fr dot alcove dot com>
- Cc: docbook-apps at lists dot oasis-open dot org, Sam Steingold <sds at gnu dot org>
- Date: Fri, 25 Apr 2003 09:05:23 -0500
- Subject: Re: [docbook-apps] DocBook/XML --> [tgn]roff
Hi Sam,
I agree with Yann and Tilly: the jade wrapper (docbook2man) won't work with
XML. In fact, docbook2man can just barely be said to work with SGML. It
relies on a fairly simple perl script, which does not institute even one
tenth of the functionality offered by the DocBook refentry subset.
I've had a good deal more luck with xslt and xsltproc. Honestly, you'll
find that even with xsltproc, the DocBook to man page XSLT has a few holes.
It won't handle tables and it chokes on nested lists. Otherwise, it works
fairly well.
Dennis Grace
Information Developer
IBM Linux Technology Center
(512) 838-3937 T/L 678-3937 cell: (512)-296-7830
dgrace at us dot ibm dot com
If God dropped acid, would He see people?
Yann Dirson
<ydirson at fr dot alcov To: Sam Steingold <sds at gnu dot org>
e.com> cc: docbook-apps at lists dot oasis-open dot org
Subject: Re: [docbook-apps] DocBook/XML --> [tgn]roff
04/25/2003 02:02
AM
On Fri, Apr 25, 2003 at 12:12:56AM -0400, Sam Steingold wrote:
> I have a man page which I maintain in both HTML and groff formats.
> I know that groff can output HTML, but I have some href links in the
> HTML which I would rather keep.
> So I want to switch to DocBook/XML for the page and produce both HTML
> and roff out of it.
> Have anyone done that?
>
> PS. docbook2man barfs with
>
nsgmls:<URL>http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd:112:17:E:
"X20AC" is not a function name
>
nsgmls:<URL>http://www.oasis-open.org/docbook/xml/4.2/ent/iso-amsa.ent:8:19:E:
"X21B6" is not a function name
>
nsgmls:<URL>http://www.oasis-open.org/docbook/xml/4.2/ent/iso-amsa.ent:9:19:E:
"X21B7" is not a function name
>
nsgmls:<URL>http://www.oasis-open.org/docbook/xml/4.2/ent/iso-amsa.ent:10:17:E:
"X21D3" is not a function name
Looks like the standard errors you get when dealing with an XML
document as if it were just an SGML document (ie. not providing the
SGML declaration for XML to the parser).
This tool probably only supports SGML DocBook right now. Note that
there are something like 3 different tools to do such a conversion.
--
Yann Dirson <Yann dot Dirson at fr dot alcove dot com>
http://www.alcove.com/
Technical support manager Responsable de l'assistance
technique
Senior Free-Software Consultant Consultant senior en Logiciels
Libres
Debian developer (dirson at debian dot org) Développeur
Debian
---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-apps-unsubscribe at lists dot oasis-open dot org
For additional commands, e-mail: docbook-apps-help at lists dot oasis-open dot org
---------------------------------------------------------------------
To unsubscribe, e-mail: docbook-apps-unsubscribe at lists dot oasis-open dot org
For additional commands, e-mail: docbook-apps-help at lists dot oasis-open dot org