Re: Figures in docs - Mailing list pgsql-hackers

From Ioseph Kim
Subject Re: Figures in docs
Date
Msg-id 1455704267.3810.24.camel@ioseph-centos
Whole thread Raw
In response to Figures in docs  (Tatsuo Ishii <ishii@postgresql.org>)
List 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.




pgsql-hackers by date:

Previous
From: Robert Haas
Date:
Subject: Re: ALTER ROLE SET/RESET for multiple options
Next
From: Masahiko Sawada
Date:
Subject: Re: ALTER ROLE SET/RESET for multiple options