Snippets

See http://kb2.adobe.com/cps/404/kb404183.html

Over quite a long period there have been reports that when a Word document with images is imported, the images are missing in RoboHelp. The problem was that it was only an issue for some people. I got hold of a document where this happened every time for several users and sent it to Adobe.

They advised that MS Word has a document specific setting Rely on VML for displaying graphics in browsers which is un-selected by default but in the test document it was selected.

If you clear that option and save the document, the images will import.

You can find the Rely on VML for displaying graphics in browsers setting here:

Word 2007
Office Button>Word Options->Advanced->Web Options…->Browsers->

Word 2003
Tools>Options>General Tab>Web Options

There is also a setting Allow PNG as a graphic format. That option will prevent any PNGs in your Word document from being converted to JPGs and imported. The PNGs will show in Project Manager but will have a cross to indicate they are missing. RoboHelp will not import any PNGs in your Word document as PNGs.
Your options are to make sure this option is not ticked and allow RoboHelp to import the images as JPGs OR to force the PNGs to show as missing by selecting this option and then manually adding them in the correct folder in Windows Explorer. (You can extract the images from the Word document by saving it as a web page whereon Word will save all the images to a sub-folder.)

Steve Cohen found that by changing his Word documents as above, the import worked fine but then the images did not appear in WebHelp. The Word document had spaces in the filename and when he replaced those with underscores, all was well.

Blame Microsoft!

http://support.microsoft.com/kb/282066/EN-US/

Auto creating a TOC and the sort order seems to be causing some confusion as evidenced by this thread.

http://forums.adobe.com/message/2330002#2330002

Click here for a PDF of the forum thread

Auto-create TOC is always based on the Custom Sort order if one has been defined. If no custom order has been created, RoboHelp will treat the default alphabetical AZ order as the custom sort order.

The icon that shows AZ is not an AZ - ZA toggle. Its two states are Sort by Name (A-Z only) and Custom Sort.

	This is the icon when A-Z order is selected.
	This is the icon when custom sort order is selected.

If a title in the TOC is very long it will display right aligned in RoboHelp 7 and 8.

To stop this you need to edit whthost.js.

Locate the line

aIdList[aIdList.length-1].focus();

and comment it out with two slashes

//aIdList[aIdList.length-1].focus();

From time to time people ask about Information Types. In this thread, Rick Stone explains they are only for CHMs and the pitfalls of using them and Amebr explains the steps.

Download a PDF of the thread as at 9 December 2009.

One of the most regular causes of problems seen in RoboHelp forums is where authors have placed their project on a network drive. In the absence of source control, RoboHelp projects must be stored on the local hard drive.

The reason is quite simple. Underpinning any project is a CPD file. It is in fact a Microsoft Access database and they simply do not work well across many networks. They then corrupt and cause problems.

Whenever one of the forum supporters posts this advice, someone will usually chip in that their project has been running beautifully on a network for years. Yes that can happen. The point is that on some networks things will run OK but there are too many that don't and things can change. A change in the network setup can affect how a network based project works so what works today, may not work next week. We have seen someone argue this point and then come back later with a problem, guess what fixed it.

If you want to risk it, that's your choice but do make sure your backups are good. Even a loss of one day's work can reduce you to tears. I liken it to playing Russian Roulette. You can survive a long time if you are lucky but when you lose...

The most frequent reason people give for working on a network is their IT department stipulate that all work must be network based for backup purposes. Unfortunately nobody told RoboHelp that so IT can have all the policies they like, it will not change this situation. Of course they are right to ensure you have backups and you need to agree something with them.

What we do is run an automated backup program each night before IT's backup routines kick in. It zips up our projects and prefixes the filename with the date in YYMMDD format (091231_MyRobohelpProject.zip) and saves that to a network drive that we clean up every so often as IT will have backed up that file. We use the low cost SyncBack program from www.2brightsparks.com.

The other solution is to introduce source control. The project is then on a network and files get checked out and transferred locally while you work on them. Of course, if you don't check the files back in at the end of the day, then the updates will not be backed up so there is still a weakness in the system.

Ultimately, if IT will not be flexible, you may have to enlist the support of line management.

Sometimes it is necessary to open a project from the HHP file. It is important that the file is up to date if you have to resort to this method, so what updates it?

• When any SSL is generated.
• When the properties of the Microsoft HTML Help SSL are changed.
• If the Microsoft HTML Help Window settings are changed.

You can right click a layout and change its properties without generating. This does not update the HHP, except in the case of Microsoft HTML Help which does update.

Yes and no. There is a limit of 32 mb of text but the file size can be bigger because of graphics etc.

Here's the low down.

http://support.microsoft.com/default.aspx?scid=kb;en-us;211489

Amusingly I found my way to this link from a thread where someone stated they had a file of 202 mb and on asking the limit they were told 32 mb. However, as the link will explain, that is possible, albeit apparently perverse.

Marjorie wanted to convert from RoboHelp X5 for Word to RoboHelp HTML 7. The problem was that she could not find out how to map the styles so she posted on the RoboHelp forums. Later Marjorie posted that she had found various bits of information on my site and wrote up the detail of how she had approached the job, what worked and what did not.

This is a fairly regular forum question so here is a link to the post and here is a link to a PDF of it.

I don't normally cover source control issues but regularly people have problems with what should and should not go into source control. Laurin and Leon have often responded so I thought it might be worth pinning Laurin's latest reply here.

"There aren't very many files that RoboSource Control excludes. Let's see, a quick tally of my RH6 webhelp project shows the following to be excluded:

* projectname.cpd
* projectname.pss
* projectname.hhp
* projectname.trl
* ehlpdhtm.js

That's not very many, but the consequences of adding them to RSC are severe--things get very messed up, very fast. That's why I always let RH control the upload into RSC. Not an option if you're not using RSC, I realize."

When you view topics or web pages, you may see the author has included a Return to Top link at many points in the page. Leon came up with a better solution, one link that is always at the bottom of the page!

With slight amendments and some of my comments, this is what he posted.

Leon's Post

We found that too many links became overwhelming. We decided to only provide a Return to Top at the bottom of each scrollable topic. I worked up a scrolling (floating) link. (Note the "z-index: 1;" setting in the .css file; that causes the link to always be layered over anything else on the page.)

It looks like this:

This is the code to be used within each topic and within your (MyProject).css file:

At the top of each topic (I have it just under the H1 heading)

<p class="top"><a class="topic" title="Return to Top" href="#">↑ Top</a></p>

