I am having difficulties getting the img.src.path parameter in my DocBook WebHelp Classic Ant Scenario to work. I need to put all my image files into a single directory, and have all the images in all my books and sets get their images from that directory. Specifically, the image files are located here:

If the img.src.path parameter is set, its value is prepended to each fileref value if it is not an absolute path. This parameter lets you specify the path to the image files when you build the HTML. If its value is images/ then a fileref value of caution.png is written to the HTML file as src="images/caution.png. But sure to include the trailing slash.

so if you use Oxygen editor variables in its value, then they will get expanded to absolute file paths and then the HTML image will point to the image using these absolute paths which you do not want. For PDF, these absolute paths will not matter because the resulting PDF will include the images inside it anyway but for HTML it does matter.
So for HTML output you will need to specify a relative value for this parameter.

I would expect the relative path of "../Images/" to find the images, if the path is supposed to be relative to the place where the source files are located.

On the other hand, if the relative path is supposed to be relative to the place where the output is generated, I would expect this path to work: "../../../Images/" because the the output gets generated here:

Thank you for these suggestions. I followed these steps, and got it to work, but I was unable to set a path to my Images directory, like: "../../../Images", because as I understand it, that is not considered a relative path. Moving the images to the same directory as my source files, and using "../../" to move up two levels from the "out/webhelp/" output directory did work.

However, putting the images with the XML source files is inconvenient, since we have multiple source file directories, one for each book and one for each set, and many of the books share images. This means creating and maintaining multiple copies of our images.

For now, I will change the imagedata fileref attribute on each source code file from this:

Unfortunately I cannot give you an estimate for when the DocBook WebHelp classic publishing will be fixed to support "img.src.path" in exactly the same way in which it supports the same parameter for XHTML based outputs. But when we do, we'll update this forum thread.