Symptoms

When browsing the HTML documentation produced using HelpNDoc's default responsive template, the table of contents is empty, shows an infinite loading animation or an error message.


Solutions

First of all, make sure that the documentation is correctly browsed from a web server. See: The HTML documentation is not loading or behaving incorrectly 
Some web servers such as older versions of Microsoft IIS or Amazon S3 must be configured to return the correct mime type for JSON, WOFF and WOFF2 files. Requesting such files will have the following results:

  • The web server will return a "404 Not Found" error for those files: this will break the table of contents in your HTML documentation;
  • The web server will return those files as "text/plain" mime type. The default HTML template will try to seamlessly work around that problem for JSON files, but can't do anything about font files.


In any case, we recommend that you web server is correctly configured to return the correct mime type for those files. Here is how this can be done for some servers:


Microsoft IIS

Edit your web.config file and add the following content:


<system.webServer>
    <staticContent>
        <mimeMap fileExtension=".json" mimeType="application/json" />
        <mimeMap fileExtension=".woff" mimeType="application/font-woff" />
        <mimeMap fileExtension=".woff2" mimeType="application/font-woff2" />
    </staticContent>
</system.webServer>


Amazon S3

Specify the property Content-Type property for every JSON, WOFF, and WOFF2 files. See Amazon S3 documentation: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectPUT.html