Re: Figures in docs

From: Alexander Lakhin <a(dot)lakhin(at)postgrespro(dot)ru>
To: Tatsuo Ishii <ishii(at)postgresql(dot)org>, obartunov(at)gmail(dot)com
Cc: p(dot)luzanov(at)postgrespro(dot)ru, pgsql-hackers(at)postgresql(dot)org, peter_e(at)gmx(dot)net
Subject: Re: Figures in docs
Date: 2016-02-17 06:10:47
Message-ID: 56C40EE7.9020601@postgrespro.ru
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

Hello,

In fact we use "make postgres.xml" to get a single XML, which we translate.
We convert it to .po using xml2po (with some modifications), and then
convert it back to xml (and then to sgml files with our custom script).
So we have not changed sgml to xml files, and if it's more appropriate
than having a single large XML, then we will propose a procedure to
perform such conversion (that will result in corresponding mega patch).

Best regards,
Alexander Lakhin

17.02.2016 08:41, Tatsuo Ishii пишет:
>> On Wed, Feb 17, 2016 at 4:17 AM, Tatsuo Ishii <ishii(at)postgresql(dot)org> wrote:
>>
>>> It seems there's no figures/diagrams in our docs. I vaguely recall that
>>> we used to have a few diagrams in our docs. If so, was there any
>>> technical reason to remove them?
>>>
>> I don't know the reason, but it's shame, we are still in sgml !
>>
>> We already do our translations (as others) in xml using custom scripting.
>> xml provides us better integration with available tools and ability to
>> insert graphics. Last time we asked in -docs about moving to xml and
>> Alexander demonstrated acceptable speed of xml build, but there were no
>> reply from Peter, who is (?) responsible for our documentation
>> infrastructure. Probably, we should just created a patch and submit to
>> commitfest. You can check this thread
>> http://www.postgresql.org/message-id/1428009501118.85114@postgrespro.ru
> Well, there are some PostgreSQL doc translation projects are running
> including translation for Japanese, which I am working on.
>
> If we are going to change the manual format and/or the build system, I
> need to confirm it does work for Japanese as well. In theory because
> the Japanese translation project uses UTF-8, there should be no
> problem as far as the whole build system works for UTF-8. But I want
> to confirm first...
>
> BTW, are you going to propose a mega patch which changes all the sgml
> files to xml files?
>
> Best regards,
> --
> Tatsuo Ishii
> SRA OSS, Inc. Japan
> English: http://www.sraoss.co.jp/index_en.php
> Japanese:http://www.sraoss.co.jp

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message Michael Paquier 2016-02-17 06:12:58 Re: Bug in StartupSUBTRANS
Previous Message Ioseph Kim 2016-02-17 06:03:53 Re: Figures in docs