Re: documentation is now XML

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