Issue

Images referenced in HTML pages inserted in Alchemy Catalyst may not render in Visual View.

 

Reason

When viewing html files in full visual mode, access to any referenced files within the html file is required.

This is important for the visual editor as images and .css used in the html file are typically externally referenced files.

There are a number of mechanisms for resolving paths to these referenced files.

 

Solution

Referenced files are searched depending on the reference style (absolute or relative):

  1. If the files are referenced with absolute paths, then those locations are searched. This includes both full URLs to web locations and local absolute paths
  2. If the files are referenced with relative paths, then firstly the files are searched relative to where the html was inserted from.
  3. If the files are not found in point 2, they are searched relative to the ReferenceRoot folder.

Catalyst ReferenceRoot folder location:

C:\Users\Public\Alchemy Software\Catalyst x.x\ReferenceRoot

Note for point 2, if the referenced directory is present but does not contain the images (or .css), Catalyst will not fall back to the ReferenceRoot folder.

You can copy referenced images into the ReferenceRoot folder to achieve a full visual view for html files. Including subdirectories.

 

Case scenario:

A TTK with HTML files has been created and sent for translation to a translator.

At run time, Alchemy Catalyst first tries to check the absolute path to try to retrieve the images which should be displayed in Visual View. If the TTK is opened on a different machine the same directory structure does not exist and the images are not found. When the files are not found Alchemy Catalyst will try to find the files relative to this ReferenceRoot folder.

So as long as the directory structure exists relative to the ReferenceRoot folder the images will also be displayed in Visual View. Copy the images to this directory maintaining the relative directory structure to allow the graphics to render in the Visual View.

If the HTML file referenced an image as <img src="../mypicture.png">
Then the mypicture.png file will need to be copied one folder up from the ReferenceRoot folder. i.e. C:\Users\Public\Alchemy Software\Catalyst 11.0

If the HTML file referenced an image as <img src="/Images/mypicture.png">
Then the mypicture.png file will need to be copied in an image sub-folder in the ReferenceRoot directory. i.e. C:\Users\Public\Alchemy Software\Catalyst 11.0\ReferenceRoot\Images

 

For Catalyst 10

Prior to Catalyst 10, the ReferenceRoot directory is named HtmlRoot

 

Products or Versions Affected

  • Alchemy CATALYST 8.0  and greater

 

Last updated with Catalyst 11