[publican-list] image caption and image inside pdf

[Jeffrey Fearn]

Jeffrey Fearn wrote:
> David O'Brien wrote:
>> mbutubuntu wrote:
>>> Hello folks I've two questions for you:
>>>
>>> 1) how to create a caption for an image?
>>>
>>> 2) If I make an html documentation all images are "respected" in 
>>> their size, if I make a pdf all images are enlarged to fill all the 
>>> page (in the horizontal axis) why?
>>>
>>> thanks
>>>
>>> Fabio [mbutubuntu] Buda
>>>
>>> _______________________________________________
>>> publican-list mailing list
>>> publican-list at redhat.com
>>> https://www.redhat.com/mailman/listinfo/publican-list
>>> Wiki: https://fedorahosted.org/publican
>> Ciao Fabio, come va?
>>
>> How are you adding images to your xml? I use the following as a 
>> template, and the text I include as the title becomes the caption for 
>> the image:
>> <figure>
>> <title></title>
>> <mediaobject>
>> <imageobject>
>> <imagedata fileref="./images/<filename>.png" format="PNG" scalefit="1" />
>> </imageobject>
>> </mediaobject>
>> </figure>
>>
>> For an example, refer to the following page:
>> http://freeipa.org/docs/1.2/Administration_Guide/en-US/html/chap-Administration_Guide-Configuring_Users_and_Groups.html 
>>
>> Is that the effect you are trying to achieve? (Bear in mind these docs 
>> were produced with an earlier version of publican, but that shouldn't 
>> matter.)
>>
>> Most of the images I use are of a web interface, and consequently use 
>> most of the page width anyway. Perhaps somebody else on the list can 
>> help with this?
> 
> You can add a real caption as well as a title.
> 
> <figure>
>   <title>The Figure of DOOM</title>
>   <mediaobject>
>     <imageobject>
>       <imagedata fileref="images/DOOM.png" />
>     </imageobject>
>     <caption>
>       <para>
>         Doom is upon us, repent!.
>       </para>
>   </caption>
>  </mediaobject>
> </figure>
> 
> Example at http://www.docbook.org/tdg/en/html/imageobject.html
> 
> Cheers, Jeff.

Oh yeah, you should use a textobject so the HTML is section 508 
compliant. The textobject is used as the ALT text for the HTML IMG. 
Other countries have similar legislation.


<figure>
   <title>The Figure of DOOM</title>
   <mediaobject>
     <imageobject>
       <imagedata fileref="images/DOOM.png" />
     </imageobject>
     <textobject>
       <phrase>An image of Mr Doom</phrase>
     </textobject>
     <caption>
       <para>
         Doom is upon us, repent!.
       </para>
   </caption>
  </mediaobject>
</figure>


-- 
Jeff Fearn <jfearn at redhat.com>
Software Engineer
Engineering Operations
Red Hat, Inc
Freedom ... courage ... Commitment ... ACCOUNTABILITY