8 Replies Latest reply: Jan 30, 2012 7:50 AM by Jeff_Coatsworth RSS

    Conversion of FM Cross-Refs to RH Hyperlinks (<a href="...">) - Maximum Lengths

    Jeff_Coatsworth CommunityMVP

      I'm running TCS 3.0 (FM 10.0.2.419 & RH 9.0.2.271) and observing a strange thing within the same RH topic when it comes to the conversion of FM cross-ref text into RH hyperlinks: some are working and others are not - within the same topic.

       

      After much experimentation, it appears that there is a secret limit to the number of characters in the relative path reference that creates the RH hyperlink. I haven't worked out what the exact number is and wondered if anyone else had observed this. I didn't find any mention of any issues with this in the RH documentation, only the mention that your FM docs should be free of all unresolved cross-ref warnings (which mine are - the FM doc behaves quite well and you can happily jump around within it).

       

      I stumbled upon this issue when I examined the generated WebHelp output and noticed that some of the links appeared and others didn't. After first checking the FM source doc and verifying that the cross-refs worked there, I then looked at the RH topic. The curious thing is that all appears to be well - in Design View, the links look like hyperlinks in appearance (nice blue text and underlining), and positioning the cursor on them shows "Hyperlink" in the Tag List, but if you switch to HTML View, the code shows an <a> coding instead of an <a href="../blah blah"> reference (which appears on the ones that work).

       

      My path lengths can get overly long because I'm using the FM concept of "a book of books" - the one that I've been experimenting with reads like this when manually repaired:

      <a href="../Club_Reporting_book/Club_Reporting_reference/Club_Management_Reports_Outstanding _Dues_Report.htm#XREF_GJK56_Outstanding_Dues">Club

         Management &gt;&#160;Reports &gt; Outstanding Dues Report</a> which I think is 91 characters up to the .htm

       

      I'm loathe to go and change the book names (and fix all the resulting busted cross-refs) because it creates a great ToC structure that comes over to RH fine, but if I have to, I will. I'd just like to know what limit there is that I need to get under to make this work. Anybody hazard a guess?