Re: UTF-8 docs

From: Oleg Bartunov <obartunov(at)gmail(dot)com>
To: Tatsuo Ishii <ishii(at)sraoss(dot)co(dot)jp>
Cc: Jürgen Purtz <juergen(at)purtz(dot)de>, pgsql-docs(at)postgresql(dot)org, Victor Wagner <vitus(at)wagner(dot)pp(dot)ru>
Subject: Re: UTF-8 docs
Date: 2016-08-24 07:27:17
Message-ID: CAF4Au4ziMiPP0jWHiqai8_-g6Eg2b_jjD_zPNJHu5kGd_-g6tw@mail.gmail.com
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-docs

On Wed, Aug 24, 2016 at 2:04 AM, Tatsuo Ishii <ishii(at)sraoss(dot)co(dot)jp> wrote:
>> Arguments pro and contra diagrams are not the central focus of SGML to
>> XML conversion, nevertheless: "Diagrams" didn't mean any binary format
>> - only SVN or any other text-format is acceptable. And: if the SVN
>> source is generated by any program like Inkscape it tends to get
>> unreadable. But if we develop a SVN-library with our own predefined
>> graphical elements, the SVN source gets very clear. The discussion of
>> 2011 mentioned below was continued in 2016:
>> https://www.postgresql.org/message-id/5690218B.9060103%40purtz.de.
>
> Oh I didn't know that. Thank you for pointing it out. I hope this work
> will be included in 10.0.

We discussed diagrams in docs at PGCon-2016. Heikki's attempt is here
https://wiki.postgresql.org/wiki/Figures_%26_Pics_in_Docs and Emre
made even better using markdeep https://casual-effects.com/markdeep/
I attached his version and it looks very interesting (open it in firefox).

Diagrams made in this way don't need any new tools to learn.

Oleg
>
> Best regards,
> --
> Tatsuo Ishii
> SRA OSS, Inc. Japan
> English: http://www.sraoss.co.jp/index_en.php
> Japanese:http://www.sraoss.co.jp
>
>
> --
> Sent via pgsql-docs mailing list (pgsql-docs(at)postgresql(dot)org)
> To make changes to your subscription:
> http://www.postgresql.org/mailpref/pgsql-docs

Attachment Content-Type Size
gin-ascii-v2.md(1).html text/html 3.8 KB

In response to

Browse pgsql-docs by date

  From Date Subject
Next Message Alexander Law 2016-08-24 10:17:25 Re: Incorrect 'literal' tags
Previous Message Alexander Law 2016-08-24 07:13:38 Re: UTF-8 docs