Dr.Explain: Help Authoring Software (CHM,RTF,HTML)
   Home Features Order Download Samples Demo Screenshots User reviews Help Resell Press Kit Versions Blog Contact
 

Articles : Error Accessing and Displaying CHM Files

Error Accessing and Displaying CHM Files: Reasons and Solutions

By Dennis Crane

So, you've got in trouble. Some or even all of your CHM files seem to have gotten corrupted. They show a "The page cannot be displayed" error in the left-hand pane of the CHM viewer. There are several possible reasons why your CHM e-books and documentation files are unreadable.

The CHM viewer component is not properly registered on your PC
The system file <WINDOWS>\system32\hhctrl.ocx may get missing, corrupted, or unregistered.

Solution: Run "regsvr32 hhctrl.ocx" command from the command line to register the library in the system.


Your CHM files are stored in the folder with '#' (hash) character in the path
Many C# developers discovered that their documentation and e-books in CHM format cannot be read because they were storing their CHM files in the directories like 'C:\E-books\C#\'
The hash character signifies an anchor in HTML so the CHM viewer fails to resolve the path properly and to retrieve the content.

Solution: Remove the '#' (hash) character from the directory name. Also avoid using '?', '&', and '+' characters in directory names.



A security update for Windows XP® may block access to CHM files
Windows XP® security update blocks active content in CHM files to protect your system security. Additional information is available here.

Solution: Run Windows Explorer, right-click on the CHM file, and select Properties from the popup menu. Click on the Unblock button immediately below the Advanced button on the General page. Click Apply to show the content. Once the CHM file has been unblocked, the Unblock button disappears.


The CHM file is in the restricted Internet zone
When a CHM file that you are trying to access is stored remotely, e.g. on the network drive or on a remote server, you may also get in trouble. If the associated security zone is restricted, then CHM files won't be displayed as well.

Solution: Modify the ItssRestrictions registry entry to enable a specific security zone.
Follow these steps:
1. Run 'regedit' command from the command line.
2. Locate and then click the following subkey:
HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\HTMLHelp\1.x\ItssRestrictions
Note: If this registry subkey does not exist, then create it.
3. Right-click the ItssRestrictions subkey, point to New, and then click DWORD Value.
4. Type MaxAllowedZone, and then press ENTER.
5. Right-click the MaxAllowedZone value, and then click Modify.
6. In the Value data box, type a number from 0 and 4, and then click OK.
The values settings are
0 = My Computer
1 = Local Intranet Zone
2 = Trusted sites Zone
3 = Internet Zone
4 = Restricted Sites Zone

For most CHM files, the value of 1 should be enough to allow use without opening up access from/to remote CHM files in email/internet locations.

7. Quit Registry Editor.

Warning Enable only those security zones that you trust. Do not enable security zones about which you are not sure.

Dennis Crane, the author of Dr. Explain software, specializes in vertical markets software development. He is online at http://www.drexplain.com

Article Source: http://drexplain.com

You are permitted to reprint this text as long as it includes copyright notice and link to our web site.
What's new
Software Help Authoring Tools news April 04, 2008
Dr.Explain v.3.0.176, the maintenance update was released.

Software Help Authoring Tools news February 26, 2008
Dr.Explain v.3.0 was released. More ...

Software Help Authoring Tools news February 3, 2008
Dr.Explain 3.0 Beta is ready for public testing.

Software Help Authoring Tools news July 19, 2007
Paul Hughes features Dr.Explain 2.6 in CNet Download Dispatch Newsletter

Software Help Authoring Tools news July 11, 2007
Dr.Explain v.2.6 was released. More ...

Software Help Authoring Tools news July 2, 2007
Chaim Krause reviews Dr.Explain on DonationCoder.com

Software Help Authoring Tool news June 18, 2007
New publication: "White Papers: Writing Cost-Effective Documentation for Software Systems"

What your colleagues say
"Great product getting even better!"

Tom Bodine, Bodine Training Games LLC

help authoring help authoring tools software help authoring

"Very nice job! Great example of meeting an unmet need that has been around for years."

Bob Walsh, The author of "Micro-ISV: From Vision to Reality" book

help authoring tool help authoring software help authoring

"Also might I say, this is a great program that solves many needs for businesses today. Once we get our documentation done, I'm probably going to turn around and purchase the whole package for the company. Thanks again and Great Work!"

Robert Connely IV, Novo Innovations, Inc.

More testimonials

Get a free license for review!
Editors & bloggers who write about software development and software help authoring tools.

Claim your free review license here!
Software help authoring articles
Read and syndicate these articles:

White Papers: Writing Cost-Effective Documentation for Software Systems

Windows Software Help Files Formats

The Hidden Power of Online Manual

A Dozen Techniques to Improve Your Software Online Help

Error Accessing and Displaying CHM Files: Reasons and Solutions
   Home Features Order Download Samples Demo Screenshots User reviews Help Resell Press Kit Versions Blog Contact
Copyright © 2004 - 2008, Indigo Byte Systems. All rights reserved
Privacy Policy | Terms of Use