Migrating from RH 11

I will ask about the CHM.

Are you saying your original CSS was 0 bytes? If you don't have a good backup, create a new project and lift it from there.

www.grainge.org

Hi Peter,

I double-clicked the .chm, but got the same "cannot open" error.

I also looked for the .css file and saw that it was 0 bytes. I tried copying the existing file in and recompiling, but I got the same error.

I thought that check was only made when upgrading to 2019 New UI. What happens then is the process looks at the CSS for issues and reports if they can't be fixed. In fact they might be issues that will not affect you. If you did get it with Classic, then if you can't see anything wrong, then if you don't generate Word outputs it will not matter. If you do, I would try generating one and see what happens.

See if the CHM opens if you double click in File Explorer. If it does this has been asked before so try a search. If that fails, post back as I think I know someone who will have the answer.

www.grainge.org

I tested migrating one of our help systems to RH 2019 Classic. Everything converted except the following .CSS file:

WARNING: Failed patching and copying CSS Dependencies from C:/Robotics/PRA/Help/HTMLHelp 71_GA/RHStyleMapping.css

I looked it over and it seemed pretty straightforward, but I'm no expert on CSS files, or RoboHelp. Any ideas on how to correct this problem? I feel pretty sure I will see it in the other two RH 11 help systems.

Thanks.

--- and one more thing: I can generate HTML output, but if I try to view it, I'm told that RoboHelp cannot open the chm file.

Oh, and for RH 2019 New, if the content isn't in the table of contents, it won't be included in the output. So you may have baggage files you'll need to add to the TOC, and then hide from the TOC if you want to distribute them.

That's a decision you have to make. 2019 New UI has a learning curve.

Based on the help going into maintenance mode and the simplicity of it, using Classic is the quick and easy option as you are familiar with it.

Going forward, all development will go into the new UI so at some point you may need to transition to it.

I guess it's about when you want to do that.

www.grainge.org

Thanks Peter. I'm new to TCS 2019 as we just have installed it. Do you recommend Classic over the new UI, or vice versa? These are old, simple 600-topic, HTML help systems that are not fancy in any way (no context sensitivity) and that are going into maintenance mode for the next couple of years. The RH 2015 Help system will have a longer life, but is much smaller (50 topics) and is output as Responsive HTML.

You'll probably find the SSL build expression in the Output (SSL) doesn't get applied correctly when upgrading the RH11 to RH2019.

And for anyone else reading later, if you're using Multiscreen HTML5, then you'll have to select (and customise) a new skin (screen layout).

The biggest tip is RH2019 New UI is totally different from old RH versions, so treat the upgrade like moving to a different tool and do a lot of tests on backup copies. 🙂

Are you talking about upgrading to 2019 Classic or 2019 with the new UI?

If to Classic, then zip up a copy of the project before you upgrade so that you are covered if anything goes wrong. It should be straightforward.

If to the new UI, then a new project is created leaving the old version untouched. Try an upgrade to 2019 new UI direct first but if you find there are issues, then upgrade to 2019 Classic and then upgrade that to the new UI. If you have to do that, then create zip copies of your RoboHelp 11 and 2015 projects first.

Make sure your version of 2019 has all updates applied first. It should show Update 10. You don't need to update incrementally. Update 10 contains all earlier updates.

www.grainge.org