Deep Links, URLs Not Resolving, RoboHelp 2017 Responsive HTML5

Explorer ,
Feb 05, 2018

Copy link to clipboard

Copied

Hello forum folks! I need your expertise once again...

I am using RoboHelp 2017 and have a parent project set up with multiple child projects. I am converting from WebHelp to Responsive HTML5. All the projects' files are generated/compiled and everything is working EXCEPT the deep links for my context sensitive URLs to my child projects. I thought that it was something to do with our software, but cannot find anything. Here's the scoop:

Prior to the change my URL looked like this:

http://SERVERNAME/Eclipse-Help/Solar/!SSL!/WebHelp/MasterProject.htm#mergedProjects/ENT/VEND_Creatin...

Our system houses everything prior to the # in a reference file for the system to call.

I load the folder and file name on each screen (i.e. ENT/VEND_CreatingVendorRecords.htm)

When we launch the help from an individual screen, our software inserts the #mergedProjects, appends the folder/file for a complete URL.

These worked fine with WebHelp. I thought I could just replace the "WebHelp" with "ResponsiveHTML5" and all would be right with the world:

http://SERVERNAME/Eclipse-Help/Solar/!SSL!/ResponsiveHTML5/MasterProject.htm#mergedProjects/ENT/VEND...

Alas, while the master online help displays, the system does not display the .htm file for the screen, but stops at the overall landing page from the master project. I know the files are there because I can drill into them through the TOC. Also, it seems to be tacking on this string at the end: =&t=index.html. Even after removing this appendage, the screen does not display but stops at the index.html file:

ForumSnap.jpg

I've tried different servers, browsers, files, pages, etc.

Has anyone seen this happen with deep links? Am I missing something in the Output Layout setup, for example, does RoboHelp require that there be a space in the Responsive HTML5 folder? OR is it indeed something on our system?

HELP. Any thoughts?

Adobe Community Professional
Correct answer by Amebr | Adobe Community Professional

I had a quick test, and navigating the TOC in responsive output in RH11 always puts #t= after the parent index.html, then the path to the selected topic. So try #t=mergedProjects rather than just #mergedProjects and see if that works.

