﻿<?xml version="1.0" encoding="UTF-8"?>
<?xml-stylesheet href="../xsl/aml_troubleshooting.xsl" type="text/xsl"?>
<!--Troubleshooting imported by HelpMarkup - (c) Help Information www.help-info.de-->
<troubleshooting xmlns="http://schemas.microsoft.com/maml/2004/10" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
  <title>HTMLHelp Troubleshooting</title>
  <problem>
    <symptom>If i have a #-sign in my path (e.g. D:\Code\#Latest\) I could only see the not-found-site from internet explorer in my chm-helpfile</symptom>
    <cause>The # is used to separate an url from an anchor so it's looking for an anchor named Latest in a topic named D:\Code.</cause>
    <solution>
      <para>To work around this issue, remove the # symbol from the file name or from the path to the file. Spaces have some bad side effects too.</para>
      <para>
        <navigationLink targetVerification="false">
          <linkText>Support Microsoft: No Text or Access Violation Error When Reading a Help File</linkText>
          <uri href="http://support.microsoft.com/?kbid=319247"></uri>
        </navigationLink>
      </para>
    </solution>
  </problem>
  <problem>
    <symptom>HTMLHelp Workshop decompiles not all files compiled to a CHM file.</symptom>
    <cause>Windows has a limit of 256 characters for file names (this includes the file path) and this may cause a problem when trying to create a file with very long name placed within folders with long names.</cause>
    <solution>
      <para>You may try to decompile the files in a folder placed in the root and with a very short name like C:\output for example.</para>
    </solution>
  </problem>
  <problem>
    <symptom>I cant't compile my HTMLHelp Workshop project, HH Workshop stops working and get following error messages:
             - HHC6000: Error: An internal file could not be created. Make certain there is enough disk space on the drive where you are compiling your file.
             - HHC5007: Error: Fatal navigational compilation error. This is likely the result of an invalid contents (.hhc) file.
    </symptom>
    <cause>You get these error messages if you choose the option to auto-generate the TOC without having &lt;hn&gt; tags in your HTML topic files.</cause>
    <solution>
      <para>1. Open your project (.hhp) file.</para>
      <para>2. Click Change Project Options, and then click the Files tab.</para>
      <para>3. Unselect the Automatically create contents file (.hhc) when compiling check box.</para>
    </solution>
  </problem>
  <problem>
    <symptom>After you install the Microsoft security update MS05-026 (KB896358), CHM help file topics may not display correctly if the file the help file was received via e-mail, or downloaded from the Internet. Instead, an error message such as ‘Action cancelled’ or ‘DNS error’ is displayed.</symptom>
    <cause>Recent Microsoft security updates include changes to the InfoTech protocol, which prevent CHM help files from being displayed correctly if the CHM help file is blocked by Windows Attachment Manager. Even if the security warning is acknowledged, the help file is not displayed correctly. The problem also arises when a blocked CHM help file is opened via the HtmlHelp API.</cause>
    <solution>
      <para>Unblock a blocked CHM Help File</para>
      <para>1. In Windows Explorer, right-click the blocked file, and then click Properties.</para>
      <para>2. In the General tab, click Unblock.</para>
      <para>Open a blocked CHM Help File</para>
      <para>1. Double-click the help file in Windows Explorer. </para>
      <para>2. If a security warning dialog appears, uncheck the box ‘Always ask before opening this file’. </para>
      <para>3. Click Open to open the help file. </para>
    </solution>
  </problem>
  <problem>
    <symptom>Microsoft HTML Help files may not display correctly if the file the help file is located on a network share, a mapped drive, a roaming user profile, or when the help file is otherwise accessed through a UNC path. Instead, an error message such as ‘Action cancelled’ or ‘DNS error’ is displayed.</symptom>
    <cause>Recent Microsoft security updates include changes to the Microsoft HTML Help viewer, which prevent CHM help files from being displayed correctly unless the CHM help file is located on the local hard drive of the client computer.</cause>
    <solution>
      <para>To work around this problem, you need to ensure that your CHM help files are installed to the local hard drive. If the CHM help files cannot reside on the local hard drive for technical reasons, you will have to make changes to the registry of the computers that will view the CHM help file. Details on the required registry changes can be found in the Microsoft Knowledgebase Article 896054.</para>
      <para>Warning   The following procedure shows how extent the security zone of HTML Help files to network shares (Local intranet zone). Extending the security zone for all help files may pose a security risk to your computer.</para>
      <para>Enable HTML Help for network shares</para>
      <para>1. Log in as an Administrator.</para>
      <para>2. Paste the following script into Notepad and save the file as 'HtmlHelpFix.reg'.</para>
      <para>REGEDIT4</para>
      <para>[HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\HTMLHelp\1.x\ItssRestrictions]</para>
      <para>"MaxAllowedZone"=dword:00000001</para>
      <para>3. In Microsoft Explorer, double click the registration file 'HtmlHelpFix.reg'.</para>
    </solution>
  </problem>
  <problem>
    <symptom>I've got zipped .chm files from work and if I unzip them only the TOC is showing, the right information panel is blank (file not found).</symptom>
    <cause>Microsoft is trying to protect you from CHM files (since they can execute stuff). Using the Windows built-in Zip support it makes sense that Windows security may try to stop you viewing the CHM from a ZIP.</cause>
    <solution>
      <para>After unzipping the CHM you need to right-click it, select properties and click the unblock button.</para>
      <para>
      <navigationLink targetVerification="false">
          <linkText>Helpware: Why does my CHM have a blank content pane?</linkText>
          <uri href="http://weblog.helpware.net/?p=36"></uri>
        </navigationLink>
      </para>
    </solution>
  </problem>
  <problem>
    <symptom>When the user clicks an ms-its jump that includes a target in another CHM file, the topic appears at the correct target location, but the css styles are not applied and the graphics do not appear. Clicking refresh loads the graphics and styles.</symptom>
    <cause>Microsoft is trying to protect you from CHM files (since they can execute stuff). Using the Windows built-in Zip support it makes sense that Windows security may try to stop you viewing the CHM from a ZIP.</cause>
    <solution>
      <para>You can work around the css problem by referencing the css in the head section of the HTML file using the ms-its protocol. But that doesn't fix the graphic issue.</para>
      <para>The solution is to replace "ms-its:" with the older "mk:@MSITStore:" scheme.</para>
    </solution>
  </problem>
</troubleshooting>
