Proposal: Image Tag Conventions

[Eric Baudais <baudais okstate edu>]

> --- Begin Message ---
> <figure id="id">
>   <title>Figure Description</title>
>   <screenshot>
>     <graphic fileref="path/to/images.png" format="PNG" srccredit="me">
>     </graphic>
>   </screenshot>
> </figure>
>
> This applies to all figures regardless of whether they are screenshots, 
> graphics, or other images.
>
> Proposal:
> We should have 3 different types of markup depending on whether the image 
> is a large figure, a small figure, or a screenshot.  This will utilize the 
> greater flexibility of DocBook 4.1.2 and specify the content of the images 
> more accurately.
>
> A large figure is a large image which isn't a screenshot.  This can be a 
> variety of images.  The markup for a large figure:
>
> <figure id="id">
>   <title>Figure Description</title>
>   <mediaobject>
>     <imageobject>
>       <imagedata fileref="path/to/image.png" format="PNG"/>
>     </imageobject>
>     <imageobject>
>       <imagedata fileref="path/to/image.eps" format="EPS"/>
>     </imageobject>
>     <textobject>
>       <phrase>Acessibility description</phrase>
>     </textobject>
>   </mediaobject>
> </figure>
>
> A small figure is a small image which isn't a screenshot.  This can be a 
> variety of things.  The markup for a small figure:
>
> <mediaobject id="id">
>   <imageobject>
>     <imagedata fileref="path/to/image.png" format="PNG"/>
>   </imageobject>
>   <imageobject>
>     <imagedata fileref="path/to/image.eps" format="EPS"/>
>   </imageobject>
>   <textobject>
>     <phrase>Acessibility description</phrase>
>   </textobject>
>   <caption>
>     <para>Description of the image.</para>
>   </caption>
> </mediaobject>
>
> A screenshot is an image which is taken of the desktop or of an application 
> or a dialog box.  The markup for a screenshot:
>
> <screenshot id="id">
>   <mediaobject>
>     <imageobject>
>       <imagedata fileref="path/to/image.png" format="PNG"/>
>     </imageobject>
>     <imageobject>
>       <imagedata fileref="path/to/image.eps" format="EPS"/>
>     </imageobject>
>     <textobject>
>       <phrase>Acessibility description</phrase>
>     </textobject>
>     <caption>
>       <para>Description of the screenshot.</para>
>     </caption>
>   </mediaobject>
> </screenshot>
>
> Eric Baudais
>
>
> --- End Message ---