Re: documentation is now XML - Mailing list pgsql-hackers

From Alexander Lakhin
Subject Re: documentation is now XML
Date
Msg-id b8f7a661-aac5-aed1-d08b-7e1cbcf40dfb@gmail.com
Whole thread Raw
In response to Re: documentation is now XML  (Bruce Momjian <bruce@momjian.us>)
Responses Re: documentation is now XML
List pgsql-hackers
20.06.2018 15:03, Bruce Momjian wrote:
On Wed, Jun 20, 2018 at 10:48:47AM +0300, Liudmila Mantrova wrote:
It's unfortunate that we'll have to deal with different formats in the
supported branches for several more years, but we at Postgres Professional are
ready to accept any your decision on this matter for now.
I had not thought of translations, but wouldn't all translations also
need to switch from SGML to XML for back branches?  That would be a lot
of work.

Hello Bruce,

I think there are two approaches here. First, if translation is performed directly in sgml (say, we have adminpack_fr.sgml), we'd have to convert the existing translation files to XML anyway - otherwise we'll have to start translating version 11 from scratch. So some tools/scripts are needed to perform the conversion. I don't think it would be difficult to use these tools to convert existing translation for version 10 (and 9.6, 9.5...) to XML and to continue working with it. And after the conversion is done we could maintain all the translations in a consistent way, using a single tool.

Second, if translation is performed indirectly, via the PO (as we do, e.g. see [1]), then the conversion is a matter of automatic producing .po from xml. We see no difficulties with it either.

So I see no extra work for translators as a consequence of backporting XML format except for reusing some tools, which are needed anyway.

[1] https://github.com/alexanderlaw/pg-doc-ru/blob/master/postgresql-doc/adminpack.po


Best regards,
------
Alexander Lakhin
Postgres Professional: http://www.postgrespro.com
The Russian Postgres Company

pgsql-hackers by date:

Previous
From: Ashutosh Bapat
Date:
Subject: Re: Server crashed with TRAP: FailedAssertion("!(parallel_workers >0)" when partitionwise_aggregate true.
Next
From: Bruce Momjian
Date:
Subject: Re: documentation is now XML