Internal error when trying to compile...

This is the place to discuss Help & Manual 4 issues. Please don't post questions on any other versions here!

Moderators: Alexander Halser, Tim Green

User avatar
Tim Green
Site Admin
Posts: 23153
Joined: Mon Jun 24, 2002 9:11 am
Location: Bruehl, Germany
Contact:

Re: Internal error when trying to compile...

Unread post by Tim Green »

Hi Alex,

Your license is valid for all versions of your major version (i.e. everything from 5.0.0 to 5.9.99).
We have to use the Russian font and I think the problem is that the new version can’t understand Russian font (Cyrillic) in the field Target.
In the version 5.3.1 it worked very good.
The error was in the earlier version. Non-ASCII characters in topic IDs are illegal and will always cause serious errors. You are just seeing it more quickly in the current version. As a general rule, you should also avoid using either spaces or non-alphanumeric characters or non-ASCII characters in any file names that will be used with HTML-based formats. This includes the names of your Help & Manual project file names and any other files that you use in your projects, such as graphics files, your own JavaScript and CSS files and so on. To be on the safe side, only use the characters a..z, A..Z, 0..9 and the _ underscore character in all project and other file names, including graphics files. Do not use any spaces, ever.

There are a number of important reasons for this:

* A number of key HTML files in your output are named based on the project name. HTML files containing spaces or special characters in their names do not work at all, so H&M must correct the names. This means that the names will not match the project name, and this can cause reference problems.

* The names of CHM files generated from your project must match the project file name exactly. If they do not, any links you create between CHM files will not work because H&M must assume that the CHM file will have the same name as the project for referencing it.

* Microsoft CHM is an ancient format that has not been updated since it was released with Windows 98. It is extremely allergic to spaces and special characters in file names and will often crash or fail if they are present. CHM files with spaces in their names will often fail suddenly, or may not be found by your software. If your project name has spaces or special characters in it you must either create CHMs with illegal names to force them to match, or change the name of the CHM and risk referencing failures.
Regards,
Tim (EC Software Documentation & User Support)

Private support:
Please do not email or PM me with private support requests -- post to the forum directly.
Alex Gurevich
Posts: 18
Joined: Wed Feb 22, 2012 6:50 am

Re: Internal error when trying to compile...

Unread post by Alex Gurevich »

Microsoft CHM is an ancient format that has not been updated since it was released with Windows 98. It is extremely allergic to spaces and special characters in file names and will often crash or fail if they are present. CHM files with spaces in their names will often fail suddenly, or may not be found by your software. If your project name has spaces or special characters in it you must either create CHMs with illegal names to force them to match, or change the name of the CHM and risk referencing failures.
Thank you, Tim.
So, what format do you recomment instead of the CHM one?
User avatar
Tim Green
Site Admin
Posts: 23153
Joined: Mon Jun 24, 2002 9:11 am
Location: Bruehl, Germany
Contact:

Re: Internal error when trying to compile...

Unread post by Tim Green »

Hi Alex,
So, what format do you recomment instead of the CHM one?
None, CHM is still the only official help format for Windows applications and still the best choice for local help installed together with your application. You just need to be aware of some problems that it has, that is all.
Regards,
Tim (EC Software Documentation & User Support)

Private support:
Please do not email or PM me with private support requests -- post to the forum directly.
Post Reply