Re: Figures in docs

From: Ioseph Kim <pgsql-kr(at)postgresql(dot)kr>
To: Alexander Lakhin <a(dot)lakhin(at)postgrespro(dot)ru>
Cc: Tatsuo Ishii <ishii(at)postgresql(dot)org>, obartunov(at)gmail(dot)com, 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 10:17:47
Message-ID: 1455704267.3810.24.camel@ioseph-centos
Views: Raw Message | Whole Thread | Download mbox | Resend email
Thread:
Lists: pgsql-hackers

On 수, 2016-02-17 at 12:14 +0300, Alexander Lakhin wrote:
> 17.02.2016 09:17, Tatsuo Ishii wrote:
> >> Hi.
> >>
> >> In DocBook 4.2 sgml dtd, figure tag is supported already.
> >> that was implemented for multi output format.
> > Ok, there's no technical problems with figures then. MySQL docs has
> > some nice figures. I am jealous.
> The "figure" tag is just a placeholder in the Docbook
> (http://www.docbook.org/tdg/en/html/figure.html).
> The question is what to place inside this tag: "graphic" (not inline),
> "mediaobject/imageobject" (alternative object, supports inline contents
> and SVG), or something else.
> So you surely can insert some picture from an external file (.png,
> .jpg), but if it could contain title or some labels that should be
> translated, it's not a best solution.

I want say, just about figure tag.
sgml document can include external image file.

in sgml

<para>
<figure>
<title>Some Image</title>
<graphic fileref="images/some_image.jpg">
</figure>
</para>

then make html command generate below html code

<P
> <DIV
CLASS="FIGURE"
><A
NAME="AEN126265"
></A
><P
><B
>Figure E-1. Some Image</B
></P
><P
><IMG
SRC="images/some_image.jpg"></P
>

so,
I asked how maintenance that some_image.jpg file.
I think that is so difficult, because new release document might change
these too.
if use svg module for docbook, document sources will are maked very
dirty.

In response to

Browse pgsql-hackers by date

  From Date Subject
Next Message Masahiko Sawada 2016-02-17 10:23:34 Re: ALTER ROLE SET/RESET for multiple options
Previous Message Robert Haas 2016-02-17 10:14:50 Re: ALTER ROLE SET/RESET for multiple options