Issue

DocToHelp links are broken during alignment.

 

Reason

Because Catalyst does not expose the ID attribute of empty elements for translation, the source ID on the object element will not be aligned against the translated ID and thus the ID on the object will not be updated correctly. Because this ID on the object is not updated correctly the links will no longer work in the HTML file processed by Alchemy Catalyst.

 

Solution

Structure of DocToHelp links

In DocToHelp files links can be contained in the "id" attribute of object elements.

For example, an Anchor element has it's ID defined in the href attribute. This ID will be correctly parsed by Alchemy Catalyst as the HTML parser recognises the attribute for translation as long as there is text within the <a> element:

<a href="JavaScript:TL_12276.HHClick()">text</a>

In this example the Japanese ID might be TL_13456.

The same ID will then be repeated in an <object> element in the HTML file. But this element does not contain any text. For example:

<object id="TL_12276" />

In DocTypeHelp HTML files these values must all be the same in order for the links to work.

How the DocTypeHelp Links are broken by Alchemy Catalyst

If an HTML file is inserted into Alchemy Catalyst, it will not see all attributes of empty element as localisable. Thus in the above example it will not see the "id" attribute of the "object" element as localizable.

The source ID on the object element will not be aligned against the translated ID and thus the ID on the object will not be updated correctly. As ID of objects are not updated correctly the links will no longer work in the HTML file processed by Alchemy Catalyst.

To resolve the problem of misalignment you will need to expose "id" attributes of "object" elements so that they can be correctly aligned. This can be done by using a Config.xml file to change the way Alchemy Catalyst exposes the attributes.

Adding the Config.xml

In order to expose the attributes download the Config.xml file below and paste this into the relevant "Alchemy Catalyst x" public folder :

Vista & Windows 7 = C:\Users\Public\Alchemy Software\Catalyst x

XP = C:\Documents and Settings\All Users\Alchemy Software\Catalyst x

Download the file here: Config.xml

Once this file is pasted into the public folder you will need to edit it to suit your needs (specify the attributes), see the Specifying attributes as localisable in HTML files related Topic for more details. Restart Alchemy Catalyst and insert your HTML file again. Now your ID attributes will all be exposed as required and after processing in Alchemy Catalyst your links will be unaffected.

 

Related topics

 

Products or Versions Affected

  • Alchemy CATALYST 7.0  and greater