Re: [Boost-docs] [quickbook][boostbook] CSS & image files

Subject: Re: [Boost-docs] [quickbook][boostbook] CSS & image files
From: Paul A. Bristow (pbristow_at_[hidden])
Date: 2010-07-09 16:59:27

> -----Original Message-----
> From: boost-docs-bounces_at_[hidden] [mailto:boost-docs-bounces_at_[hidden]] On Behalf Of John Maddock
> Sent: Wednesday, June 30, 2010 11:55 AM
> To: Discussion of Boost Documentation
> Subject: Re: [Boost-docs] [quickbook][boostbook] CSS & image files

> When I've needed an absolute path, I've always used the path-constant rule,
> for example in the Boost.Math docs we use:
> path-constant images_location : html ;

OK I've tried this, and echoing it says

images_location I:\boost-sandbox\tools\quick_auto_dox_index\libs\quick_auto_dox_index\doc\html

as expected.

> > Most important I want to reference these as [$my_image.jpg] in
> > Quickbook, - just like that with no \src prefix.
> >
> > Is Quickbook [$ my_image.svg] syntax   'hardwired' to expecting images in
> > doc/html/  ?
> >
> > Or can I point it somewhere else using the jamfile?
> >
> > Or does this control it, perhaps with
> >
> > <xsl:param>img.src.path=..\src\images
> 
> That should get it yes.

So in my jamfile I have (to get the location of my images for both html and pdf)

<xsl:param>img.src.path=$(images_location)/ 

In my Quickbook I have

[$my_image.jpg]

but I don't get the image displayed and the image info (split to avoid word wrap) is

i:%5Cboost-sandbox%5Ctools%5Cquick_auto_dox_index%5Clibs%5Cquick_auto_dox_index

%5C doc%5Chtml/

../my_image.jpg

There seems to be a (to me) unexpected (and unwanted) ../ before my_image.png

(and of course the confusing %C is caused by nasty Windows backslashing :-(  )

So it doesn't display the image even if my_image.png is at /doc/html and/or /doc/ :-(

Is this a valid file specification?  Windows explorer says "The file name is not valid."

So what am I doing wrong?  Or is the Quickbook call causing this?

Paul

PS (In the math toolkit you used a template and wrote out the 

[template graph[name]  '''<inlinemediaobject>
<imageobject role="html">
<imagedata align="center" fileref="../graphs/'''[name]'''.png"></imagedata>
</imageobject>
<imageobject role="print">
<imagedata align="center" fileref="../graphs/'''[name]'''.svg"></imagedata>
</imageobject>
</inlinemediaobject>''']

which is neat, but not necessarily what the casual users wants).