22
Replies
Hi, "Missing TOC Link" error when I insert a CHM into the TOC. I can't capture the message when I hover over the red x but it looks like this:
It's a brand new project. The only thing I did before inserting the CHM is click on "Enable advanced HTML Help options" in Project Settings.
Dan
When you insert a link from the parent project TOC to a child project, the icon should look like this.
The icon you are showing suggests you have linked it a different way and RoboHelp doesn't understand what the file type is done that way.
On the toolbar there is an icon to insert a child project. Are you using that?
________________________________________________________
My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.
One of the steps in the additional link @Amebr has added shows this.
That icon does not exist. What you do get is this.
There you will see the same icon for Child Project that I referred to before, which is not the icon you are showing.
________________________________________________________
My site www.grainge.org includes many free Authoring and RoboHelp resources that may be of help.
Yeah it looks like both topics are wrong and that functionality has been completely removed in RH2020.8.
This is the corresponding dialog box that I used to use in the dim, dark past when I was generating chm:
I never stored the chm in the parent project as the dialog box states though, because our projects weren't all generated at the same time and storing the child chm in the parent would mean outdated child chms could be published accidentally. And in the original MS functionality, the parent chm only needs to know the name of the chm (all chms individually published to the same folder) not to have the chm present when it is generated.
So I suppose you could try just specifying the name of the chm and see if the parent chm correctly picks up the child chm when they are both copied to the same folder. You'd have to live with the "broken" link in the toc though.
And for your other question, I'm fairly sure the context sensitivity is built in to each chm so you wouldn't need the ali file in the output. At least I don't remember doing anything with the ali file all those years ago...
Thanks for your feedback. In the current RH2020, the TOC insert looks like this and I select Child HTML Help:
The dialog below opens to allow me to select the CHM:
In 2019 Classic the child CHM is copied to the chm folder under assets in the parent project. In RH2020 I have to manually copy it there or I get the broken TOC link message. The CHM is not automatically copied. My parent project looks like this:
In addition, the ali files in 2019 Classic would be automatically copied to publish\mapfiles, but in RH2020 I have to manually copy them. I tried to generate the parent without the map files but it did not work. This is frustrating becuase in the 2019 Classic is worked as expected and now I am stuck with a manual process. I still think that this is a bug. Maybe I should look at merging the projects rather than inserting CHMs. Thanks again!
Hi, my version:
My objective is to use CHMs like we have been in RH10. In our software product there are about a dozen CHM files (Child HTML Help in RH 2020 language) whose pages are displayed in our software depending on the field selected by the user. In RH10 we used to have to manually combine the .ali files into the parent project .ali so that each .ali from the children would be included. For example:
The RH 2020 CHMs work in my software now, but I have to manually copy the CHM and .ali files to the parent's folders before I generate the parent CHM. Thank you for all of your feedback and suggestions.
Dan
I submitted a support ticket and referenced this thread. Just to add more documentation, this is what my project looked like in RH2019 Classic. I used the Merge New Project button to combine my projects:
I achieve the same functionality in RH2020 by using the insert Child HTML Help function, but before I do that I have to manually copy CHM and .ali files into these folders, otherwise I see the error that I documented:
Also, .ali files look like this in the original project:
But then I have to edit them to look like this in the combined project. Notice how I have to add the .chm name and update the path:
Hi, I tried your method again and it did not work. Support also suggested a workaround but it did not work either. I told him that I already have a workaround that involved editing ALI files and manually moving ALI and CHM files into the parent project. Support did say that there is a bug in the software. The correspondence is below. Thank you again for all of your input. I will update this thread as my support ticket is resolved.
Hi Dan
I’ve tested the issue at my end and seems problem with RH 2020.8. As a workaround, you can try the following steps
- Generate the CHM output.
- Save it in the Root directory of the project to which you need to link it.
- Go to TOC editing mode and insert it as a Topic like below.
- Once it is inserted generate the output again and you will be able open the linked CHM file however you will get some pop-up that you need to click on Open. The CHM functionality is handled by a browser like IE which is not related to RH, so if you click open twice it will let you open the file.
I agree that it used to work with the earlier version and now we have the RH-22 release already last month. As per my understanding, this feature is not implemented with RH-22 however allow me 12 to 48 hrs to check internally, and will get back to you.
I learned from support that the red x is a bug that can be ignored when inserting Child CHM into the TOC. However, I still have the same problem that requires a workaround. My latest exchange with support is below.
From Support:
Thank you for getting back to us, could you try the following steps?
- Open RoboHelp click on FileàProject Settingà Enable advanced HTML Help options
- Create the project and try to insert the CHM as a child topic in TOC, it will work in the output however may show the red cross sign in RH itself, please avoid it as it is reported already and we have logged a bug # RH-11220 to ensure that red cross sign will be removed as well.
Please feel free to write back in case of any further concerns
My response:
The child CHMs display ok in parent (cnext2) as you can see below but help files do not work in our software. We display individual pages depending on the mapping.
The \publish\mapping folder is missing in the project and so the .ali files are not available when the CHM is generated.
Recall that in my workaround I can manually edit and copy the .ali files to \publish\mapping to make RH 2020 work like it did in RH 2019 Classic.
Shouldn’t the .ali files be moved into the project when the Child HTML Help is inserted into TOC? I need this to work like it did in RH 2019 Classic – insert New Merged Project into the TOC.
The Child CHM display ok
AdChoices