Re: [PEAR-DOC] New PEAR Manual build with PhD is not broken ...

Hello Christian,

> Hello Laurent,
> 
> 
>> I've not opened a new bug report for 'format_screenshot' due to
>> explain given by Christian to reply on my post of the 22nd
>>
>> Here are the summary :
>>
>> 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]
> 
> PhD has support for images in cvs now.
> The only thing to remember is that you have to make the image paths
> relative to manual.xml - see [1] where I fixed this.
> 
> You are free to put your images wherever you want - but I suggest we
> should keep them in an images/ folder in the package's main directory.
> 
> 
> [1]
> en/package/html/html-quickform-advmultiselect/appendix/examples-basic1.xml
> 

Nice works !
I've just run a test on my platform with PhD CVS version.

One or two questions, before I apply the change on all other files that 
required a screenshot.

- 1 -

With docbook source code as below :

     <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="en/package/html/html-quickform-advmultiselect/images/basic1.png"/>
        </imageobject>
       </mediaobject>
      </screenshot>
     </figure>

We got this html result

<div class="figure">
      <h1 class="title" 
id="package.html.html-quickform-advmultiselect.appendix.examples-basic1-sscaption" 
name="package.html.html-quickform-advmultiselect.appendix.examples-basic1-sscaption">Basic 
usage with default layout</h1>
      <div class="screenshot">
       <div class="mediaobject">

        <div class="imageobject">
         <img src="images/70f3c99087c4daff6ffd2fe068166b1b-basic1.png" 
alt="qfams_basic_1.php script result" />
        </div>

       </div>
      </div>

Does it means the align attribut (center) I've put in <imagedata> tag 
is include inside the css class "mediaobject" ?
But in this case we cannot give another value to align attribut (see [1])

- 2 -

I suppose the prefix hash of picture (70f3c99087c4daff6ffd2fe068166b1b) 
is an ident for package name to avoid name collision with other image 
that could be have the same name ?


The PEAR Manual will be pretty nice with that.
Once again , nice works :)

Laurent


[1] http://www.docbook.org/tdg5/en/html/imagedata.html