(Also, I just tried on my c drive and had to flip the forward slashes after the # symbol to back slashes. But that might not be necessary on a webserver - I don't know enough about it to be sure.)

TOPICS
HTML5 layout

Views

588

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more

Deep Links, URLs Not Resolving, RoboHelp 2017 Responsive HTML5

Explorer ,
Feb 05, 2018

Copy link to clipboard

Copied

Hello forum folks! I need your expertise once again...

I am using RoboHelp 2017 and have a parent project set up with multiple child projects. I am converting from WebHelp to Responsive HTML5. All the projects' files are generated/compiled and everything is working EXCEPT the deep links for my context sensitive URLs to my child projects. I thought that it was something to do with our software, but cannot find anything. Here's the scoop:

Prior to the change my URL looked like this:

http://SERVERNAME/Eclipse-Help/Solar/!SSL!/WebHelp/MasterProject.htm#mergedProjects/ENT/VEND_Creatin...

Our system houses everything prior to the # in a reference file for the system to call.

I load the folder and file name on each screen (i.e. ENT/VEND_CreatingVendorRecords.htm)

When we launch the help from an individual screen, our software inserts the #mergedProjects, appends the folder/file for a complete URL.

These worked fine with WebHelp. I thought I could just replace the "WebHelp" with "ResponsiveHTML5" and all would be right with the world:

http://SERVERNAME/Eclipse-Help/Solar/!SSL!/ResponsiveHTML5/MasterProject.htm#mergedProjects/ENT/VEND...

Alas, while the master online help displays, the system does not display the .htm file for the screen, but stops at the overall landing page from the master project. I know the files are there because I can drill into them through the TOC. Also, it seems to be tacking on this string at the end: =&t=index.html. Even after removing this appendage, the screen does not display but stops at the index.html file:

ForumSnap.jpg

I've tried different servers, browsers, files, pages, etc.

Has anyone seen this happen with deep links? Am I missing something in the Output Layout setup, for example, does RoboHelp require that there be a space in the Responsive HTML5 folder? OR is it indeed something on our system?

HELP. Any thoughts?

Adobe Community Professional
Correct answer by Amebr | Adobe Community Professional

I had a quick test, and navigating the TOC in responsive output in RH11 always puts #t= after the parent index.html, then the path to the selected topic. So try #t=mergedProjects rather than just #mergedProjects and see if that works.

(Also, I just tried on my c drive and had to flip the forward slashes after the # symbol to back slashes. But that might not be necessary on a webserver - I don't know enough about it to be sure.)

TOPICS
HTML5 layout

Views

589

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Feb 05, 2018 0
Adobe Community Professional ,
Feb 05, 2018

Copy link to clipboard

Copied

I had a quick test, and navigating the TOC in responsive output in RH11 always puts #t= after the parent index.html, then the path to the selected topic. So try #t=mergedProjects rather than just #mergedProjects and see if that works.

(Also, I just tried on my c drive and had to flip the forward slashes after the # symbol to back slashes. But that might not be necessary on a webserver - I don't know enough about it to be sure.)

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Feb 05, 2018 0
Explorer ,
Feb 06, 2018

Copy link to clipboard

Copied

Thank you! My initial tests are working...that looks like it might be it!

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Feb 06, 2018 0
Explorer ,
Feb 06, 2018

Copy link to clipboard

Copied

Thanks Amebr! This was the correct answer.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Feb 06, 2018 0
Adobe Community Professional ,
Feb 06, 2018

Copy link to clipboard

Copied

Because of a recent issue I hit and did not manage to resolve to my satisfaction, I suggest you make a change to a page and then use the same link. Check that you get the revised page.

I know this sounds like a cache issue but it wasn't. Using the link one way brought up the changed page and using it with #t= brought up the old page. I haven't retested and this may have been a one off thing. However, still worth testing.


See www.grainge.org for free RoboHelp and Authoring information.

@petergrainge

Please use the blue Reply button at the top to help me help you. The black Reply link nests replies and they sort out of order.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Feb 06, 2018 0
Explorer ,
Feb 06, 2018

Copy link to clipboard

Copied

Thanks, Peter. Definitely worth testing. We loaded the fix to add the t= from our system, and it's working correctly before and after clearing the cache. However, I will be able to test with the updated files as you suggest later today. We bundle our help system with our software build, so I need to wait for that to complete. But, the preliminary tests on a test server, seem to be functioning correctly.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Feb 06, 2018 0
Community Beginner ,
Sep 12, 2019

Copy link to clipboard

Copied

I believe this issue is similar to what I'm experiencing, though I'm not clear on the solution: I have a merged HTML5 project that is context sensitive. The CSH part is working. What's not working is when the parent is invoked--the exact reaction depends on the browser, but in Chrome, Fire Fox, and Edge, it either freezes or continously loads. In IE11, it works fine except--and this part applies to all browser types--the child project links don't work although the topic will open if the link is opened in a new tab (not ideal).

 

A little more detail: I'm using the Azure_Blue layout for parent and children; the parent is slightly modified (color changes, no big overhauls or anything) and the children are left as-is. When the topic is invoked from our software, the header indicates "Click here for the Table of Contents" and once clicked, the freezing/link failing begins.

 

Here's an example of a link BEFORE the TOC is invoked:

clipboard_image_0.png

And here's an example of a linke AFTER the TOC is invoked:

clipboard_image_1.png

 

I noticed that extra characters are added, which probably explains the failing links. But 1) how can that be fixed and 2) is this the cause of the freezing?

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Sep 12, 2019 0
Community Beginner ,
Sep 12, 2019

Copy link to clipboard

Copied

I believe I'm having a similar problem but am unclear about the solution: I have a merged HTML5 project that is context sensitive. It is beamed to our comm server where the clients download it and run locally. When a topic is invoked, the correct topic appears (the CSH is not an issue) with the "Click for Table of Contents" message in the header. Before clicking for the TOC, the topic displays correctly and linking works as expected. However, after invoking the TOC, the browser misbehaves and the topic links do not work (you must open in a new tab or window, which is not ideal).

 

The actual reaction depends on the browser:

Chrome - TOC loads continuously, never resolves. Receive a "Page Unresponsive" message.

Fire Fox - Page freezes, receive message "A web page is slowing down your browser."

IE11 - After accepting the warning about running scripts or ActiveX controls, TOC loads nicely and works although topic links fail.

Edge - Page freezes.

 

Here's the URL before the TOC is invoked:

clipboard_image_0.png

Here's the URL after the TOC is invoked:

clipboard_image_1.png

I noticed the "extra" information in the second URL. Is this the culprit for both the load issues and the link failures? Or are there browser settings that clients must set? Or a combination of both?

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Sep 12, 2019 0
Adobe Community Professional ,
Sep 13, 2019

Copy link to clipboard

Copied

@Nicole - There is a topic on my site about Calling Help. Maybe that will help.

 

Please use the blue Reply button at the top to help me help you. The black Reply link nests replies and they sort out of order.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Sep 13, 2019 0
Community Beginner ,
Sep 17, 2019

Copy link to clipboard

Copied

Thank you Peter. I'll enlist the help of a web programmer!

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Sep 17, 2019 0
Community Beginner ,
Sep 19, 2019

Copy link to clipboard

Copied

I just wanted to share the solution discovered by my incredible developers: the RH folder structure used uppercase (e.g. /Purchasing/topic.htm) while the output creates lower case folders. The case-sensitivity was causing links in the topic to look for /purchasing/topic.htm and not /Purchasing/topic.htm. Once the TOC was invoked, that also caused a misread in the folders. The solution was to replace a tiny bit of code in the loadprojdata.js as such: "while(!baseUrl.endsWith(childUrl))" is replaced with "while (!baseUrl.toLowerCase().endsWith(childUrl.toLowerCase()))". After outputting, we run our files through an in-house program to create the file that is placed in a packet. That in-house program was updated to make that change automatically (otherwise, we'd do it manually).

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Sep 19, 2019 0
Adobe Community Professional ,
Sep 19, 2019

Copy link to clipboard

Copied

Nicole - Unless I am missing something in this thread as I can't stop to reread it all, RoboHelp only generate lowercase outputs if you tell it to in the presets. If the checkbox is left cleared, it leaves the case alone. Did I miss something?

 

Please use the blue Reply button at the top to help me help you. The black Reply link nests replies and they sort out of order.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Sep 19, 2019 0
Community Beginner ,
Sep 20, 2019

Copy link to clipboard

Copied

I see that option in the WebHelp output but not the responsive HTML5 (what I'm using)...unless it's someplace else? I'm not finding it anywhere.

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Sep 20, 2019 0
Engaged ,
Sep 20, 2019

Copy link to clipboard

Copied

HTML5 Output, Tab "General", second to last checkbox "Use lowercase file names"

Likes

Translate

Translate

Report

Report
Community Guidelines
Be kind and respectful, give credit to the original source of content, and search for duplicates before posting. Learn more
Reply
Loading...
Sep 20, 2019 0