MIME-Version: 1.0
Reply-To: obartunov@gmail.com
In-Reply-To: <30d7e365-cd3b-aae0-a8ac-7b880f26413d@2ndquadrant.com>
References: <1914747379.117313.1519402446241.JavaMail.zimbra@dbi-services.com>
 <2264.1519402888@sss.pgh.pa.us>
 <30d7e365-cd3b-aae0-a8ac-7b880f26413d@2ndquadrant.com>
From: Oleg Bartunov <obartunov@gmail.com>
Date: Sat, 24 Feb 2018 21:45:16 +0300
Message-ID: 
 <CAF4Au4xJpUkb6SypY2SLxvr4rBuM5eAc5ra4PNZcD5kDNbQzgw@mail.gmail.com>
Subject: Re: Images in the official documentation
To: Peter Eisentraut <peter.eisentraut@2ndquadrant.com>
Cc: Tom Lane <tgl@sss.pgh.pa.us>,
	Daniel Westermann <daniel.westermann@dbi-services.com>,
 pgsql-docs@lists.postgresql.org
Content-Type: text/plain; charset="UTF-8"
Precedence: bulk

On Sat, Feb 24, 2018 at 4:04 AM, Peter Eisentraut
<peter.eisentraut@2ndquadrant.com> wrote:
> On 2/23/18 11:21, Tom Lane wrote:
>> In the distant
>> past, as I recall, we had a GIF or two; but we abandoned that on the
>> grounds that it was unmaintainable and also incompatible with some
>> documentation output formats.  I'm not too sure what the state of
>> play is on the latter point, now that we've switched to XML.
>
> The complications with the image formats in the past were mainly around
> what ((pdf)jade)tex would accept.  The tools have shifted a bit now, and
> the zoo formats is a different one.  Nothing that a few make rules
> couldn't address, though, I think.
>
> The issue of how to manage the sources is still the same, though.

SVG format is ascii based vector format. We made experimental pdf with pictures
http://www.sai.msu.su/~megera/postgres/files/postgres-11-diagram.pdf
(GIN AM diagram, Appendix L).

Appendix L also demonstrates our sample database with step-by-step
introduction to Postgres for beginners.  We have a separate book for beginners,
which we released under BSD license and  it's available on
russian/english languages.
Our experience shows, that people really appreciate it. I hope we will
have time at PGCon
to discuss documentation somehow.

>
> --
> Peter Eisentraut              http://www.2ndQuadrant.com/
> PostgreSQL Development, 24x7 Support, Remote DBA, Training & Services
>