Page 1 of 1

images not displayed in webhelp output file.

Posted: Fri Jan 21, 2011 11:23 am
by nadigersriharsha
I am generating\apply transformation webhelp in oxygen xml tool. I have created a ditamap and also add all the associated dita topics to it. Images\screenshots do not appear in the output file. I get a red cross mark in the place of the screenshot\image. Please help me with this. In the text mode the
href="../../../../assets/CWlogin.PNG" placement="break"

appears. The link or folder struture is correct in href.

Re: images not displayed in webhelp output file.

Posted: Fri Jan 21, 2011 12:47 pm
by Radu

Usually the DITA Open Toolkit (used by Oxygen to publish DITA content to various output formats) has problems when in your DITA content you reference resources (like images for example) in a directory path outside the path of the DITA Project (where the main DITA Map is located).
So it would be best if your images folder would be located on the same level with the DITA Map for example.
Usually the DITA Open Toolkit complains about such problems in the Oxygen console view to you can also look in the console to see if this is the case.


Re: images not displayed in webhelp output file.

Posted: Fri Nov 13, 2015 8:22 pm
by kanchana

What was the resolution for this issue? We have a similar issue - images are not displaying in webhelp & xhtml output. When we generate webhelp or xhtml, the image folder is not in the same folder as the output html files; instead it is copied over to a different folder. So, our out directory looks like the following:

  • *.dita files
    • webhelp
      • oxygen-webhelp
        *.html files
      • images
        • *.png files
We are able to manually move the images folder to the HTML file folder - but this is not an ideal solution. Our book dita, ditamap, and image files have the following folder heirarchy/structure:

  • BookLevelDitamapFile
    • Image1pngFile

When we tried to troubleshoot, we noticed the following:

* If we generate content for multiple books (using the multibook ditamap file), the images display correctly. We are noticing this issue only when we generate content for individual books, which we want to do.
* The generated output for a book with no cross-references to other books displays correctly - the images display in the pages in this book. So, this appears to be an issue only in books with cross-references to other books.

Can you please help?


Re: images not displayed in webhelp output file.

Posted: Tue Nov 17, 2015 6:05 pm
by bogdan_cercelaru

You could use a custom build file that copies the image folder in the output folder at the end of the transformation process.
The custom build file should be saved in the DITA_OT_DIR and look like this:

Code: Select all

<project basedir="." default="dist">
<!--The DITA OT default build file-->
<import file="build.xml"/>
<target name="dist">
<!--Call the DITA OT default target-->
<antcall target="init"/>

<!-- You could run your script here -->
<copy todir="${output.dir}\image_folder">
<fileset dir="path_to_image_folder"/>
It's based on the example seen here:
Transforming DITA Content / Customizing DITA Transformations / Using a Custom Build File


Re: images not displayed in webhelp output file.

Posted: Wed Nov 18, 2015 12:06 am
by Radu

If the images are referenced directly from your topics they should be copied automatically to the output folder.
There are certain cases when this does not happen, you should check if this matches your case: ... -refs.html