Received: from malur.postgresql.org ([217.196.149.56]) by arkaria.postgresql.org with esmtp (Exim 4.84_2) (envelope-from ) id 1axy2c-0002nX-NV for pgsql-docs@arkaria.postgresql.org; Wed, 04 May 2016 14:44:42 +0000 Received: from localhost ([127.0.0.1] helo=postgresql.org) by malur.postgresql.org with smtp (Exim 4.84_2) (envelope-from ) id 1axy2c-000576-9s for pgsql-docs@arkaria.postgresql.org; Wed, 04 May 2016 14:44:42 +0000 Received: from magus.postgresql.org ([2a02:c0:301:0:ffff::29]) by malur.postgresql.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_CBC_SHA384:256) (Exim 4.84_2) (envelope-from ) id 1axy2b-00056F-9h for pgsql-docs@postgresql.org; Wed, 04 May 2016 14:44:41 +0000 Received: from mout.kundenserver.de ([212.227.126.133]) by magus.postgresql.org with esmtps (TLS1.2:DHE_RSA_AES_256_CBC_SHA256:256) (Exim 4.84_2) (envelope-from ) id 1axy2X-0001Oy-Fz for pgsql-docs@postgresql.org; Wed, 04 May 2016 14:44:40 +0000 Received: from [192.168.178.26] ([84.165.197.170]) by mrelayeu.kundenserver.de (mreue005) with ESMTPSA (Nemesis) id 0Lo5Nc-1bZViF0rBQ-00fwVF for ; Wed, 04 May 2016 16:44:35 +0200 Subject: Re: Docbook 5.x To: pgsql-docs@postgresql.org References: <57179283.6080704@purtz.de> <20160503193441.GA61759@alvherre.pgsql> From: =?UTF-8?Q?J=c3=bcrgen_Purtz?= Message-ID: <572A0AD2.2070909@purtz.de> Date: Wed, 4 May 2016 16:44:34 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:38.0) Gecko/20100101 Thunderbird/38.7.2 MIME-Version: 1.0 In-Reply-To: Content-Type: multipart/alternative; boundary="------------040608050809060507060704" X-Provags-ID: V03:K0:VFArZSpWJY5e0skBJ5EOo/PkNW6G1zXr7HIaEwiPCfTud0OI9IU ybKABDgOQMs+0E5pPMc6ZB/Pu9LGKOfbLPyBZqc/ykEopVBlEixu2Zs0RNagl1nA3NfF6kH kEQ5x+K/I1lj/OwASRlRwv2aJVby9szkWDJ5bWwnMdTh9L4HunrCmcgYjSSAjw8s5nDu7cn B7db/GQX8J5B50Rr2fuAA== X-UI-Out-Filterresults: notjunk:1;V01:K0:WMUk1UgzxJA=:om6WKZ6pmFEOB12crKoOKB OsphBmWxw43qVjH4Qlqz4GUMmHpk+LpeBj1YifFA/jTsuM/MGy0JMCUnOhj0cy3KYcoU45+Jv TarMcRmiJcHMtP/5oD44ShCzX1AIi4O4S7JYvCCvzxkOdiuXg5l/AZ/NZoQgw51g9Cs8DwMtv WFyliEACieUt4/C4VzJma6wk4hW5pQ3VSzpDKHflLnDDowaA4bwUUDh8o/xDgEx7fpl5huszl ES+tniOrXt5yBytUyphWmxhSucuUkwgzRrD9bwyPjNGxACwTAyp2Gegel9BRsWJLpUqQV/0pc OPWKHSoNcj1DkVOe1CtrbNEbyS7QCkEZoZMjj9QoV9j9vP1/k98ICgsmMplVV04dsI/4MAx5r XnA0EnZZysyyiFxQxRY9YDU1S6xoWan1plQOzHeTDZWjbzET9WbD2ClQwkbNhqmeR9iYclfQ7 ECnkwjTf7EfkQ+ZaRLs4wJe/bsMy6Jvy903K2UBvhTQdcTjjr1DLJekF/bhrbFmu0ouMh0/jk bq4KUKjUwWxwQLI8H4W8166/hxf10vnY4e87qk/lk8Gw1C7/icq6B2ZBM6GhxKb8KikGVgHZi nvBkPRA+UswmQVHHSTSb/11oMvQFfgBhVJcOkGIfXblKyhNx5q6SZdrz6MH3fpTt3IWLNtB4Q AxnHaiaVzGbVNzkLKuej9/OmkTx5L4czVAL6scl/+lJ+5C1ViKRRvQLXjJIdod7NqNTPT8JYV MRXqczcxIYc8apCG X-Pg-Spam-Score: -2.6 (--) List-Archive: List-Help: List-ID: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: X-Mailing-List: pgsql-docs Precedence: bulk Sender: pgsql-docs-owner@postgresql.org This is a multi-part message in MIME format. --------------040608050809060507060704 Content-Type: text/plain; charset=utf-8; format=flowed Content-Transfer-Encoding: 8bit Hello, 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. There is one principle and a lot of minor differences between 2 and 3. Solution 2 is based on an xml-file and xslt scripts which are based on Docbook4. The basic difference to 3 is, that in 3 everything is Docbook5 compliant: there are only Docbook5 xml- and xslt-files (as my workflow is: db4 --> xml --> db5 -- (db5 xslt) --> html). The minor differences concerns the fact, that actually there are errors in my xml files and that I made only a few parameterisation to the Docbook5 standard xslt files - no optimization at all. I used following tools: perl, xmllint and xsltproc. osx and OpenJade are obsolete in the new environment (so far, there is much more work to do). Jürgen Purtz On 03.05.2016 22:13, Oleg Bartunov wrote: > > > On Tue, May 3, 2016 at 10:34 PM, Alvaro Herrera > > wrote: > > Jürgen Purtz wrote: > > Hi, > > actually we use DocBook V4.2 for the PostgreSQL manuals. I > suggest an > > upgrade to DocBook 5.x. This sounds simple, but it will be a > long process > > with many sub-tasks. > > Yes, agreed. The killer objection placed last time was that it took > something like 10x longer to generate the HTML using the XML-based > toolchain than the SGML-based ones. If this is not fixed, let's > forget > about this whole thing until it is. So, would you time the process > using both toolchains and report back? > > > As it stated in > http://www.postgresql.org/message-id/562E061B.1090809@postgrespro.ru > the xml performance may be greatly improved. Alexander, what is > current state of art of your patch ? How slow is xml in compare to sgml ? > > > > -- > Álvaro Herrera http://www.2ndQuadrant.com/ > PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services > > > -- > Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org > ) > To make changes to your subscription: > http://www.postgresql.org/mailpref/pgsql-docs > > --------------040608050809060507060704 Content-Type: text/html; charset=utf-8 Content-Transfer-Encoding: 8bit Hello,

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.
There is one principle and a lot of minor differences between 2 and 3. Solution 2 is based on an xml-file and xslt scripts which are based on Docbook4. The basic difference to 3 is, that in 3 everything is Docbook5 compliant: there are only Docbook5 xml- and xslt-files (as my workflow is: db4 --> xml --> db5 -- (db5 xslt) --> html). The minor differences concerns the fact, that actually there are errors in my xml files and that I made only a few parameterisation to the Docbook5 standard xslt files - no optimization at all.

I used following tools: perl, xmllint and xsltproc. osx and OpenJade are obsolete in the new environment (so far, there is much more work to do).

Jürgen Purtz



On 03.05.2016 22:13, Oleg Bartunov wrote:


On Tue, May 3, 2016 at 10:34 PM, Alvaro Herrera <alvherre@2ndquadrant.com> wrote:
Jürgen Purtz wrote:
> Hi,
> actually we use DocBook V4.2 for the PostgreSQL manuals. I suggest an
> upgrade to DocBook 5.x. This sounds simple, but it will be a long process
> with many sub-tasks.

Yes, agreed.  The killer objection placed last time was that it took
something like 10x longer to generate the HTML using the XML-based
toolchain than the SGML-based ones.  If this is not fixed, let's forget
about this whole thing until it is.  So, would you time the process
using both toolchains and report back?
the xml performance may be greatly improved. Alexander, what is current state of art of your patch ? How slow is xml in compare to sgml ?
 


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


--
Sent via pgsql-docs mailing list (pgsql-docs@postgresql.org)
To make changes to your subscription:
http://www.postgresql.org/mailpref/pgsql-docs


--------------040608050809060507060704--