discuss: New author questions
Subject:
Re: New author questions
From:
"Greg Ferguson" ####@####.####
Date:
24 Jan 2001 14:13:18 -0000
Message-Id: <10101240908.ZM26516@hoop.timonium.sgi.com>
On Jan 23, 8:12pm, Gregory Leblanc wrote:
> Subject: Re: New author questions
> On 23 Jan 2001 20:42:18 -0500, Eric Kidd wrote:
> > Hello! It's me again, with more silly questions. I'm trying to modify
> > my HOWTO so it can be rendered by ldp.dsl.
> >
> > * My XML-RPC HOWTO is currently a DocBook XML 4.1.2 <book>. Should
> > I turn it into an <article> before submitting it to the LDP?
>
> As Josh said, book is fine.
<book> is ok, <article> is better. If the doc is a HOWTO, then
<article> is *probably* more appropriate. Also, some/many of the
ldp.dsl customizations center around the <article> container element.
> >
> > * ldp.dsl#print removes <legalnotice> sections from rendered
> > documents. This is not desirable. Should I work around this
> > breakage by moving all my legal notices into a regular
> > <section> somewhere?
>
> Uhm, this is a bad thing. :) Let me look and see if I can't easily
> re-enable this, and get it into production use. It doesn't make sense
> to be stuck with all kinds of extra markup when there is a tag designed
> for this purpose.
I agree, but I didn't touch that area that I can recall. It must
be the default processing path. Perhaps I need to turn that *on*.
Let me look into it.
> > * Is there a way to make <ulink> tags into PDF hyperlinks? For some
> > reason, I vaguely remember Jade doing this at one point, but
> > I could be mistaken.
>
> Sure, but I don't think that James's DSSSL engine can do it natively.
> Try converting to a single HTML file (-V nochunks on the jade command
> line), then passing it through htmldoc. (do a google search on htmldoc,
> it'll turn up). That gives you <emphasis>internal</emphasis> linking.
> External links are harder, as I don't think PDF supports linking between
> documents.
What he said. :-)
--
Our processing uses htmldoc against a single-file HTML instance to
create Postscript and PDF variants. There is an intermediate filtering
step applied to the single-file prior to sending it to htmldoc.
r,
--
Greg Ferguson - s/w engr / mtlhd | gferg at sgi.com
SGI Tech Pubs - http://techpubs.sgi.com/ |
Linux Doc Project - http://www.linuxdoc.org/ | gferg at metalab.unc.edu