Skip to main content
Participating Frequently
September 10, 2010
Question

RH 8 crashes while compiling

  • September 10, 2010
  • 1 reply
  • 1396 views

Hello,

I have a problem with RH 8.02.208. I've seen that it crashes when the compiler compiles one specific topic. When I exclude this topic from the compiler it successfully compiles the project.

I made a completely new topic and copied the text from the old (now excluded) topic in the new one. Compiling works. I updated all links to the new topic, compiling works.

Then I put the topic back to the TOC. It crashes again, so I think that the problem is not with the topic itself, but it is with the TOC. The topic is topic, which is used several times in the whole help. I have put it more than 30 times in different folders in the TOC. When I reduce the links to 28 it compiles and anything works well. It seems not important, where I put the link within the TOC.

Is there any limitation for the occurence of a single topic in the TOC?

Thanks in advance and sorry for my bad english!

Michaela

This topic has been closed for replies.

1 reply

RoboColum_n_
Legend
September 10, 2010

Wow Michaela. 30 times in the TOC is something I've never heard of before. Out of interest does it matter where in the TOC it is added the 29th time? Try it at different levels and let us know the results.

Out of interest, what is the reason you are using the same topic so many times in the TOC? Could it be handled in a better way? The reason I ask is that if a user searches I believe they are only taken to the first instance of the topic in the TOC when it is displayed. I'm sure Rick can also chime in with other issues.


  The RoboColum(n)   @robocolumn   Colum McAndrew
MediMicAuthor
Participating Frequently
September 10, 2010

Yes it is really often, I know. To explain it a little bit: We have several software modules where the printing function is identically. So I explained the printing function in one topic. I have a folder for every module in the TOC and in every folder I'have inserted the printing topic.

It doesn't matter where I put it the topic in (first level, second level, third level).

MergeThis
Inspiring
September 10, 2010

Hi there

One possible way to accomplish this would be to create as many topics as you need for each TOC entry point. Then insert an Inline Frame (IFRAME) in each of these topics to present the content of that single print topic.

This would actually help in two different ways.

  1. It should correct the crashing issue.
  2. It should correct a TOC Synchronization issue (I'm guessing you haven't hit that one yet)

Cheers... Rick

Helpful and Handy Links

RoboHelp Wish Form/Bug Reporting Form

Begin learning RoboHelp HTML 7 or 8 moments from now - $24.95!

Adobe Certified RoboHelp HTML Training

SorcererStone Blog

RoboHelp eBooks


I agree that one topic in the TOC 30 times is excessive, not only for performance, but as a less-than-user-friendly construct. If I, as a user, encounter a topic that seems very familiar, I might be tempted to go back and look at the previously viewed topic, and then spend time wondering if they are indeed the same or slightly different. All of which slows me down and causes me to have less confidence in the integrity of the help. Sorry, but that's the truth!

I suspect that this topic is probably some type of overview or procedural that is presented in multiple areas, based on functional or privilege areas.

It might be easier to turn that content into a snippet, and include that snippet in an existing topic in each of the areas in question. You might even find that, as you do this, you might actually need several snippets instead of one.

As to Rick's suggestion about IFrames, keep in mind that the content in an IFrame doesn't get printed when a user prints the topic (the space you reserved for it does, however).

Good luck,

Leon