Special characters in TopicAlias markers
Version |
Date |
Changes |
1.0 |
2011-03-02 |
Initial version. |
1.1 |
2011-03-02 |
Sample project attached. |
1.2 |
2011-03-03 |
Possible solution found. |
Description
We recently discovered an issue where the JavaHelp viewer displayed an empty content page. WebWorks Support quickly created some XSL transforms to address the problem and this issue was fixed. The maps, however, now cause some context-sensitive links to be broken. This was due to vertical bars '|' appearing in TopicAlias markers. Vertical bars are now converted into underscores '_' during help generation.
For example:
view|system:administration_setupsupport.3 (TopicAlias marker in FrameMaker source) view_system_administration_setupsupport_3 (mapID in the generated JHM file)
I recently learned that special characters other than '_' are not supported in TopicAlias markers (we are using Frame 9 for authoring) as this is by design. However this problem appears only when we apply the XSL transforms. After removing the transforms from the project tree, vertical bars return to the map however the blank JavaHelp content page remains as an issue.
A sample project is attached. The XSLs are: index.xsl, javahelp_map.xsl, and toc.xsl.
Adding a vertical bar to the search string in the javahelp_map.xsl seems to do the trick. I suppose this instructs wwstring:ReplaceWithExpression to ignore vertical bars in TopicAlias markers.
For example:
...
<xsl:comment>Begin topic mapping</xsl:comment>
...
<javahelpmap:mapID target="{wwstring:ReplaceWithExpression($VarLinkParagraph/@topic, '[^0-9A-Za-z|]', '_')}">...
Jesse Wiles: 5/4/11
Thanks for posting this Jelena.