Re: [PEAR-DOC] PEAR new Manual built with PhD : docbook tag relatedto picture

Christian Weiske a écrit :
> Hello Laurent,
> 
> 
>> I want to know if Docbook tags related to pictures are allowed (and 
>> supported by PhD) in future PEAR Manual.
> PhD kind of supports them - they get rendered into <img> tags.
> 
>> Can we use something like :
>>
>>        <figure>
>>         <title id="package.html.html-css.blahblah.caption">
>>          Rule set structure
>>         </title>
>>         <screenshot>
>>          <graphic format="gif" fileref="img/rule.gif"/>
>>         </screenshot>
>>       </figure>
>> Question behind:
>> If images are allowed, where should we put them (in peardoc
>> structure) ?
> I did not try this out yet.
> 

> 
> To come back to your question, Laurent:
> - Images are on the agenda for the new manual.
> - Support is not available yet
> - It will be available soon, after discussion [TM]
> 

Hello Christian,

I come back to you to give a precision.

While I'm near to finish to migrate TDG of 
HTML_Quickform_advmultiselect, and especially the Appendixes where there 
are all examples with screenshots, I discovered a capital information.

<screenshot>
   <graphic format="gif" fileref="img/rule.gif"/>
</screenshot>

This format was supported by Docbook 4 , but no more with Docbook 5.

Instead we could use this one: <screenshot> + <mediaobject>

   <para>
    <figure>
     <title 
xml:id="package.html.html-quickform-advmultiselect.appendix.examples-basic1-sscaption">Basic 
usage with default layout</title>
     <screenshot>
      <mediaobject>
       <alt>qfams_basic_1.php script result</alt>
       <imageobject>
        <imagedata align="center" format="png" fileref="img/basic1.png"/>
       </imageobject>
      </mediaobject>
     </screenshot>
    </figure>
   </para>


Even if PhD 0.4.3 does not support it: the result is not awful. We got 
(at display) something like

screenshot
qfams_basic_1.php script result
/screenshot

and html code result is:

   <font color='red' size='+3'>screenshot</font>
    <div class="mediaobject">
     <div class="imageobject">
      <img src="img/basic1.png" alt="qfams_basic_1.php script result" />
     </div>
    </div>
   <font color='red' size='+3'>/screenshot</font>

Laurent