Re: Proposal: Image Tag Conventions

[Alexander Kirillov <kirillov math sunysb edu>]

There is one minor problem with this: you can not refer to <screenshot>
using <xref>. If you try, you get error message 

No template named "screenshot" exists in the context named "title" in
the "en" localization.
Don't know what gentext to create for xref to: "screenshot", ("id")

and the HTML output will contain link to the screenshot looking like <a
href="documenturl#id">???</a>


Thus, we either need to put <screenshot> inside <figure> wrapper (if we
want it to be numbered as "Figure *.*") - which is becoming rather
cumbersome - or use <ulink> to refer to it, e.g.  

...shown in <ulink linkend="id">screenshot</ulink> below

Sasha

On Tue, 2001-10-23 at 15:49, Eric Baudais wrote:

> 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
> _______________________________________________
> gnome-doc-list mailing list
> gnome-doc-list gnome org
> http://mail.gnome.org/mailman/listinfo/gnome-doc-list