[maemo-developers] [maemo-developers] Advise on embedding images on docbook document?

[From: Karoliina.T.Salminen at nokia.com]

Hello,

I am in process of writing the specification of UI framework (meaning
Hildon Desktop & Control panel) and we have chosen docbook xml format. I
am quite new to docbook and don't know really all the tricks with it, so
maybe somebody of you would know better: 
Here is my question: I have tried to embed images on the document (for
example screenshot, diagrams etc. with different formats), but for some
reason it haven't worked for me, the image caption gets on its place
etc. but there is no picture in the pdf, so would you have some idea
what migth I been doing wrong?

I have tried to embed a screenshot of hildon desktop like this:

     <figure><title>Hildon Desktop: Task Navigator, Status bar,
Home</title>
       <screenshot>
       <mediaobject>
         <imageobject>
           <imagedata fileref="hildondesktop.jpg" format="JPEG"/>
         </imageobject>
         <textobject>
           <phrase>Screenshot of Hildon Desktop</phrase>
         </textobject>
       </mediaobject>
     </screenshot>
     </figure>

Then I tried to embed another image like this:
        <figure><title>Example MSC</title>
          <mediaobject>
            <imageobject><imagedata fileref="examplemsc.eps"
format="EPS"/></imageobject>
            <textobject><phrase>Example message
sequence</phrase></textobject>
          </mediaobject>
        </figure>

Neither of these images are visible in the generated pdf.
Obviously there might be something wrong in the command line used to
generate the pdf, currently it has been like this:
docbook2pdf hildon-desktop-spec.xml -o pdf

I am getting some latex warnings though, but not sure what they mean, as
I am not a latex guru.
Any ideas? Thanks.

Best Regards,
Karoliina