In your .css style sheet file (place the p.top after the default p & LI.p settings, and the A.topic's after the default A settings)

p.top {
     position: fixed;
     background-color: #f5f5dc;
     padding: 2px;
     right: 12px;
     bottom: 5px;
     z-index: 1;
}

PG: I did not include the link definitions in my CSS and it worked fine. That may have been because I already had appropriate definitions. See what works for you.

A.topic:link,
A.topic:visited {
     color: #4169e1;
     font-size: 80%;
     font-weight: normal;
     text-decoration: none;
     font-color: 000080;
     padding: 15;
}
A.topic:hover {
     color: #4169e1;
     font-size: 80%;
     font-weight: normal;
     text-decoration: none;
}

Simply customize my settings to suit your organization's style and formatting needs (fonts, location, padding, border, etc.).

Snippet 38 enables you to add a text link or graphic to a topic that will generate an email with a link to the topic. The script relies on the text link or graphic being in the topic but Steph wanted a toolbar button.

He has kindly shared this script. It does not create an email but it does copy the topic title and URL to the clipboard.

You create a new toolbar button in the skin editor using the JavaScript action. Select the Inline JavaScript option and click the Edit icon. The function script is below this image.

function CopyURL()
{
var myHerf=parent.frames[1].bsscright.location;
var title=parent.frames[1].bsscright.document.title;
if(window.clipboardData)
{
var tempCurLink=title + "\n" + myHerf;
var ok=window.clipboardData.setData('Text',tempCurLink);
alert("Press Ctrl + V to Paste the link in your email");
}
}

Q-Term posted this problem:

Since I am generating a context-sensitive help and my customer is only able to implement a help project based on JavaHelp 1.1.3, I cannot use JavaHelp 2.0, though there is a whole series of restrictions with JavaHelp 1.1.3.

With RoboHelp v7, everything worked fine when creating a JavaHelp 1.1.3 project. With RoboHelp v8, however, the TOC is missing in the JavaHelp. It is not displayed. Usually, I am working on my main PC under Windows XP.

I tried to generate a JavaHelp 1.1.3 version with RH 8 under Vista (which I have on my notebook), and the TOC was displayed. The project source is a Web Help project.

When I copy the entire project with the generated JAR file to the PC with Windows XP installed, the TOC is not either displayed.

Praful Jain responded with this:

Each JavaHelp file has a helpset file with extension .hs. This HS file tells javahelp about the help file structure and where the TOC file, index file, and other information can be found.

the problem lies in this .hs file itself. The problem line is

<view mergetype="unite-append">

you need to change this line to

<view mergetype="javax.help.UniteAppendMerge">

and now try running the javahelp again.

You should be able to see the TOC, that's what I did to make TOC appear in javahelp.

Better still, Praful then added this screenshot from RoboHelp 8 where you can select the JavaHelp version and that should make the code change for you.

I encountered this problem recently and was assisted by an Adobe contact.

I was advised to check the value of a registry key and found it did not exist. So I created it and copied the details from a working machine.

The key was

HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Shared Tools\Text Converters\Export\RHRTF

Click here to see the details I set up.

It's a long session but this is where to go. The recording of RJ (R Jacquez)'s live eLearning session.

Pete Lees posted the following in response to a question about moving from WinHelp to HTML help (CHMs).

It ought to be fairly quick and straightforward for your developer to change the old WinHelp API calls to HTML Help API calls. Microsoft modeled the HTML Help API on the WinHelp API in order to simplify the process of updating existing applications from WinHelp to HTML Help.

For example, a typical WinHelp API command looks like this:

WinHelp(HWnd, "helpfile.hlp", HELP_CONTEXT, 1001)

The HTML Help API equivalent is almost the same:

HtmlHelp(HWnd, "helpfile.chm", HH_HELP_CONTEXT, 1001)

Perhaps the following resources will help your developer:

http://www.mshelpwiki.com/wiki/tiki-index.php?page=HTMLHelpArticles

http://msdn.microsoft.com/en-us/library/ms524256(VS.85).aspx

One person reported that their browser based AIR help was fine but in the locally installed version they were not seeing the correct styles. I checked it out on my machine and it was fine. I was able to ascertain though that this problem had been seen and there is a solution.

Switch on the option "Convert RoboHelp edited topics to HTML" in Tools > Options.

This requirement has come up several times in forum posts. RoboHelp 8 has added a Resource Manager that can be used for resources used across multiple projects but once they are in a specific project, there is no means of updating them. Leon's method overcomes that.

Leon's method is:

1. Create a separate "phantom" project that contains all snippets.

2. Create a single topic that has all snippets inserted, for easy viewing. (I'd probably add keywords as a "caption" for each inserted snippet, for easy searching, since some might have unsearchable images.)

3. Sync all snippets in the project to all local machines (daily?), effectively overwriting old versions. (PG Note: You will need some sort of synchronisation tool. There are many available. For this purpose I would use SyncBack. It can be set to copy files to each location and it can be set to autorun.

You could also sync your user-defined variables by maintaining them in that same phantom project. The difference with UDVs is that they are all contained in a project's rhvariable.apj file. This file could also be synced to all projects to propagate updates.

With Related Topics when you insert the button you are presented with a list of topics in the project and you link those to the button.

With See Also you select a Keyword when you insert the button. Those keywords are ones that you have entered as you create topics. You don't have to stop and figure out which topics get displayed. RH displays all the topics where you have entered the keyword in the properties. So every time you create a topic about Pop Music you enter the keyword Pop, every time you create a topic about Classical Music you enter the keyword Classical. When you add a See Also, you select Classical and all the topics with that keyword will display when the user clicks the See Also button.

Generate FlashHelp and it works just fine, copy the folder to another location and displays a blank page. If that is the problem, follow this link. www.robowizard.com/RoboWizard/Tutorials/FlashSettings.htm

If you right click in the Topic List you will see a context menu, at least, you should. A couple of people were not seeing that and they were not seeing any columns such as Topic Title and File Name. Eventually we found the bug. That menu is lost if you close RoboHelp while the topic list is in List View mode and that of course also stops you changing out of List View! Here's the solution.

Go to View | Details View and you will get a blank topic list.

You now have to go to Topic List Details and select at least one column from the dialog that appears. At this point, right clicking will simply invoke the columns menu.

Close and open RH again and the chosen columns will appear and the context menu will work. You can choose further columns by right clicking the heading for any existing column.

You might find this link useful. There is also quite a bit of information in RoboHelp's own help on what will and will not work after conversion.

Following reports on the Adobe forums that the TOC does not display in Google's Chrome browser, the following fix was posted by Adobe within 24 hours.

You need to make some changes to the whvers.js file that can be found here

C:\Program Files\Adobe\Adobe RoboHelp 7\RoboHTML\WebHelp5Ext\template_stock folder

Add the following two lines at the top along with other variable declarations.

var gbChrome = false ;
var gbChrome=(gAgent.indexOf("chrome")!=-1);

and then add a condition
if (gbChrome)
{
gbSafari = true ;
gbSafari3=true;
}

Alternatively you can download a replacement file by clicking here. You might want to rename the original file first as whver.old or similar or save it somewhere safe as a precaution.

Adobe advise that this should fix TOC/Index/Glossary/Search loading issues as well and have requested that you report any other issues with Chrome as they are actively trying to fix them. Click here to report any further issues.

A very small number of people have encountered problems opening RoboHelp 7 even though they have followed the correct procedures. Kurt Sloan posted this solution which, I am advised by Adobe, seems to be Vista related.

1. Right-click on the "Adobe RoboHelp 7 HTML" icon
2. Click on "Run As..." from the menu that appears
3. Select "The following user" option
4. Enter your own credentials (yes, that didn't make sense to me either since the "Current User" was set to my credentials already)
5. Click OK

Typical Rick! After I told someone that I didn't think you could change the default width when you use RoboHelp's Insert | HTML | Insert Line function, Rick posts the answer! Neat trick sir. Here's what Rick posted.

You have to close RoboHelp and open your Registry Editor.

All disclaimers apply. Don't come cryin to me if you munge your registry and don't have a backup. Yadda yadda yadda.

Got Regedit open? Cool. Try navigating to this HKEY:
HKEY_CURRENT_USER\Software\Adobe\RoboHelp\7.00\RoboEditor\Defaults

There are many many entries in this spot. You want to locate the one that reads:
InsertHRSample

Double-click that entry and you should get a dialog allowing you to change its value. Mine looked like this before:
<hr style="width: 50%; float: aligncenter;">

I modified it and now it looks like this:
<hr style="width: 95%; float: aligncenter;">

Close Regedit and restart RoboHelp. Insert a Horizontal Rule and bask in the glory of your new desired width.

The activation of version X5 and before can no longer be done online.

X5

Click this link and note the steps there and the order of them.

There are links to the patches you need to install after reinstalling X5 from your CD.

- The 5.01 patch is below the heading Word 2003 Support Update. Hover over the link and the status bar will include 5.01.

- The 5.02 patch is below Microsoft XP Service Pack 2 Support Update - X5.0.2

There are also links to the replacement exes that you will require so that activation is not required.

I suggest that you burn these downloads to CD with a note of the procedure. Keep the CD with your X5 CD so that you have all you need if a future reinstallation is required.

X4

For all earlier versions that require activation, phone your local telephone activation centre.

Start the installation process to get the code that will be required. You can also email and there will be an option to do that during the installation process.

The information for X4 is being checked. I am not sure it is still correct. It may be that Adobe now upgrade you to X5 to follow that procedure. Pending an update, pursue that line with them.

Snippet updated 15 Aug 2009.

In this thread Pete Lees points to Helpware's article explaining how this can be caused by links to topics outside the project. In case the thread is not available, it can be read in this text file.

In another thread, Leon Descoteaux (MergeThis) suggested corruption in the single source layout and creating a new one fixed the problem.

First let me explain "Unknown". I saw this link while browsing and made a note of the site below but not of where I found the link. So my thanks to whoever found the site, whoever you are!

OK. Sometimes the problem is not learning the tool but learning the job. That's where this link might help you. I don't agree with all the detail but nonetheless there is some good information. Approach what you read this way, as you read the pages, don't treat them as gospel but as food for thought. There's certainly more information about your new environment here than anywhere else I have found.

Click here. to go to Wikiversity. Enoy the course!

Item 30 in Using Adobe RoboHelp 7 covers the changing of the font colour where the supplied colours are not what you want. The method there sticks when you regenerate the help. Chris wanted something different and did not mind a simple bit of behind the scenes swapping of files post production. Here's what he came up with, very nicely documented.

In whtopic.js (which you must save out separately to avoid it being overwritten on regen), there are two functions to be edited: AddMasterBreadcrumbs and GetMasterBreadcrumbs. In both cases, the variable that is modified is named strTrail. Here is how it looks in the default state:

AddMasterBreadcrumbs

var strTrail = "<a style=\""+ styleInfo + "\"" + " href=\"" + strHomePath + "\">" + strHome + "</a> " + separator + " ";

GetMasterBreadcrumbs

strTrail += "<a style=\""+ styleInfo + "\"" + " href=\"" + sHrefFullPath + "\">" + name + "</a> " + separator + " ";

To modify the breadcrumb style throughout the help system, change the HTML tag for style from <a> to <p>, and insert the <a> tag in front of the href instead, with >< brackets immediately preceding. Add in-line style elements as desired between the first two quotes in the style element. This must be identical in both functions. In the example below, I have changed the font to 8 point and the weight to bold:

AddMasterBreadcrumbs

var strTrail = "<p style=\"font-size:8pt; font-weight:Bold;"+ styleInfo + "\"" + "><a href=\"" + strHomePath + "\">" + strHome + "</a> " + separator + " ";

GetMasterBreadcrumbs

strTrail += "<p style=\"font-size:8pt; font-weight:Bold;"+ styleInfo + "\"" + "><a href=\"" + sHrefFullPath + "\">" + name + "</a> " + separator + " ";

That's all there is to it! Any other in-line style attributes, such as colours and font families, can be added in this fashion.

Nice one from Jeanne:

"I use this all the time

http://www.globalrendering.com/download.html

Its a free tool called Translator's Abacus and it can count words in any set of files."

See item 30 in Using RH7

RoboHelp 8 allows you to exclude topics from the search engine through Topic Properties. Follow this link if you want to exclude topics in earlier versions.

Here's how.

Sometimes you want to enter characters such as © or something more obscure such as ¶ or ∑ that are not in RoboHelp's symbols. Here's the easy way that accesses all the characters available on your PC, including unicode, provided you have some unicode fonts! Look for Arial Unicode MS.

Go to Start | Run and type in charmap. Locate what you want, click Select and click Copy, then paste it in.

Select the Advanced view and then Group By "Unicode SubRange". An additional dialog appears making it easier to find what you need.

Snippet updated 24 Mar 2008

This is one for RoboHelp for Word users. It is a sign that you have the wrong version of the templates installed and is seemingly easily fixed.

First look in the project folder and see if that contains a copy of RoboHelp.dot. That template should not be stored there but some people like to save a copy in the project. If you do find a copy there, it may be that it is from an earlier version of RoboHelp and the template versions are incompatible. Move the template outside the project and then open the project again. RH will look for the template that should be in Documents and Settings (Windows XP) or Users (Vista) and that should be compatible.

If you continue to get the problem, again close RoboHelp and locate the template in Documents and Settings (Windows XP) or Users (Vista) and move it to a temporary location. On reopening the project and without a copy of RoboHelp.dot in either of those locations or the project itself, RH will now take a copy from Program Files and that should fix the problem.

If you had customised the old template in any way, you can use Word's Style Organiser to reimport the styles from the copies you moved.

In the unlikely event you still get the error, you may also need to do the same with your Normal.dot template. I am told by a senior Adobe software engineer that this should not be necessary based on the way RoboHelp.dot works. However, one person at least found it did fix the problem so it may be that a factor outside Adobe's control can affect things. Not sure on that one and certainly you do not want to lose Normal.dot unless you absolutely have to. Again, keep a copy somewhere so that you can import styles and macros back in.

Here's what I was told.

"I guess RoboHelp_CSH.cls got replaced by RoboHelp_CSH.frm (used in VB projects) in X5."

If you do need RoboHelp_CSH.cls, click here to download it. Not something I have used so if it proves not to be what you needed, don't blame me! I am simply making the file available.

Ed Larrabee reported:

"Every time I try to do this the installation fails with a message that says the installer found a more current product installed, and hence will abort the installation. The problem is that I have no idea what this more current product is and how to remove it."

The Gunslinger came to the rescue:

"I have seen situations in which Adobe Reader caused an installation conflict.

Imagine that a user installs Adobe Acrobat 5 when it is released. Then, version 6 is released. The user sees no need to upgrade Acrobat but does install Reader 6. Version 7 is released. The user upgrades the Reader but not Acrobat. Version 8 is released. The user upgrades the Reader but not Acrobat. Later, the user is offered a copy of legitimate upgrade of Acrobat 7. The user attempts to install it. The installer sees Reader 8 and halts the installation. (I suspect that the problem is related to Acrobat and Reader being developed from the same codebase long ago.)

On several occasions, I have encountered this issue and successfully resolved it by using the following method. Uninstall Reader; start with highest version number and work backward to lowest. Reboot. Uninstall Acrobat; start with highest version number and work backward to lowest. Reboot. Install Acrobat; install latest full version first, then install updates (start with lowest numbered update and work forward to highest). Reboot. Install Reader; install latest full version, then install updates (start with lowest numbered update and work forward to highest). Reboot.

This is a time-consuming process, but it has always worked for me."

Sometimes when you import a topic, RoboHelp reports that the topic, all images and other associated files have been imported but you cannot see the images in Project Manager. A check via Windows Explorer shows they are there but not according to Project Manager.

This is easily fixed. In Project Manager, create the folder using the name given in Windows Explorer. Not only will the folder be created, suddenly all the images will appear.

Techscribe found that RoboHelp's Multi-file Find and Replace Tool always opened topics in Word, even though that was not in his list of HTML editors in RoboHelp. The reason is quite simple. The tool uses whatever is set as Internet Explorer's HTML editor. Fixing that is easy, unless of course the IE dropdown does not include the editor you want to use. To fix that, visit http://windowsxp.mvps.org/htmleditor.htm. You need to download a small program. I cannot vouch for that but it did no harm on my PC, yours may be different.

Colum McAndrew posted this useful information to enable multi-line text fields to be formatted.

First off, generate a single cell table and format the text (code snippet ) as required.

Next create a form containing a button and a multi-line text field.

In the <Head> section paste:

<script LANGUAGE=JavaScript
type="text/javascript">function copy2Clipboard(element)
{
element.select(); // Only works for text boxes.
textRange = document.selection.createRange();
textRange.execCommand("RemoveFormat");
textRange.execCommand("Copy");
}
</script>

Change the button properties to
Control Type = Plain Button
Button Caption = Copy to Clipboard
Control Identifier – Delete the default value to leave a blank field

Also add onclick="copy2Clipboard(namehere)" to the end of your <input type=submit value=Button> statement so that it reads
<input type=submit value=Button onclick="copy2Clipboard(namehere)">

Change the multi-line text field properties to
Control Identifier = namehere (where namehere is the value you specified above)
Initial text = Paste the code snippet to be copied to the PC clipboard.

Also add style="height: 1px; width: 0px;" to the end of the multi-line text area code.

Note: If the above style statement is set to style="height: 0px; width: 0px;"> a bug generates acres of blank space between the end of the multi-line text box and any other following content.

http://www.robo-forum.helpdesign.eu/index.php?c=1 (Robo-Forum)

http://www.robo-forum.de/cgi-bin/ultimatebb.cgi (Archive)

A few RoboHelp users have encountered a dialog advising them that a .book folder has been created. I haven't seen this one but RoboWizard has and here's a thread with an answer.

Date Posted:

10/30/2007 11:05:13 PM

Posted By: FMnRH (Junior Member)

Hi,

After removing the "_" in between words in the Topic Title field of the Topic Properties dialog box, a "Notice" pop-up window appears stating the following:

Note that the 'book folder" C:\ (location of topic)\topic_name.book\, was created to hold the document and its resources.,

I click the OK box to close the Notice window. ,

I've never seen this message before when removing the underlines in the Topic title. Is this typical RH behaviour or have I done something wrong to prompt this notice message to appear?,

Thanks,

FMnRH ,

Date Posted:

10/30/2007 11:13:48 PM

Posted By: RoboWizard (Senior Member)

Uhhh, what version of RoboHelp are you using? Is it 6 or the new 7? I ask because there is a very elusive issue that the development team at RoboHelp has never been able to replicate surrounding this quirk. Normally, it's been my experience that it has only happened with imported content. You import content from Word and make a change via the properties dialog. You probably found that after seeing the message, the topic made an odd whooshing sound as RoboHelp lost track of it and placed the red X on it indicating it has gone missing. ,

The easy fix is to right click the topic reference and choose the Properties again. Then choose the File tab. After you do this, choose the "Open Folder" icon. This gets you near where you need to be. Inside this folder you should find another folder. If your topic was initially named whatzit.htm, you should see a folder named whatzit.book. The topic will have been moved inside the folder. So to fix things, from inside Windows Explorer, drag the topic from the .book folder back to the folder containing the .book folder. Once you do this, RoboHelp will once again be aware of the topic and things should work better.,

Cheers... Rick,

Date Posted:

10/30/2007 11:51:39 PM

Posted By: FMnRH (Junior Member)

I did what you suggested (moving the .htm file back to the original folder) and another RoboHelp HTML pop-up window appeared:,

The reference to the file, "C:(location of project folder)\originalfolder.css", from the file "C:(location of original folder)\whatzit.htm" contains illegal...,

Couldn't see the rest of the message because the location of the files were so long (buried under many sub-folders) and I couldn't re-size the pop-up window to see the whole message.,

Any suggestions? Should I be concerned about the illegal (unknown) things?,

Thanks,,

FMnRH,

Date Posted:

10/31/2007 12:00:09 AM

Posted By: Captiv8r (Senior Member)

Hi again,

Normally what happens is that the topic loses its reference to the style sheet. You should be fine. Just re-attach the style sheet by clicking the little toolbar button. (Looks like a little notepad icon),

Cheers... Rick

Sheela worked out this method.

1. Name the cell(s) you want to refer to in the Excel sheet. Insert | Name | Define.
2. Create a link to the file (normal procedure in RoboHelp)
3. Go to the TrueCode tab and insert # and the name you gave as a suffix to the link. (It doesn't work if you attempt to do this in the hyperlink dialog.)
4. Save the topic as usual and check the link in Preview mode.

Sheela advises that RoboHelp will prompt to import the spreadsheet and that has to be done if the link is to work.

Try this link to Microsoft's site. It shows a Word 2003 screen. When you hover over a function, it tells you where to find it in Word 2007. If you find the change just too much, then look at Word 2007 Ribbon Customiser on my Links page.

This snippet was corrected on 24th November 2007.

If you have both versions on your PC, you will notice that when you change from one to the other, you get different messages. Word 2003 will tell you "Preparing to install..." while Word 2007 tells you it is "Configuring Office...".

Here's how to stop that if you are comfortable editing the registry and that does not contravene your company policies.

1. Create a system restore point
2. Open and close Word 2007.
3. Click Start | Run | Regedit
4. Navigate to to HKEY_CURRENT_USER \Software\Microsoft\Office \11.0\Word\Options
5. Right click in the right pane and create a new DWORD value.
6. Name this NoRereg [previously shown incorrectly as NoReg].
7. Double click it and give it a value of 1. (Decimal or hexadecimal doesn't matter).
8. Close Regedit

Open Word 2003 and it will open without the message. Open Word 2007 and it will open without the message.

If you double click DOC files in Windows Explorer this seems to be the behaviour:

• If neither version of Word is open, the document will open in Word 2007.
• If both versions of Word are open, the document will open in Word 2007.
• If only one version of Word is open, the document will open in that version.

Before generating printed documentation from the HTML versions of RoboHelp X5 or RoboHelp 6, you will need to change the value to 0 and open Word 2003 first.

RoboHelp for Word

I have not tested the revised instructions with RoboHelp for Word so check it works OK with that version.

People often ask whether or not it is necessary to publish all these files. In my opinion the short answer is Yes. In response to a recent forum thread on this subject Gravenstein posted:

The RoboHelp help topic "Output Files for WebHelp" states:
"...The output files located in !SSL!\WebHelp\whgdata are HTML data files used in Pure HTML versions of WebHelp."

"...The output files located in !SSL!\WebHelp\whdata are HTML/JavaScript data files used in DHTML versions of WebHelp running on earlier browsers (such as Internet Explorer 4.)"

"...The output files located in !SSL!\WebHelp\whxdata are XML data files used in Java applet and DHTML versions of WebHelp running on later browsers (such as Internet Explorer 5 and Netscape Navigator 6.)"

Reading that, it would seem like you could delete at least whdata (and maybe whgdata) if you knew your users were running on a late-model IE only. I haven't actually done any testing on this, but I have thought about it. Is there more to it than meets the eye?

Rick Stone (RoboWizard) has a page on his site devoted to this area. Click here.

Gravenstein indicated that in her project these files amounted to about 300mb. My take on that is:

We are talking about less than half a CD here and into freebie memory stick territory. Against the risk of breaking the help in some way that nobody can foresee until months later when this is forgotten, it doesn't seem worth even a vague thought. I take your point about what is in the help but there's always the risk that it was either never 100% correct or that program changes have rendered it incorrect. Such things happen in any organisation. New developers, new authors etc, I'm with MergeThis. It isn't worth the risk for the saving.

Sometimes the pressure to reduce the size of the help comes not so much from considerations of the server on which it will ultimately reside but on the media that will be used to deliver the application and the help. It can be as simple as trying not to go from CD to DVD or not going to one more CD or DVD than is already needed. Ask the developers if all their folders and files are needed. When they look horrified that anyone could be so stupid as to ask, just smile back.

In the early days of using RoboHelp, I encountered a problem when using the Preview option. The images on the page were upside down and reversed. If I sent the same page to another printer, it printed correctly. I called in the printer engineers after failing to find a solution. They stated that it was a print driver problem and referred to it the printer manufacturer. They confirmed they too thought it was a driver problem but I left the company before the issue was resolved.

Over the years a small but regular number of posts have appeared reporting the same problem.

Echopraxia responded to a recent post:

If you have PrimoPDF installed, I've seen that happen as well. It's a conflict with the Amyuni (print/conversion) driver.

I have used that program in the past and it is quite possible it was installed on the PC I was using. So if you have PrimoPDF installed, or any other PDF converter that use the Amyuni driver, you could try uninstalling it, maybe updating the printer driver, and then seeing if the problem goes away.

Amyuni are the producers of PDF Creator but they also allow their converter to be used on an open licence basis by anyone else. Thus the problem could also arise from any application on your PC that uses their driver.

Marguerite Quijas advised me that installing the templates that can be found by clicking this link solved the problem for her.

foo@bar reported

When opening the project, it can be 20-30 minutes before the program becomes usable. CPU usage is maxed out, while "Building file list" is displayed in the lower left. Using a file monitor utility, I can see that Robohelp is reading all files referenced in the project, and writing to the CPD file. This occurs on every opening of the project, and has been attempted on multiple machines & installations of RH6, so I'm certain it's something with the project itself.

Gravenstein replied

Try replacing the rhvariable.apj file ...

and later added that a malformed rhvariable.apj file had been giving her a problem and that copying one from another project had fixed the problem.

This would of course lose any variables set up but I suspect this problem is occurring in projects that don't have any set up.

One poster reported that it worked for them while another said it made no difference, however they had other problems as well.

Gravenstein pointed out that one of the sample projects had no such file and I know that opens OK without creating an rhvariable.apj file.

So on the face of it, a project with a good rhvariable.apj file will open OK as will a project with no rhvariable.apj. However, if there is something wrong with the file, it seems it can hinder the opening of the project.

The code of a blank file appears below.

<?xml version="1.0" encoding="windows-1252"?>
<rhpml majorversion="1" minorversion="0">
<variables>
<variable>
<name>Placeholder</name>
<value>xxxx</value>
</variable>
</variables>
</rhpml>

The full post can be found here or open the PDF.

From time to time there are posts from people who are finding their project seems a bit slow and they have found the CPD file is has grown larger than they are used to seeing. Often people, myself included, will suggest deleting the CPD file and letting it rebuild. As you can see in my topic on Opening Projects, a few things get lost but they are easily fixed.

Sometimes if people have a copy of Microsoft Access, compacting the database is suggested. This is a standard procedure on any Microsoft Access database that users of that program will be familiar with. If you do go that route, bear in mind the CPD file (or its predecessor the MPJ file) are Access 97 databases.

Another option was brought to my attention by Dirk Bock, long time supporter of this forum. Microsoft provide a free tool that does the same job. It is known as Jetcomp and the link will take you to the download page. Do read the instructions and warnings.

That has the advantage that it will compact your database without any loss.

After taking a backup, change the file extension from CPD (or MPJ) to MDB, the normal Microsoft Access extension. After running the tool, change it back.

A few people encountered a problem where on importing into RoboHelp 6, it was creating a title which was the same as the file name and with underscores. In previous versions, the content of Heading 1 was used.

See this Adobe TechNote.

Vasont Systems have put a really straightforward explanation of Content Management on their site. It's the clearest explanation I have seen.

If you want to run your help or any other HTML file from a CD, here's a useful link to a free utility.

Click here to visit AutoRunPro and download the files. Note I am referring to AutoRunPro, not AutoHTML.

Click here to visit a useful page to help you set things up.

Click here to download a little demo that I have set up. Just run AutoRunPro.exe to see what will happen when you burn the files to a CD. Better still, copy the files to a CD and insert it.

A number of people have reported that since upgrading to RoboHelp 6, their links in webhelp to PDF files no longer work. It is in fact because they are generating with the Mark of the Web (MOW) option selected and that output is being placed on the server. The MOW is only intended to allow authors to view their work locally. It is not meant to be included in the final output. Mostly that does no harm but it will prevent links to baggage files from working.

A small number of people have reported getting this message when trying to delete topics. Initially the only solution was to create a new project and import all the topics and the contents of the HHK and HHC files. Topics could be deleted on another PC with RoboHelp installed but that did not solve the problem next time you want to delete something.

Eventually Doug Wood came to the rescue. His colleague Calvin Wilson ran into the problem and Doug used some tools to compare files in a project. He identified differences in the PSS file and that if you delete it RoboHelp rebuilds with no apparent issues. I have since had confirmation from Adobe that this is a file that can be deleted safely.

So just close your project, use Windows Explorer to delete the PSS file and then reopen your project. You will lose some information about when a Single Source Layout was last created but the problem will be solved.

In theory you should just need to add this line below your existing style sheet reference, using the name and path for your print style sheet.

<link href="print.css" rel="stylesheet" type="text/css" media="print">

I decided to try it and of course it is not quite that simple.

The first line below is how RH references the normal style sheet in the source. The second line I added in the true code view and I then immediately saved and generated, having added print.css to baggage first.

<link rel="StyleSheet" href="standard.css">
<link href="print.css" rel="stylesheet" type="text/css" media="print">

That worked but as soon as you switch to WYSIWYG, you see your topic with print.css applied! Not what you want.

Go back to true code and you will see RoboHelp has helpfully "corrected" your code. At that point it appears it cannot be made to work in the real world so I then tried working on the output instead.

I found the closing head tag </head> and inserted the reference to the style sheet to give

<link href="print.css" rel="stylesheet" type="text/css" media="print">
</head>

The good news is that worked in the simple example. Realistically though your topics are going to be in folders at different levels so some topics will require the path to the style sheet to be amended to ../print.css or ../../print.css etc. How to deal with that simply?

Do a multifile find and replace in several passes working on the output. I would use FAR from www.helpware.net. RoboHelp's own tool should work for this one but I never rely on that, just in case its limit to working on one line causes an issue.

PASS 1

Search for

<link rel="StyleSheet" href="standard.css">

and replace with

<link rel="StyleSheet" href="standard.css"><link href="print.css" rel="stylesheet" type="text/css" media="print">

PASS 2

Search for

<link rel="StyleSheet" href="../standard.css">

and replace with

<link rel="StyleSheet" href="../standard.css"><link href="../print.css" rel="stylesheet" type="text/css" media="print">

and so on.

It worked in my tests but do make sure you take a backup of your project before you do this.

The process will need to be repeated every time you generate and that introduces another wrinkle.

The search criteria above will find topics you have tweaked before as well as the new ones. If you used FAR, you could search once on

<link rel="StyleSheet" href="standard.css">

and delete all other topics from the list FAR generates.

Then search for

<link href="../print.css" rel="stylesheet" type="text/css" media="print">

and delete from the new list all the topics where that is found. Then you have a list of files where you need to do the find and replace to add the style sheet.

It sounds clunky but in reality when you have done it the first time, you will find it quite simple and quick, just so long as you are careful.

Snippet 68 describes a problem with projects generated using a build expression where a topic has merged cells in the last column of a table.

Another problem was reported on the RoboHelp forums about links to topics not in the project, including links to topics in a child project in a merged webhelp setup. Such links would work fine in a topic but not if the same path was used in the TOC. RoboHelp would refuse to generate the project with such a link in the TOC.

1. Click here to download a zip file that contains two replacement DLLs.
2. Close RoboHelp 6.
3. Locate BuildTagExpr.dll and MpjSingleSource.dll. You should find them in
   C:\Program Files\Adobe\RoboHelp 6.0\RoboHTML
4. Rename the existing files. I added ORIGINAL to the file extension.
5. Add the files from the zip file.
6. Open RoboHelp 6 and the projects should now compile.

Note that these files are as supplied by Adobe and I accept no liability for any harm that may be done to your project, computer, network or the universe. All I can say is that I have tried them on two PCs without any problems. If you do not accept that, please do not download the files. You can obtain them direct from Adobe Support if you prefer. Click this link.

After seeing a number of posts on various forums reporting the startpage#target method no longer works under IE7 I did some testing. What I found was if you open the help at the startpage and then add the hash and target details in the browser address bar, then the new page does not display, IE7 continues showing the original default page. This leads people to perceive that the method doesn't work.

It's not quite that simple though. It fails if you add the # and target details after calling the startpage normally but using hyperlinks the method worked for me and some others who have tested this.

1. Click this link.www.grainge.org/webcall/startpage.htm
2. When the default topic displays add
   #folder/target.htm
   to the end of the address bar.
   You will not be taken to the target topic as you would expect.
3. Now click this link and you will see the method does work.
   www.grainge.org/webcall/startpage.htm#folder/target.htm

So where your users will access target topics via links rather than typing into the address bar, the method is still good.

Also the method works when you use the startpage#target method as the first address you type in the address bar. It only fails for me when I add #target, not if I use it from the outset. Using forward slashes in the path avoids some problems.

It does seem however that calls from an application may not work. One poster reported "I've just gotten a confirmation from Adobe, that my issue with IE7 is a browser problem not a RH problem.  Apparently, other product help systems are affected and many reports have been sent to Microsoft to work the problem out."

Click here if you want to download the demo output and test it locally. Unzip to your C Drive to the default folder webcall. Double click the file TEST.HTM and follow the instructions there.

You apply a condition to a table in a topic and any tables after that one also disappear when the condition is invoked. Here's the workaround.

1. Remove the condition from the table.
2. Now select all the rows in the table but not the table itself.
   To do this start with the cursor in the top left cell and keeping it within the table borders, move the cursor down to the bottom right cell
   OR
   Follow Harvey Kabaker's tip and click inside the table, then go to the Table menu and choose Select | All Cells.
   

This applies the condition to all the cells but not the table itself.The result is the same in that the table is "removed" when the condition is used but this way, other tables will not affected.

UPDATE: A patch has been made available by Adobe that fixes this problem. See Snippet 71. Read this topic first to check that this is the problem you are encountering, then try the patch.

A report was posted of RoboHelp 6 crashing when using a conditional build expression in a topic that also had merged table cells. If the same topic was previewed or generated without the condition being used, all was well.

Harvey Kabaker discovered the problem arose only if the merged cells were vertical cells and only in the extreme right column. As soon as there was a merge between any other cells, the problem went away.

Using Harvey's discovery, I found that the solution was to add a column to the extreme right and apply a condition to it so that it was never in any output. That fulfilled the rule that the problem only arose if the merge was ONLY in the end column. With this extra column, RoboHelp no longer crashed. It also meant the table sized properly if you were using percentage widths so the user would not be aware of the fix.

This is the combination that caused RoboHelp 6 to crash.

• A topic has merged cells only in the right hand end column

AND

• A build expression is used when previewing or generating any output.

Note
The tag(s) in the build expression might not even be used in any topic in your project.
RoboHelp 6 would crash with the combination of ANY build expression AND just one topic with merged cells only in the end column somewhere in your project.

If you are not sure whether your topics have any merged cells, do a multi-file search using a tool such as FAR or BKReplaceEm. Search for <td_null>.

If a button is a hyperlink, then when the mouse hovers over it, the cursor becomes a hand. However, it will not automatically do that if the button is calling some javascript.

The HTML for the buttons at the top of the page by default would be along the lines

<p><img src="path/filename ....... </p>

and no hand would appear.

Amend that to

<p><span style="cursor:pointer"><img src="path/filename....... </span></p>

and you have your hand.

Click here.

Click here to see Adobe's Tech Note.

One poster wanted what they described as "a vertical layout in WebHelp similar to that offered in the vertical skins for FlashHelp". This means the TOC appears above the content. They found the solution below.

"I have found that the skn file in !SkinSubFolder! for the project contains two instances of frameset cols = "220,*": changing these to frameset rows = "220,*" seems to achieve the desired effect, and I have not yet found any glitches with the output (at least with IE6 as browser).

Philip was working on a RoboHelp project and generating a CHM output, only problem was the index tab was missing! After a lot of poking around Philip found the solution. All his keywords were in the topics. By telling RoboHelp to create future keywords in the HHK index file, adding a single index word and then switching the setting back to store keywords in topics, the problem went away. It seems you need at least one keyword in the HHK index file.

There is information in my Merging Help with RoboHelp 8 article.

You can also try this link for additional information about merged CHM help.

If you have problems with the merged TOC, the following was posted by Pete Lees on the RoboHelp forum.

To merge the TOCs successfully, you need to use the TOC & Index Editor in FAR (http://helpware.net/FAR/index.html), an inexpensive shareware tool that is free to use for the first couple of months. Or you can edit your master contents file manually, in a text editor like Notepad, and then recompile the .chm file with HTML Help Workshop, as described here:
http://helpware.net/htmlhelp/how_to_merge.htm#Known%20Bugs

When selecting the Topic Preview (eyeglasses) toolbar button, pressing <Ctrl>+W, or selecting View > View (topic title), the preview window never appears.

This problem pops up from time to time and Amebr posted this elegant solution:

1. Click the View icon, so that the Preview is in focus.
2. Press Alt, Space, M
3. Press any arrow key, then waggle your mouse around. The window should snap from wherever it is hiding onto your cursor.
4. Click to put it down.

Prior to Amebr coming up with this, Rick Stone had posted the answer below which I am keeping on file, just in case. I don't trust those elves. One day they will break Amebr's solution and we may need this one again.

Rick's solution

[The references to "I" refer to Rick Stone. ]

I haven't a clue as to how this occurs, but I occasionally see posts about this in the forums. Somehow, the screen coordinates for the missing window have become set to your computer's equivalent of Jupiter. (I used to say "Pluto" here, but alas, they demoted the poor little guy from planet status) The window is indeed there. However, it's been moved off the visible area of the screen.

How to correct it

Close RoboHelp HTML.

You need to do this because the values we are about to change will be destructively changed once we close RoboHelp HTML and restart.

Open the Windows Registry Editor.
(All standard disclaimers apply. Back up the registry, sacrifice a chicken, yadda yadda yadda)

Locate the following key:
HKEY_CURRENT_USER\Software\version\RoboHTML\version\MontereyFrame\

Double click the item labeled Preview in separate window and ensure the value is set to 1. If it already is, terrific. If not, change it to 1 and click the OK button. It doesn't matter if the option is set to Hex or Decimal.

Double click the item labeled PreviewMaximized and ensure the value is set to 0. If it already is, terrific. If not, change it to 0 and click the OK button. It doesn't matter if the option is set to Hex or Decimal.

Double click the item labeled PreviewWindowCX. Make sure the option is set to Decimal and set the value to 50. Then click the OK button.

Double click the item labeled PreviewWindowCY. Make sure the option is set to Decimal and set the value to 50. Then click the OK button.

Double click the item labeled PreviewWindowX. Make sure the option is set to Decimal and set the value to 50. Then click the OK button.

Double click the item labeled PreviewWindowY. Make sure the option is set to Decimal and set the value to 50. Then click the OK button.

Close the Windows Registry Editor.

Restart RoboHelp HTML and preview a topic.

The window should now be floating above the RoboHelp HTML application in full view.

Dual Monitors

Also Duke Hillard emailed me to advise "I have one possible cause: changing monitors. I went from dual monitors (17-inch) to a single monitor (22-inch). After the transition, my Preview Window was missing. After reading your snippet, I went to “regedit”. I found that the values for size of the Preview Window were normal but that the values for the location of the Preview Window were too large for my existing monitor (i.e., the Preview was being placed into a space on a second monitor that no longer existed). Along that same line of thought, a second possible cause for the Preview to disappear is a RoboHelp user accidentally invoking Windows shortcut keys to move a window and accidentally moving the window far off their monitor."

The link below gives instructions on getting RoboHelp 6 to run under Vista. Please note the warnings and that you will not be eligible for Technical Support. Basically, if it all goes pear shaped, you are on your own for running RoboHelp under an operating system for which it was not designed.

http://www.adobe.com/go/kb400360.

In this post, one of Adobe's own people reported his own findings adding:

"Please note that Adobe Technical support may not be able to resolve Windows Vista related issues on both x5 and 6. We do strongly encourage users to report issues that they are seeing in these environments."

This is a common complaint but it is one not restricted to RoboHelp. There are many HTML editors that lose the formatting when you paste something from Word or other applications

If you have Dreamweaver 8 (or perhaps earlier versions) then you can paste into that and then lift the code from there and paste it into RoboHelp's true code view. If you don't have Dreamweaver, you could try NVU which is free and will do the same thing.

Be careful with tables though as RoboHelp's WYSIWYG editor writes the tables in a different way in the source files to most editors.

Tyler Waters lost one of his toolbars and decided to attack the registry. Unfortunately it bit back and initially he lost all his toolbars. Rick Stone advised that sometimes a toolbar goes missing, often when moving it around, and that it usually involves a trip to the registry. However, given that all the toolbars had gone missing, he advised uninstalling and reinstalling RoboHelp first.

Unfortunately that did not work for Tyler. Now it may be that Tyler's uninstall did not include the registry changes covered in my topic on installing RoboHelp and it may that method followed by Rick's suggestion would have worked. We'll never know as Tyler decided to investigate what was in the registry a bit further and spotted the problem. He has kindly written that up and the rest of this snippet is Tyler's work. Many thanks Tyler.

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

First off, the instructions in this snippet include messing with the registry. It is recommended that whenever you mess with the registry to try and fix something that's broken, you should ALWAYS make a backup first in case you mess it up even further.

The registry folder with all the toolbar keys is located here:

HKEY_CURRENT_USER\Software\eHelp\RoboHTML\13.00\Components\4\

Within this folder there are keys that control where the toolbars reside and how they are docked:
ToolBarDockID[X]
ToolBarDockIdealRectCX[X]
ToolBarDockIdealRectCY[X]
ToolBarDockIdealRectX[X]
ToolBarDockIdealRectY[X]
ToolBarDockRectCX[X]
ToolBarDockRectCY[X]
ToolBarDockRectX[X]
ToolBarDockRectY[X]
ToolBarFloating[X]
ToolBarFloatingWidth[X]
ToolBarFloatingX[X]
ToolBarFloatingY[X]
ToolBarVisible[X]

There are 5 sets of these keys, one for each toolbar Where x=
1 - Formatting
2 - Objects
3 - Tables & Borders
4 - Positioning
5 - View

With that said, the instructions:

1. Ensure RoboHelp is CLOSED.
2. Open up regedit.exe
3. Navigate to the following directory:
   HKEY_CURRENT_USER\Software\eHelp\RoboHTML\13.00\Components\4\
4. Identify the toolbar that is missing... where [X] is the missing toolbar (see X values above)
   Change ToolbarVisible[X] to 1
   Change ToolbarFloating[X] to 1
   Change ToolbarFloatingX[X] to 200
   Change ToolbarFloatingY[X] to 200
5. Open up RoboHelp. The toolbar's new position will be determined by the modified registry values. You should see that at about 200 left, 200 top, the missing toolbars are found! Move them around, dock them. Ensure you can see them.
6. Close RoboHelp. This will save the registry values and the problem should be fixed.

Two posters found their webhelp worked fine everywhere except on the server when the TOC failed to load.

Jonathan Woodward reported, "We finally tracked it down to the security settings on the webserver where the application and OLH files resided. The webserver was blocking use of .xml, .js, and a few other important file types, thus causing the TOC to not load properly when accessed from the application."

Jennifer Foster reported, "The problem was that IIS 6 doesn't serve unregistered MIME types. For some reason, .js was not registered in IIS. To fix this, I just allowed all unregistered MIME types but doing an * as the extension and putting them as application/octet-stream. A better solution, though, would probably be to just register the .js file extension."

Various reports have appeared on the RoboHelp for Word forum of a list of fonts being displayed before the topic heading when generating CHM help. This is thought to result from the patch referred to in Snippet 51 which relates to winhelp. However, we cannot be certain.

Minchou reported "I found a kludge that solves my problem in the short term: Insert a manual page break before the first topic in the document."

Simple but effective!

This crops up occasionally and I have never got to the bottom of it. Some say it is because one of the files or folders has become marked Read Only but when I checked my target, that was not the case.

Fortunately fixing the problem is usually straightforward. The quickest way is to rename the target folder and publish again using the original name, or publish to a new target folder with a different name. After that you can trash the original and rename the new folder.

HTML editors do not have the ability to convert text to a table in the same way as Microsoft Word. Andy R came up with a neat solution though.

***

You can use a program such as Textpad (or any text editor) to perform a search and replace of the tab (or other delimiter) character with </td><td>

Search and replace the line break character "/n" with "</td></tr>/n<tr><td>"

Then all you need to do is wrap the table with <table> tags and a little cleaning up.

Sara Writer posted:

In my earlier project I produced several different chm files which all behaved the same when searching from the Search tab. When searching for say 'beam' it also found 'beams' and 'beaming'. Now I have two new projects and they will only perform a simple search; i.e. 'beam' will only find 'beam' and 'beams' will only find 'beams'.

Pete Lees responded with this:

You may need to check the language setting for each help file as only US English files support "stemmed" searches of the type that you described.

As I understand it, you can't set the language of an HTML Help file from within RoboHelp. Instead, you must open the project (.hhp) file in Notepad or HTML Help Workshop and add a line like this to the [OPTIONS] section:

Language=0x409 English (United States)

Hot on the heels of Snippet 51 which covers a Word 2003 problem with Microsoft Patch KB 917334, a problem has been found with Microsoft Patch KB917335 which is the equivalent patch for Word 2002 (Word XP).

What happens here is that topic titles get random prefixes such as placeCity, State and stockticker. They appear to be removed when changed manually but reopen the project and they are still there. You may also get a report of an unregistered routine followed by an option to let RoboHelp make the necessary updates. It is thought the best policy here may be to answer No.

As yet there is no solution apart from the obvious one of upgrading to Word 2003 where the problem has been fixed. Meantime here are some solutions posted for this issue and some that were for the wrong font issue but may also work for this one.

Solution 1

Karen R reported in the RoboHelp forum on Adobe's site:

In Word, navigate to the following: Tools | Auto Correct Options | Smart Tags - uncheck the Smart tag lists Recognizers box, then click the Remove Smart Tags button. This resolved the problem for my projects. I hope this helps you! I'm now trying to research the "PlaceName" and "Place Type" issue.

PegBrad reported that Karen's solution solved the whole problem for her.

Solution 2

You could uninstall KB917334 and turn off Automatic Updates to prevent if being applied again. I cannot advise you to turn off Automatic Updates. That is a decision for you to make in conjunction with your IT department where applicable. Also bear in mind that one person reported that uninstalling KB917334 (the Word 2003 equivalent patch) causes problems with the desktop.

Solution 3

The patch installs a new version of winword.exe and uninstalling the patch reinstalls the old version that did not have this issue. So the trick is:

1. Uninstall the patch.
2. Make a copy of Winword.exe and rename it (I suggest "Winword_original.exe") for future use. This is of course the version before the trouble started.
3. Reinstall the patch so that your security updates are correct and you do not get nagged to apply this patch.
4. Make a copy of Winword.exe and rename it (I suggest "Winword_update.exe") for future use. Leave all three Winword files in the "C:\Program Files\Microsoft Office\Office11" directory for easy access.
5. Two options now:

• For those who are not bothered by the security risks: Delete Winword.exe, make a copy of "Winword_Original.exe", and rename it to "Winword.exe". This will mean that everything you do in Word will be based on the old version so you are vulnerable to the risks that the patch removes.
• For those who need the security updates: Delete Winword.exe, make a copy of "Winword_Original.exe", and rename it to "Winword.exe" whenever you want to work with RoboHelp. After working with RoboHelp, delete Winword.exe, make a copy of "Winword_Update.exe", and rename it to "Winword.exe". This places the security update version back in service so you are not at risk while doing other work. You will know which one is being used by comparing the File Sizes and Date Modified since they are different.

Let me emphasise that you must ONLY adopt this approach with the agreement of your line management and IT Support. I cannot say whether there will be other side effects, only that it has worked OK for Steve Harley. This solution, like all the others, is entirely at your risk.

KB923094
The findings of MS Caroline referred to above suggest that as Steve Harley had predicted, future patches will contain the same fix as was in KB917334/5 and reintroduce the problem. If that is the case, then Steve's solution of sticking with an old version of Winword will be the solution but it's one many system administrators will not like given that it removes the security the patch is designed to give. In Steve's case, his company took the view that he is one of a small number of users who would need to work this way and subject to Steve and his co-authors being sensible about what documents they opened, the company was willing to accept that risk. You need to check with your IT guys whether or not they share that view.

From June 2006, posts started to appear reporting that RoboHelp for Word was suffering from the installation of Microsoft Patch KB917334 which is for Word 2003. When generating winhelp, instead of text appearing in Arial, it was displayed in Times New Roman.

There was a lengthy Snippet here with many suggested workarounds but I am very pleased to now be able to report that Adobe have released a patch.

I am pleased to report this, both because it fixes the problem and because it is the first patch we have seen in a long time. It evidences Adobe's commitment to this product.

Click here for the patch.

Please note that this patch is for Version X5 only. The fix is built into later versions.

A couple of people found the patch did not work and here are their solutions.

David Hurlston
Word sets the Heading styles to be based on Normal. We found that removing that link worked for David on his PC. Same project on my PC, the patch worked.

ImCarol
Great News is that I found a really weird work around. I change all the Verdana to MS Mincho, save to rtf, change to Verdana again. The *.hlp is perfect!!! PS, in all the fonts I tried, MS Mincho is the only one works.

If you want to have unordered lists with various levels of indent with different bullets for each level, this is what you do. I recommend trying it in a fresh topic and preferably a test project.

First amend your style sheet so that your UL definition includes the bullet you want for the first level, for example:

UL {
font-size:10pt;
margin-top:0pt;
margin-bottom:0pt;
font-family:Verdana, sans-serif;
list-style: disc }

Now copy and paste that, then add a second UL. Change the style to what you want for the second level.
UL UL {
font-size:10pt;
margin-top:0pt;
margin-bottom:0pt;
font-family:Verdana, sans-serif;
list-style: circle }

Now copy and paste that, then add a third UL. Change the style to what you want for the third level.
UL UL UL{
font-size:10pt;
/*margin-left:0.25in; */
margin-top:0pt;
margin-bottom:0pt;
font-family:Verdana, sans-serif;
list-style: square }

Now create a list using RoboHelp's bullet icon with three lines with the text List Item.

Place the cursor in the second item and click the indent icon once.

Place the cursor in the third item and click the indent icon twice.

The code will look like this. (I have removed the indenting and blank lines to save space.)

<ul style="list-style: disc;" type=disc>
<li class=kadov-p><p>List item</p></li>
<ul style="list-style: disc;" type=disc>
<li class=kadov-p><p>List item</p></li>
<ul style="list-style: disc;" type=disc>
<li class=kadov-p><p>List item</p></li>
</ul>
</ul>
</ul>

Remove the style definition in the tags so that the code looks like this:

<ul>
<li class=kadov-p><p>List item</p></li>
<ul>
<li class=kadov-p><p>List item</p></li>
<ul>
<li class=kadov-p><p>List item</p></li>
</ul>
</ul>
</ul>

In RoboHelp's WYSIWYG viewer there will be no change but in Preview and the generated output, you will get the different bullets.

If your bullet points are within numbered points, then you may find style="list-style: disc;" type=disc is written within the <li> tag but you remove it from there in the same way.

You can also use this method to define different numbering styles such as 1 followed by a followed by i. Just amend your style sheet in the same way using OL, OL OL and OL OL OL.

Leon advised in one post:

You might find RH being too helpful so that when you decide to nest a list, RH says to itself: "My master wants to end this list and start another, so I'll end it for him. He'll be soooooo happy!

So, you get these extra tags (shown in bold):
<OL> <LI> <LI> </OL> <OL> <LI> <LI> <LI> </OL> <OL> <LI> <LI> <LI> </OL>

instead of this truly nested list whose outer list will resume numbering from when it was interrupted, not ended:
<OL> <LI> <LI> <OL> <LI> <LI> <LI> </OL> <LI> <LI> <LI> </OL>

IF
- Your TOC is set to auto synchronise
- A book in your TOC has a long list of topics
- A user clicks a link to a topic that is well down the list
- Their browser is IE
THEN
The topic will be highlighted in the TOC but the TOC entry will not be displayed. The user will see the book and as many topics as can be shown below that but the highlighted topic will be further down and they will need to scroll to see it. The problem does not arise with Firefox.

Ajay Kumar posted this solution

Go to the output folder and open "whthost.js".
In that remove or comment out the line
"document.body.scrollTop=nNewScroll;"
It will be some around line 734.
To comment out a line, prefix it with two forward slashes.

The solution works just fine in IE but the downside is that it breaks things in Firefox! With the line removed or commented out, in Firefox the highlighting is removed from the previously highlighted topic but it does not move to the correct topic.

So it's a great solution if you know your users are IE only but you may be better off leaving things untouched if you have no control over the browser used or know it will be Firefox.

The good news is the problem is fixed in IE7.

If you are having problems getting your TOC to synchronise generally, take a look at Snippet 1.

In connection with topic reviews, the question was posed as to whether hidden text could be inserted into HTML other than via the comments tag.

Quite simply you add style="display: none;" to a tag so that it appears something like the html below:

<p style="display: none;">Hello World</p>

OR

<p>This is some <span style="display: none;">red</span>text.</p>

The text will not be seen nor will there be an empty line or space.

To reveal the text you would have to do a global find and replace changing the style to something visible that you do not use anywhere else. You would search on

style="display: none;"

and replace it with something like

style="color: red"

All the hidden text would be revealed and display red.

The replace needs to be unique so that you can do a reverse find and replace.

The html was suggested by Mike Feimster in connection with another use, namely getting words into a topic so that they would be found by a search even though they are not part of the topic text. Be aware that regardless of why you use this method, if style="display: none;" is in your generated help, the text will be caught by the search function.

Some might argue this will confuse users doing a search as the topic will be offered up but the user will not be able to find the word. That's true so it depends on who your users are and whether this is explained to them.

Rick Stone aka RoboWizard advises that the old eHelp Knowledge Base can be accessed by following this link. I understand it can be difficult to find what you are looking for but that it can be found.

Two problems typically arise.

The style sheet definitions are lost.

To avoid that problem you need a copy of the stylesheet in each folder. Make sure your topics point to the style sheet in the same folder as the topic and they will then print correctly when the user selects "Print all topics in book", even though the topics may be coming from different folders.

Download this RoboHelp project if you want to prove it works.

Table borders do not print correctly.

A fairly common problem is that table borders do not print correctly when printing a topic from a CHM file. In fact the problem only arises when you select the option to print all topics in a book, rather than just the displayed topic. The problem is that the Microsoft help viewer cannot deal with the way RoboHelp writes the code for tables. Why it can deal with it from a single topic and not multiple topics, I cannot tell you. The appearance of styles generally can get messed up when printing all topics in a book but that can be resolved. Unfortunately the method does not fix table borders.

The only thing that I found that worked was to create the topics in Dreamweaver or some other editor. However, that works only so long as the topic is not opened in the RoboHelp editor. As soon as it is, the problem is back, even if you do not touch the table.

The advice from Macromedia on this was between 75 and 100 topics and I am not aware of any changes made since Adobe took over that would change this.

Dan posted this link in response to a RoboHelp forum question. The answer will work in any HTML page. Also see Tables on this site where I describe the method in detail and another method.

This problem often crops up on the RoboHelp forum. It is covered in this topic and now includes a useful workaround advised by Dan Deming.

To quote Dave Mozealous at Macromedia, "this one is bizarre". The cause is not known and it is nothing to do with file associations in Windows Explorer. A file giving this problem on one machine will work fine on another.

Solutions that have worked are:

• Open a RoboHelp for Word project. Yes we know that has nothing to do with an XPJ file but it has fixed it for a number of people. The reason is not known.

• Uninstall X5, reinstall X4, uninstall X4 and reinstall X5. The reason is not known.

• Getting your IT people to give you a new profile. Bear in mind though that you will have to uninstall RoboHelp and then reinstall it using the new profile. Also you will lose your settings in the applications you use.

Finally two posters found the cause was having an application known as JMPS (Joint Mission Planning System) on the same PC as RoboHelp. Here's what one of them posted:

"I talked with a subcontractor who uses RoboHELP X3, about 3 years ago they had an intermittent problem where RoboHELP files were being corrupted. They tracked it down to JMPS wanting control over Microsoft Word for Report Generation and RoboHELP wanted control over Word to produce RTF files. Again the problem was only intermittent. They moved help generation to a non-JMPS machine to avoid the problem entirely."

Do you want to highlight table rows as the cursor moves over the rows as in the table below?

Note that this will only work in Internet Explorer or a compiled CHM file.

When a table is created, the code for each row will be

<tr valign=top>

Amend it to

<tr onMouseOver="this.bgColor='rgb(210, 220, 240)'"

onMouseOut="this.bgColor='rgb(255, 255, 255)'"

valign=top>

Change the first RGB value to the colour you want for the highlighting.

Change the second RGB value to the colour of your background.

That's it. You will only see the highlighting in preview or the compiled help, not in RoboHelp's WYSIWYG editor.

Click here to find out how to create an email with a link to a topic.

See Snippet 114 if you just want to copy a topic's title and URL to the clipboard.

This error can occur when the regional default setting on the computer is not English. See this topic on Macromedia's site for the solution.

If you get this error, here's what Jolantru posted to the forum.

"After two days of jumping thru hoops, about 10 phone calls and going to 3rd level support, MM FINALLY found a solution. Seems the Robo suite of apps (this problem does not occur with MM-grown s/w like AUthorware) are susceptible to anti-spyware. My company runs WebRoot, and THAT was preventing the installer from running correctly. My system administrator had to go to the server and uninstall this s/w (apparently you can't do it from your PC), then we re-ran the installer and RoboOffice X5 worked just fine. BTW, I tried another Robo app (RoboInfo) and got the SAME error - but NOT with Authorware. MS Anti-spyware doesn't seem to have the same effect that WebRoot does."

How to change the colour of the dropdown and expanding text hotspots, as well as the text itself, is explained in this downloadable project.

Use Winzip's extract tool to retain the structure and then go to the !SSL! folder and open the two chm files you will find. These show the same topic but with different colours because of differences in the style sheet..

The RoboHelp project is supplied so that you can experiment with your own changes.

Ignore the topic on hyperlinks. That is incomplete at the moment.

It was suggested in a RoboHelp forum posting that printed documentation is outdated and that only online help is required. Here's my response.

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

The correct media depends partly on the content and partly on the users. Has anyone asked your users rather than being prescriptive?

On content, if all the topics are short and easily digested, then online help only can be considered. If they are longer topics, and particularly if the content is complex, then it can be difficult to digest properly on screen. You can argue that any topic can be printed but sometimes you have users who want to improve their product knowledge and that is more easily done by scanning a printed manual and homing in on relevant stuff.

On users, there will always be people who prefer to work from the printed media. For a start they can annotate it. Don't make the mistake that these are older people. I find many younger people prefer this media, again with complex subject matter.

Nonetheless, you could avoid the cost of sending the document to a print-house. What we do is PDF it and ship the PDF as well as the online help. For users who want the online help, they still have it. For users and situations where printed media is preferred, they can print the PDF version in its entirety or in part. You avoid the cost but the customer can still have their printed version.

I think the key is to let the user decide. Horses for courses.

When I rebuilt my machine with Windows XP SP2 I kept getting an error message. The problem was that it could not find the file empty.htm in the path below. Note that empty.pdf is a folder name!

C:\Documents and Settings\User Name\Application Data\1-Step RoboPDF\empty.pdf

Thus the full path required was

C:\Documents and Settings\User Name\Application Data\1-Step RoboPDF\empty.pdf\empty.htm.

What I found existed was

C:\Documents and Settings\User Name\Application Data\1-Step RoboPDF\empty.htm

where empty.htm was a file.

Rick had seen this reported on the RoboPDF forum and advised that what you have to do is create the folder empty.pdf off of the 1-Step RoboPDF folder, then move any files in 1-Step RoboPDF into the new folder.

Using 8.3 format for a folder name is not the smartest piece of naming I have seen and you will probably need to reread this topic. Trust me, the path below where empty.pdf is a folder and empty.htm is a file does correct the problem.

C:\Documents and Settings\User Name\Application Data\1-Step RoboPDF\empty.pdf\empty.htm

I cannot really tell you what you will see as that will depend on the browser you are using, the version of that browser and the patches that have been installed. Typically you will be given the opportunity to Open the file or Save it. In reality, if you select Open, the file still has to download but it is then opened from a temporary directory. Some browsers will force you to save the file first.

In IE8, you will be offered the option of opening the file or saving it. Firefox used to force you to save the file but testing it in Firefox 3.5.3 it just opens a page of garbage on the server I use.

Click here to find out.

Either way, it is time consuming and the Security Warning message that will be displayed if you elect to open the help can be intimidating for some users.

Unless you can contemplate making registry changes which compromise security, a chm file is now effectively limited to being run from the user's hard disk. For anything else you need webhelp.

RH allows you to add a tooltip over images by filling in the Screen Tip field in the insert images dialog. Perhaps you want to add a tooltip somewhere else, maybe over a paragraph? Hold your mouse over this paragraph. It's as simple as the html below.

<P><acronym title="Your tooltip">Your paragraph of text.</acronym></p>

If you want something more sophisticated, Leon Descoteaux recommended Walter Zorn's really neat solution.

Adobe RoboHelp 7 introduced the option of not having an About logo in the output. Prior to that it was a manual process. Rick Stone's Skinny on Skins is THE authority on this subject with various options for removing the logo, changing the logo to your own, editing the text it displays if clicked and removing the RoboHelp credit. Each of the methods is project specific so you can vary each project as required.

James Lockard never uses a logo, the RoboHelp one or his own company's so he wanted something where the logo did not even appear in a new project. Here are his instructions.

1. Locate your webhelp "template_skin" directory. Mine was at C:\Program Files\RoboHelp Office\RoboHTML\WebHelp5Ext\template_skin.

2. Find the whtbar.js file and make a backup copy somewhere.

3. Open whtbar.js with Notepad.

4. Find the code block in the addButton function (not addBanner) that starts with
   else if(sType=="banner")
   This appears at the end of the addButton function and just before the isShowHideEnable function on my system.

5. Comment out the line in that block that reads
   addBanner(sI1);
   To comment out the line just type
   //
   at the start of the line. This prevents the addBanner function from running, but leaves everything else intact.

6. If you've got RoboHelp running you'll need to exit and restart the program for the changes to take effect.

It doesn't remove the logo from existing projects but you'll never see it in a new one unless you reverse the procedure.

Many authors have experienced problems getting their links to appear as defined in their style sheet. Thanks to Leon Descoteaux for posting this useful snippet.

Make sure that the links are arranged in the following order inside your style sheet, including any link classes you might be using, such as plain and fancy:

A:link

A:visited

A.plain:link

A.plain:visited

A.plain:hover

A.fancy:link

A.fancy:visited

A.fancy:hover

A frequent problem for authors is that they have a version of Word which is later than their version of RoboHelp will support. Typically an IT department will roll out Word 2003 to the whole company but the technical author's version of RoboHelp does not support it.

When X5 was introduced, it was not compatible with Word 2003. That only came when Service Pack 1 was rolled out. Prior to that, eHelp indicated the solution was to install Word 2002 (XP) or earlier as well as Word 2003. This would also work for users of X3 and X4 which is only compatible with Word 2002 or earlier. Subsequently the solution was pulled and I had some doubts about it based on a bad experience with a dual install of Word. I must add that Microsoft also caution against a dual install.

Sandra has reported that the whole trick is the order in which the products are installed and it is not what you would expect. Normally you install earlier versions first and then the later ones. The trick here is to install Word 2003 first, then Word 2002 or your earlier version and finally RoboHelp.

Sandra has also reported that she has not had any problems with Word as a result.

You do of course need to make sure your licences cover both versions of Word.

This is a different method to the one here before 21 Aug 2007. It does not require the user to click in the topic frame before printing.

Go to Skin editor and click the + sign to add a new button.

In the Text tab enter Print as the Item Name and complete the Text and Image options as required.

Now click the Action tab.

In the Action frame go to the OnClick field and enter

printAction()

In the JavaScript frame click the Inline JavaScript option and then the edit button.

In the window that opens enter

var printAction = function()
{
var topicPane = top.frames[1].frames[1];
topicPane.focus();
topicPane.print();
}

OK your way back out and generate the help. Don't forget to tick the Print button in the second page of the wizard.

The nice bit about this script is that the user does not have to click the topic frame before printing.

Update 12 Nov 2009 - Print with dropdown text

Thanks to Chrodgers for posting this variation so that any dropdown text is also printed.

var printAction = function()
{
var topicPane = top.frames[1].frames[1];
topicPane.focus();
var arrayofDivs = parent.frames[1].bsscright.document.getElementsByTagName('div');
for (x=0;x<arrayofDivs.length;x++)
{ arrayofDivs[x].style.display = 'block'; };
topicPane.print();
}

ChinoSotto was unable to import a Word document into his project, Word just kept hanging. The solution turned out to be very simple. Click here for the Macromedia technote.

Update 05/05/07: I have found the link is pointing to a page that no longer exists. A search on Adobe's site using "hangs on import" gives a list of topics and the required one is the first in the list. Trouble is that clicking that link also report the page does not exist. Quite how the search finds it then is interesting and I have asked Adobe to investigate.

From time to time people ask how to open a Word document from the help.

COMPILED CHM HELP

Rick advises that you can use an HTML Help Shortcut control to accomplish the goal. You simply specify the file name where you would normally specify the application.

WEBHELP

There is a way of forcing a Word document to open in Word rather than Internet Explorer but HEED THIS WARNING.

It requires changes to each users PC and many systems administrators will not permit those changes for very sound reasons. You may be placing documents on an intranet and know they are safe. However, the changes will affect ANY link to a Word document. If one of your users finds a Word document on another site and clicks the link, it could introduce all sorts of nasties onto your corporate network. There are many websites to help you find a new job!

Still determined? OK. On each users PC you need to go to Windows Explorer | Tools | Folder Options | File Types. Locate the DOC extension and click on Advanced. Clear the Confirm Open after Download check box. Next time you click the link, the document will open in Word. Depending on the location of the document and permissions, it may not be possible to use Save to save changes but the user can click Save As and save it locally.

Any Gotchas? Yes. If Internet Explorer is not your browser, some browsers will not let you open a Word document at any price.

The link below is to a Word document. Fancy clicking it to test those settings changes? Do back up all your RoboHelp projects first as it has a macro to delete them all. OK I would not do that and the document is safe but I suspect the point has been made. If you want to test how a document opens on your PC, it is OK to click the link below.

Click to open a Word document

Word has a skip numbering feature which used to be part of RoboHelp but somewhere along the line it was helpfully removed! For some users, creating an unnumbered (or unbulleted) list paragraph can be as simple as inserting a line break using Shift + Enter. However, your style sheet definitions may result in the different spacing between paragraphs created using that method and paragraphs with a number or bullet applied. See below and note that while the number is skipped, the spacing is wrong. A second line would also be wrong.

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

1. First item.
   Another paragraph part of first item.

2. Line created using Enter.

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

Matt Zim found a neat way around that. He applies the number or bullet to the first paragraph and then lets RoboHelp apply numbering or bullets to every paragraph until he has finished editing.

Thus he would create his list as

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

1. First item.

2. Another paragraph part of first item.

3. Second item.

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

In true code those three lines will appear as

<li><p>First item.</p></li>

<li><p>Another paragraph part of first item.</p></li>

<li><p>Second item.</p></li>

Note how each paragraph is surrounded by <li> tags. Matt simply removes the <li> tags from the paragraphs he does not want numbered. The indentation remains correct and the numbering adjusts itself. I have removed those tags in the example and this is what you get. Perfect.

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

1. First item.

Another paragraph part of first item.

2. Second item.

Whenever you create a new project, you just get the standard colours when you click Format | Colors.

In RoboHelp X5, the colours are defined in the file rhcolor.apj. Once you have the colours you want in one project, you can copy that file to other projects.

You might want to keep variants like rhcolor01.apj, rhcolor02.apj etc. Just rename the one you want and copy it into a project.

You can also edit the file. Open it in a text editor and create a new section. It will be obvious what you need to do.

If webhelp is installed onto a local machine rather than accessed via a server, then the Internet Explorer security settings may prevent the help from being accessed.

Click here to access the Adobe topic on the subject. That topic also has a link to the Microsoft topic on the IE information bar introduced in SP2.

In short, either the user must allow the content each time the webhelp is accessed or they must lower their security settings, which needless to say Microsoft do not recommend. (In IE, Tools | Options | Advanced | Security | Tick "Allow active content to run in files on My Computer".)

This is only an issue with locally installed help, not server based help. It is understood from feedback that terminal servers and Citrix may treat webhelp as if it were installed locally.

Another workaround is to deliver the help as FlashHelp. Provided you have RoboHelp X5 Service Pack 2 installed, that allows FlashHelp to run locally without this problem. Note the following:

• End users will need Macromedia Flash Player 6.0 or higher installed.

• You cannot edit FlashHelp skins.

• You can still remove the Powered By logo as described in Rick Stone's Skinny on Skins.

Thanks to Susan Neal for advising me of the FlashHelp workaround and to Rick Stone for his input on it and indeed on this issue generally.

Roy reported that no matter what topic he double clicked, Word kept going to one topic. Solution? Turn off the Styles and Formatting toolbar in Word. Obvious really! No, I don't understand why either but try it.

1. Click Tools | Options | Tool Locations tab

2. Click an existing extension, this will populate the Program for Editing and Program for Viewing fields with the application for that file type.

3. In the field below the listed extensions, type over the whatever is shown with the file type to be added, precede it with a full stop / period (for example .CSS).

4. Click the Add button.

5. Leave the Program for Editing and Program for Viewing fields unchanged if they are displaying the required editor for the new file type, otherwise navigate to the editor / viewer to be used.

6. Click OK.

7. Add the file to be edited to baggage.

8. Right click the file in the baggage folder and choose Edit from the context menu or double click the file. The file will open in the required application.

You can drag a help topic from RH Explorer to the topic that is going to reference it.

Drag the topic from RH Explorer and release the mouse button where you want the topic to be referenced. The link will created using the Topic Title.

If you don't want to use the topic title, type in the text you want and highlight it. Now drag the topic to the text you typed. When the mouse is over is over the text it will be highlighted in red. Release the mouse button and that text will now be a hyperlink.

The link created either way will open the topic in a new page. You can double click the link though to change the properties to make it a popup.

If you create a link to an external topic, RoboHelp displays a dialog box to warn you. There is a check box giving you the option of not displaying the warning again. Trouble is, if you tick that, there is no way that you can reinstate it via RoboHelp.

Thanks go to Rick Stone who discovered that when you tick that check box, RoboHelp creates the registry key below. So if you are comfortable with editing the registry and have taken all the usual precautions, just delete the key.

HKEY_CURRENT_USER\Software\eHelp\RoboHTML\13.00\Common\DontShowFileLinkWarnin

(No, I have not misspelled "Warning". RoboHelp did that!)

If you don't want to edit the registry, uninstall RoboHelp and reinstall it!

For Vista users I am told the key is in HKEY_CURRENT_USER/Software/Adobe/RoboHTML/7.00/Common and is something like "Dont show outside project"

It's true!

www.history.navy.mil/photos/images/h96000/h96566kc.htm

A frequent problem on the forums is getting Word to indent bullet point and numbered lists the way you want. So here's how it works. You may also find the topic on Printed Output of help.

If your numbering in RH is applied using ONLY

• The normal style or a style that has no indent built into it.

• The numbering icon.

• The indent icon, if required.

then in Word you will get much the same indentation.

Three solutions starting with the easiest that will address some of the problems that occur and / or give you different indentation in Word.

AMEND THE STYLE SHEET

Amend your css just before you create the printed documentation. Set OL and UL to the margin.left that you want in Word. Things will look wrong in RH's WYSIWYG editor but ignore that. Create the printed documentation and you will have the margin you want in Word. You might need a couple of attempts to get it right but the idea does work. When you have finished, set the css back to the original margin.left setting.

USE WORD'S "SELECT TEXT WITH SIMILAR FORMATTING"

This method only applies to Office XP and 2003 users. Note that you will get different results according to what you select under Microsoft Word Templates on the last page of the wizard. You may need a couple of attempts to get what you want.

Create the document and then, right click in one of the list items and click Select Text with Similar Formatting. Manually change the indent any way you like, such as using the move right and left icons. All the items selected will now be where you want them.

I found that:

• With the Style Mapping template, using Select Text with Similar Formatting selected both bullet point lists and numbered lists.

• Selecting Use CSS Styles in RH meant that when using Select Text with Similar Formatting in Word, only the bullet point lists or the numbered lists were selected according to which you had right clicked in.

USE WORD'S FIND AND REPLACE TO CHANGE THE STYLE.

I think this one is a bit clunky but you may need it to give you exactly what you want if the previous two will not give you what you want.

Create a style in your CSS that you will use for bullet point and / or numbered lists. Do not set it up with any numbering though. Now do the same in the Word template that you will use, I will call this Style A. Next create a second style in Word that is identical to the first one, I will call this Style B. Again, no numbering in either.

Whenever you create any list in RH, use that style and then click either the bullet or numbering icon.

When you generate the printed document map the CSS style to Style A in the Word template.

In Word, the formatting will be as it was in RH and not how you want it in Word. Use Word's Find and Replace Tool to find all instances of Style A with Style B. In converting the styles, Word will ignore the manual settings that RH forced and you have what you want.

The font for the toolbar and the navigation pane can be changed by using the skin editor. Changing the font for the navigation pane changes it for the TOC, the Index, the Search and the Glossary tabs. If you want a bit more control then you need to edit some files in the generated or published output, whichever you use:

TOC = edit the font setting in whtdhtml.htm - this affects the items listed in your toc.

Index = edit the font setting in whiform.htm - this affects the text at the top of the pane

Type in the keyword to find:

It does not affect the entries displayed. They remain controlled by the skin setting.

Search = edit the font setting in whfform.htm - this affects the text at the top of the pane

Type in the word(s) to search for:

It does not affect the entries displayed. They remain controlled by the skin setting.

Glossary = edit the font setting in whgdhtml.htm - this affects the text at the top of the pane and the top of the results panel

Term:
Definition:

It does not affect the entries displayed. They remain controlled by the skin setting.

For More Information

There's a lot more information about changing fonts in Rick Stone's Skinny on Skins. That also covers how to change the fonts for the Index, Search and Glossary results. Visit www.robowizard.com.

Choose the tagged element that will go to the top of the next page, and insert the following:

STYLE="page-break-before:always"

That is, add it within any tag (p, H1, H2, etc.). For example:

<H1 STYLE="page-break-before:always">Main Tab</H1>

or:

<p STYLE="page-break-before:always">Some text.</p>

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

Leon posted this on the forum but acknowledges the work of John-Pierre Cornilissen in finding the information on the www.w3.org site.

I would just like to add to Leon's excellent snippet...

1. For those of you whose output is used internationally, make sure it works for both US Letter size and A4 or you might do more harm than good.

2. In RH's WYSIWYG editor you will see this symbol where the page break will be.
   

The content of this Snippet has been incorporated into Opening Projects which explains how to trash the CPD file safely.

Various file types will be blocked by Outlook. Of particular interest to technical authors will be chm and hlp files. Microsoft's web site is the first place to look for solutions as they are working towards giving some control over what can be received. What you can do will depend on your version and how up to date you are with Service Packs.

If you cannot find a solution there, other options include:

• Get the sender to put the file in a zip file and send it again.
• Get the sender to change the file extension and send it again. For example, get them to send help.chm as help.txt, then you name it back to help.chm.
• Install an add-on from Slovak Technical Services

Go to www.slovaktech.com/attachmentoptions.htm and note the versions the download works with. If it matches your version, consider downloading and installing this Outlook add-on. After installing, go to Outlook | Tools | Options and there will be an additional tab allowing you to reduce the security level for certain file types.
If you are on a network, make sure you get approval first. In any case, I make no warranty about the effects of this program. Remember, it allows any file through of the type you select, not just one that you are expecting. For what it is worth, I have installed it and had no problems so far.

Click this link to see how to add an icon allowing users to print the page they are viewing. The topic is about adding Show / Hide buttons for dropdown text but there is a section covering a print button. Note there is one script for webhelp and one for chm help.

See also Snippet 24.

To create an email with the To, cc, bcc, subject and body completed, paste the text below into the True Code view.

<p><a href="
mailto:person1@abc.com;person2@abc.com
&amp;cc=person3@abc.com
&amp;bcc=person4@abc.com
&amp;subject=Hello There
&amp;body=Type your message here.
">Mail To Example</a></p>

Delete any line you don't want. For example if you do not want the body pre-completed, delete the line

&amp;body=Type your message here.

I have added line breaks to make it easier to understand the content. After pasting the html into RH and deleting any unwanted lines, place the cursor at the end of each line and press the delete key once. The only spaces should be the one between "a" and "href" at the beginning and any that appear in the subject or body fields.

Click this link to see it work - Mail To Example

Various javascripts are available to provide users with a search function that is limited to the current page. For example:

http://javascript.internet.com/messages/find-in-page.html

In X5, in addition to the usual way of adding baggage files, you can edit the rhbag.apj file. With the project closed, open the file in a text editor such as Notepad and copy / paste an existing section. Replace the name of the baggage file with the new one.

When adding javascript files to topics, RH should automatically add them to baggage. Often it does not. To avoid having to edit the rhbag.apj file in such cases, I add the js file to baggage manually before inserting the reference. In the long run, it's easier.

To make the TOC synchronise you need to select "Automatically" against Synchronize TOC in the webhelp wizard or tick "Always Show Selection" in the chm wizard (click the Advance button and look on the TOC Styles tab). If you have done that, then perhaps something in the following will help.

I quote below Christophe Roos' posting on the subject.

It seems lots have problems with the synchronisation of their TOC's in merged projects. So did I and there seemed to be no reason for it. Well, here's the solution. Projects composed of one word do synchronize, projects composed of several words don't. Use no spaces in the name of the projects, use underscores if necessary and the synchronisation will be OK.

Update 05 Jan 2005

Finally, one person found problems with topics containing an apostrophe or a hyphen in the title. However, it did not affect the synchronisation of all such topics! Nonetheless, worth a try if all else has failed.

Update 28 Apr 2005

Rick Stone has also pointed out that Optimising Speed in the generate and publish wizard can help. Try choosing the Local PC or Intranet option.

Update 13 August 2005

Merged webhelp will synchronise except on calling the first topic. See Step_8 of Merging Webhelp to fix that problem.

Update 21 October 2006

If the problem is that the TOC does synchronise but the highlighted topic is off screen, see Snippet 49.