Re: Docbook 5.x - Mailing list pgsql-docs

From Peter Eisentraut
Subject Re: Docbook 5.x
Date
Msg-id b4f74ac9-09ba-d198-092b-e2bfbf1c0194@2ndquadrant.com
Whole thread Raw
In response to Re: Docbook 5.x  (Alexander Law <exclusion@gmail.com>)
Responses Re: Docbook 5.x
List pgsql-docs
On 8/19/16 9:14 AM, Alexander Law wrote:
> The next items in our plan were:

An immediate problem is that the patched stuff no longer works with
older stylesheets (1.76.1?).  I'm glad to leave older stuff behind for a
400% speedup, but we need to analyze the exact effect and possibly
document it or work around it.

> - Wait a while to make sure everyone is happy with the performance. Keep
> tweaking if necessary.
> - Port all DSSSL customizations to XSLT.  Manually evaluate output for
> quality.
>
> Should we now compare DSSSL outputs with XSLT?
> I had some success with it before. See my letter:
> https://www.postgresql.org/message-id/57712848.7060306%40gmail.com
> Those xslt's (see xhtml-like-dsssl.patch) can help us to see all the
> differences and to decide which customizations to keep.

It looks like the idea there is to whack the XSLT stylesheets until the
output looks exactly like the DSSSL output?  I'm not sure that's
terribly useful.  It would probably be a lot of work, which we'll just
end up removing eventually.  I'd rather just fix any formatting issues
we find and move forward.

--
Peter Eisentraut              http://www.2ndQuadrant.com/
PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services


pgsql-docs by date:

Previous
From: Alexander Law
Date:
Subject: UTF-8 docs
Next
From: Barbara Sims
Date:
Subject: Re: A broken link