Skip to main content
Participant
August 23, 2007
Frage

A better way to deal with lost hyperlinks when converting Robohelp to Printed doc?

  • August 23, 2007
  • 18 Antworten
  • 2814 Ansichten
I have inherited a 750-page manual that is "single-sourced" in RoboHelp X5. When I generate printed documentation, all of my hyperlinks and converted to plain text. Everytime we release a new version of the manual with any changes, we have to re-generate, and then manually go into the MS-Word converted document and re-create some 350 hyperlinks and page number references. Somebody please tell me that there is a better way to do this, or a better tool to manage single-source documentation.
Dieses Thema wurde für Antworten geschlossen.

18 Antworten

Peter Grainge
Community Expert
Community Expert
September 19, 2007
The Word version idea is certainly worth a try. It's certainly pointing to it being a resource issue, don't you agree. Both halves work fine but not together. Struggling to think what else that could be.

Use menu (bottom right) to mark as Best Answer or to Highlight particularly useful replies. Found the answer elsewhere? Share it here.
Inspiring
September 19, 2007
Peter's suggestions are good. I'd focus on the two topics at the quitting point -- the last one to be included and the first one that didn't make the cut. What's the size of the incomplete doc?

When you're generating a big document, it's interesting to watch how RH and XP use memory, with some data in the machine and some paged to the hard disk, and swapping chunks from time to time. You won't see every movement because it's so fast, but you get a snapshot about twice a second.

The OS should automatically manage the size of the paging cache, grabbing more disk space when necessary, but I think there's a user option to regulate the process.

Before you generate printed doc, turn on Task Manager (right-click on the Windows toolbar) and select the Performance tab. Probably RH takes a while to reach the point where it quits, so if you don't want to monitor the rising memory usage, look at the moving graph and numbers from time to time.

Do you see anything that might be a clue?

Harvey

Peter Grainge
Community Expert
Community Expert
September 19, 2007
Another post has been raised relating to this problem. See http://tinyurl.com/yvpaut

I am replying here is this is where most of the relevant information is.

****************************************

You found that using the Style Mapping template solved the images problem but the document stopped generating at 450 pages. That was sort of what I hoped for. Rather than go to the step I will suggest in a moment, I suggested you try something else but you never came back to the forum to indicate you had tried it, so the assumption is you did and it worked. Patently it did not so let's try what I would have suggested next.

On my website there is a topic on Print Issues and one of the them covers Malformed Topics. Try looking for <p style="mso-bookmark: as suggested in my earlier reply in this thread. You can try RH's Multi file find and replace but FAR from http://www.helpware.net/FAR may get better results. I think with this error you usually get a message. Do you have the Output pane opened and have you read right through it for clues? View | Output on the menu. Whether or not the Output pane mentions this error, I would search for it anyway.

Other Points:

A] It could still be a resource problem. The document is very large so, as Harvey mentioned, resources come into it. I know the PCs that won't play nicely have good resources but whilst I am no expert in this area, don't foget XP is using more of them leaving less available to you. It could be an issue but I am inclined towards it being something else.

B] I also suggested a hunt for a rogue topic.

"What I would try is copying your layout so that you have three versions of it. Then delete two thirds from each one. If all three work fine, it sort of confirms that size is a problem. If one fails, your on the track of the rogue topic."

Did you try that? Like I said, if all three work fine, then we are back with the resource problem but we will have ruled out other issues. It should take less than fifteen minutes to set that up. Longer to run it but you can be doing something else at that point.

C] On FrameMaker, no real answer but you will soon see evidence that Adobe are continuing to better integrate all the products we are using. I don't think you will see what you want in the upcoming version though.

NEXT:

1] Please search for <p style="mso-bookmark:

2] If that fails, try creating the three layouts.

3] Then post back how it went. If unsuccessful, tell us if the Output pane gave any information about things the process did not like.

Let us know either way as if one succeeds and you post that, it helps the next person with the same problem.

Use menu (bottom right) to mark as Best Answer or to Highlight particularly useful replies. Found the answer elsewhere? Share it here.
TechWriterKat2
Inspiring
September 19, 2007
Peter,

