Help file does not display correctly

Frequently asked questions.
User avatar
jon
GPSoftware
Posts: 7412
Joined: 04 Nov 2004, 02:40
OS: Windows 10 64-bit
Opus: Latest Beta
Location: Melbourne
Contact:
This guide describes two different problems that you may see relating to the help file.

  • If pushing F1 does nothing at all, or you get an error message mentioning mk:@MSITSTore, it is probably because something has messed up the registry settings for some of the Windows Help components.

    To fix them,

    1. Open a command prompt as administrator. In Opus you can do this via Tools -> Command Prompt Here (Admin).

    2. Run the following two commands:

      regsvr32 %systemroot%\system32\hhctrl.ocx
      regsvr32 %systemroot%\system32\itss.dll

  • A few users have found that the Opus help file does not display correctly, instead showing the underlying raw HTML/XML code, or a blank window, or similar.

    wc919_dopus.png
    wc919_dopus.png (77.52 KiB) Viewed 4065 times


    This is caused by something breaking part of the .htm filetype in your system's registry. Microsoft's HTML Help components will go wrong if a particular registry value is set incorrectly.

    • Automatic fix:

      You can fix this by double-clicking the .reg file within this archive:

      HTML_fix_ContentType.zip
      (396 Bytes) Downloaded 465 times


    • Manual fix:

      Alternatively, if you would rather edit the registry by hand... (This assumes familiarity with RegEdit.exe.)

      • Go to HKEY_LOCAL_MACHINE\Software\Classes\.htm
      • Ensure there is a Content Type value with Type = REG_SZ (String), and Data = text/html

      • Go to HKEY_CURRENT_USER\Software\Classes\.htm
      • If there is no .htm key at that path, or there is one but it has no Content Type value, you are done and can stop.
      • Otherwise, ensure it is set to text/html as with the HKEY_LOCAL_MACHINE one.

    • Multiple Users:

      If your have multiple user accounts on your machine, you may need to apply the HKEY_CURRENT_USER part of the fix to each account separately.


    There is no need to reboot or restart Opus after applying the fix. The help documents should display correctly as soon as you open a new help window (F1). (Close any existing help windows first, of course.)

    wc920_dopus.png
    wc920_dopus.png (101.44 KiB) Viewed 4065 times

Return to “Directory Opus FAQs”