Re: Docbook 5.x

From: Alvaro Herrera <alvherre(at)2ndquadrant(dot)com>
To: Jürgen Purtz <juergen(at)purtz(dot)de>
Cc: pgsql-docs(at)postgresql(dot)org
Subject: Re: Docbook 5.x
Date: 2016-05-04 15:18:48
Message-ID: 20160504151848.GA100795@alvherre.pgsql
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

Jürgen Purtz wrote:

> I measured following elapsed times on an Intel i5 processor:
>
> 1. generate all HTML files with dsl script (make html): 0:48 min.
> 2. generate all HTML files with xslt script (make xslthtml): 16:01 min.
> 3. generate all HTML files with xslt script in the new environment
> (pure Docbook5): 4:07 min.
> 4. Generating different things via dsl scripts in the new environment
> may be possible. But the changelog of the Docbook5 dsl scripts
> shows, that the last modification occurred in 2004 - this way is a
> dead end.

Thanks.

The dsl toolchain has a "make html" format which creates the index and a
"make draft" that doesn't. You timed the former only. What's the
timing for an equivalent of "make draft" in the xslt chain? If it
exists and is short enough, it seems acceptable to me that the complete
(with index) build takes ~4x as long as today; the draft timing is more
critical, I would think.

Man pages are already generated using xslt, so I suppose that wouldn't
change. PDF creation timing is also critical.

FWIW, in my laptop "make draft" takes 1m18.788s and a "make html"
takes 1m26.676s. So it's just 8 seconds to generate the SGML file for
the index, and no reruns required ... hmm. I think I'm gonna forget
about "make draft" in the future.

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

In response to

Responses

Browse pgsql-docs by date

  From Date Subject
Next Message Alvaro Herrera 2016-05-04 15:21:58 Re: Docbook 5.x
Previous Message Alexander Law 2016-05-04 15:08:57 Re: Docbook 5.x