Re: Can extension build own SGML document? - Mailing list pgsql-hackers

From Tom Lane
Subject Re: Can extension build own SGML document?
Date
Msg-id 3334.1442329985@sss.pgh.pa.us
Whole thread Raw
In response to Re: Can extension build own SGML document?  (Jim Nasby <Jim.Nasby@BlueTreble.com>)
Responses Re: Can extension build own SGML document?  (Jim Nasby <Jim.Nasby@BlueTreble.com>)
List pgsql-hackers
Jim Nasby <Jim.Nasby@bluetreble.com> writes:
> On 9/15/15 8:43 AM, Tom Lane wrote:
>> AFAICT from a quick look at its documentation, asciidoc can produce
>> either html or docbook output; so as soon as you want something other
>> than html output (in particular, PDF), you're back to relying on the
>> exact same creaky docbook toolchain we use now.  Only with one extra
>> dependency in front of it.

> a2x (http://www.methods.co.nz/asciidoc/a2x.1.html) states that it can 
> generate "PDF, EPUB, DVI, PS, LaTeX, XHTML (single page or chunked), man 
> page, HTML Help or plain text formats using asciidoc(1) and other 
> applications (see REQUISITES section). SOURCE_FILE can also be a DocBook 
> file with an .xml extension."

AFAICS, for all cases other than HTML output, the "other applications"
are basically the docbook toolchain.

> What I expect would be a lot more effort is actually converting all the 
> SGML to asciidoc. A quick google search doesn't turn up anything promising.

Yeah, the cost of conversion means we're not likely to want to experiment
to see what's better :-(.
        regards, tom lane



pgsql-hackers by date:

Previous
From: Jim Nasby
Date:
Subject: Re: Can extension build own SGML document?
Next
From: Stephen Frost
Date:
Subject: Re: [DOCS] Missing COMMENT ON POLICY