Highlighted

Upgrade Classic Robohelp Project - Robohelp 2020

New Here ,
Sep 09, 2020

Copy link to clipboard

Copied

I tried upgrading a project in Robohelp 2020 from version 10 - and there are many (likely over a hundred) links throughout the project in the TOC/Index and other pages that point to some places with a bookmark within a single topic, rather than an individual topic.

 

Every single one of these links are broken when I do the upgrade.

 

Are there options I should select that may make the upgrade work better? I simply don't have the time to attempt to wade back through a project to fix all broken links...

Topics

Classic

Views

102

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

Upgrade Classic Robohelp Project - Robohelp 2020

New Here ,
Sep 09, 2020

Copy link to clipboard

Copied

I tried upgrading a project in Robohelp 2020 from version 10 - and there are many (likely over a hundred) links throughout the project in the TOC/Index and other pages that point to some places with a bookmark within a single topic, rather than an individual topic.

 

Every single one of these links are broken when I do the upgrade.

 

Are there options I should select that may make the upgrade work better? I simply don't have the time to attempt to wade back through a project to fix all broken links...

Topics

Classic

Views

103

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
Adobe Community Professional ,
Sep 09, 2020

Copy link to clipboard

Copied

We used to recommend upgrading to RH2019 Classic first, then to RH2019 New UI as they usually gave a better upgrade experience. However there's no such thing as Classic for RH2020.

 

You could try taking a copy of you RH10 project, deleting the cpd file and opening it *in RH10, just to make sure no broken links show up there. I don't know why this can sometimes show broken links when everything was working fine, but I've found that it can, sometimes. I typically do this before a major version upgrade, just to make sure nothing is hinky before I try upgrading. Also manually check a few of the places to confirm they link correctly. Then try the upgrade again, once you've confirmed that there are no obvious broken links or any other weird things.

 

*Edited to clarify which version to open the project in

 

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...
Adobe Community Professional ,
Sep 10, 2020

Copy link to clipboard

Copied

If Amber's suggestion doesn't help, try creating a copy of your project and open that in 2020. Delete all the presets and then see if the broken links report looks better.

 

If not, look in the supplied About RoboHelp sample project. Fixing the links might be easier than you think. I can't guarantee that as it will depend on why they broke. 

 

Post back how deleting the presets helps first.

 

www.grainge.org for free RoboHelp & Authoring info. 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...
Adobe Community Professional ,
Sep 10, 2020

Copy link to clipboard

Copied

Did you apply the newest patch for RH2020 before upgrading? That may give a better outcome (or it may not)...

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...
New Here ,
Sep 11, 2020

Copy link to clipboard

Copied

I wanted to try and obtain as much specific detail as I could before I replied again.

 

I was unaware that there was a broken link report inside the software, that will be helpful moving forward.

 

However, I think I neglected to share some specifics about where the broken links are - they are only in the index that I have found that has become a problem with the "upgrade project" feature.

 

I have extracted samples from RH10 and RH2020 for comparison. What it appears to be doing during the upgrade is it is mis-forming links in sub-topics in the index. It is taking part of the keyword, and the subkeyword, and replacing the actual anchor in the link with that.

 

 

Example (viewing link properties of compiled CHM while navigating in html help ui):

 

Correct link in RH2010 (keyword COL, Subkeyword CON.VIRTUAL.COL):

CONSOLE_pseudo-object.htm#CON_VIRTUAL_GET

 

Incorrect link in RH2020:

console_pseudo-object.htm#COL:CON.VIRTUAL.COL

 

However, what's really strange - if I double click the main keyword, that has subkeyword references, where it will bring up that indented list in a popup window, if I click the particular one down in the list I'm trying to go straight to in the Index listbox, it works from the secondary popup (though all of the subkeywords display as the main keyword only).

 

 

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...
Adobe Community Professional ,
Sep 12, 2020

Copy link to clipboard

Copied

Two things here.

 

I'm not seeing the issue clearly in my mind. Could you add some screenshots please? Use the Picture icon above rather than attaching the files.

 

You are generating a CHM. Generate a responsive or frameless output to see if things work OK there.

 

www.grainge.org for free RoboHelp & Authoring info. 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...