Sorry if I messed up your holiday. Since this topic started out on a completely different subject, I thought it would be easier for someone else doing a search to look in the title. Blame it on my "newbie forum" status.

Anyway, on to the results:

I split the document into two, and both halves worked fine with no errors. But this causes other time-consuming problems, so it was not an acceptable workaround for me.

I searched for <p style="mso-bookmark, and I didn't find it. I used RH's search engine, and Windows XP Search option.

Harvey, since it didn't fail when I split the book, do you still think it would be helpful to check the memory usage?

One more thing I'm going to try that my boss noticed: Try using it with WORD 2000 instead of WORD 2003. I'm waiting for a machine where I can try that out. Perhaps Microsoft is the culprit?
Inspiring
August 24, 2007
In the "old" days, it seemed to take a lot of memory to produce printed documentation. It was more noticeable then because we had much less in our machines to work with.

Which Windows OS are you running? When I had control over the memory-to-disk paging function, I increased the size of disk memory a good bit beyond the Windows default, and my problems with print doc went away.

Harvey
TechWriterKat2
Inspiring
August 24, 2007
windows XP service pack 2 with 2 GIG of RAM. It runs fine on my co-worker's computer running Windows 2000 with less RAM.
Peter Grainge
Community Expert
Community Expert
August 24, 2007
Oops, missed the links bit.

I have no Framemaker experience so hopefully someone else will jump in here.

What I can say is that there is no export to Framemaker layout but I'll make some enquiries to see whether it is on someone's horizon. I know Adobe are working on better integration of these products.

Use menu (bottom right) to mark as Best Answer or to Highlight particularly useful replies. Found the answer elsewhere? Share it here.
Peter Grainge
Community Expert
Community Expert
August 24, 2007
Very often problems with documents arise when using home brewed templates. That does not mean that there is anything wrong with them, simply that there is something about Style Mapping.dot that does not give the problems.

It used to be the case that Word help stated the limit was 32mb and I wonder if you are hitting that? That is no longer in the help but nobody seems to know if that is because the limit has been removed or just the topic! In any case, the size of your document is likely to give problems simply because of the resource requirement generating a document that size, particularly with graphics. I know a bunch of people will jump saying they have larger documents but nonetheless you are in amber territory. It's a bit like tuning a car way beyond its intended limits, you can do it and some cars will work happily tuned that way, but nonetheless you cannot complain if it does blow up.

What I would try is copying your layout so that you have three versions of it. Then delete two thirds from each one. If all three work fine, it sort of confirms that size is a problem. If one fails, your on the track of the rogue topic.

If splitting it does work better, cut and paste would soon get it all back into one document.

Use menu (bottom right) to mark as Best Answer or to Highlight particularly useful replies. Found the answer elsewhere? Share it here.
Peter Grainge
Community Expert
Community Expert
August 23, 2007
The X has been dropped. You just need RH6 unless of course you are also generating a WebHelp PRO ouput.

What are you selecting in the dropdown in the last page of the print wizard? Try style mapping and see if that fixes any of your problems.

Post back to let me know if that makes any difference.

Use menu (bottom right) to mark as Best Answer or to Highlight particularly useful replies. Found the answer elsewhere? Share it here.
Peter Grainge
Community Expert
Community Expert
August 23, 2007
Welcome to the forum.

You need to upgrade to RH6. The links work when you generate the printed document.

Use menu (bottom right) to mark as Best Answer or to Highlight particularly useful replies. Found the answer elsewhere? Share it here.
Participant
August 23, 2007
Thank you for the quick response. Do I need RoboHelp X6 or RoboHelp X6 Server? I've had some other problems with X5, which I'm running on XP. It doesn't always generate the whole document, and when it does, the images llok like they were stretched are stretched out and distorted. I've been perusing your WEB site; extremely helpful -- thank you! Nothing on it about that problem though.
MergeThis
Inspiring
August 23, 2007
Just RH6.

As to the incomplete compile and distorted images, I'd say you're probably working the project over a network. Nothing good ever comes out of doing that.


Good luck,
Leon