Converter Messages
When converting a project or a compiled Help file, the converter displays messages in the General Output window during the process and creates a conversion log after the conversion is complete. An error message appears on-screen to notify you when converter messages have been generated in the Output window. The following types of messages are generated:
Warning
Error
Completion status
Warning Messages
Because HTML Help 1.x and Microsoft Help 2.0 have different file structures, the converter may encounter an HTML Help 1.x construct that has no direct translation in Microsoft Help, but for which a reasonably close translation can be made. For example, HTML Help 1.x information types are converted to attributes in Microsoft Help. In these cases, the converter makes the translation and issues a warning.
注意
Warnings of a given type are issued only once.
Warning |
Definition |
---|---|
Information types converted as attributes. |
|
Window definitions will not be converted. |
|
TOC background images will not be preserved. |
|
Auto-TOC is not supported. |
|
Unrecognized section <section> in project file. |
|
[MERGE FILES] must be registered in primary title's namespace. |
|
TOC background/foreground color will not be preserved. |
|
Embedded TOCs will not be converted. |
|
Embedded indexes will not be converted. |
|
Shortcuts will not be converted. |
|
Related Topics will not be converted. |
|
Cannot find file <file>. |
|
Default namespace mapping used in URL. |
|
Close command will not be converted (use -p for script conversion). |
|
HH Version command will not be converted (use -p for script conversion). |
|
TCard command will not be converted. |
|
The HTML tag <tag> has invalid characters appearing before the closing angle bracket: <bracket>. |
|
The HTML tag <tag> is not a valid HTML tag (it does not begin with an alphanumeric character). |
|
The HTML end tag <tag> has invalid characters before the closing angle bracket. |
|
An empty HTML tag has been used. |
|
The following option line does not contain an '=' character separating the option and its value <value>. |
|
The option <option> is not recognized. |
|
The file <file> is already listed in the [FILES] section of the project file. |
Error Messages
At times, the converter may encounter a situation for which it has no close translation or solution. When this occurs, it will issue an error message and stop processing the current file. If processing a project, the converter will continue to process the rest of the project if possible.
Error Message |
Definition |
---|---|
Unrecognized parameter <param>. |
|
Parameter <param> requires a value. |
|
No input files specified. |
|
Cannot open file <file>. |
|
Cannot open mapping file <file>. |
|
Cannot open log file <file>. |
|
Cannot create output directory <dir>. |
|
Out of disk space on drive <drive>. |
|
File <file> exists (use -y to overwrite). |
|
Unrecognized file type <type>. |
|
Parameter <param> may only be specified once. |
|
Both '-q' and '-v' specified. |
|
Only one input file may be specified. |
|
Corrupt file <file>. |
|
Error writing to file <file>. |
|
The project locale is not supported: <locale>. |
|
A required component is missing or has not been registered: <component>. |
|
Both '-w' and '-u' specified. |
|
Parameter <param> does not take a value. |
|
The project lcid <lcid> is not supported. |
|
This version of Windows only supports the conversion of projects that use the same locale as the system. The project lcid is <lcid>. |
|
This version of Windows only supports the conversion of projects that use the same locale as the system. The project locale is <locale>. |
|
The locale does not support conversion of this .chm file. Make sure the default system locale and the User Input locale both support the language of the .chm file. |
|
The HTML tag '<tag>' is missing a closing angle bracket. |
|
: A comment tag (<!--) is missing the close comment tag (-->). |
Completion Status Messages
Upon completion, the converter displays one of the following messages, depending on the results of the conversion.
Completion Status Message |
Definition |
---|---|
Conversion completed successfully. |
The converter encountered no warnings or errors. |
Conversion completed with warnings. |
The converter encountered warnings, but no errors. |
Conversion completed with errors. |
The converter encountered errors, but was still able to generate a converted file or project. |
Conversion failed. |
The converter failed to generate a converted file or project; for example, if there is not enough disk space, or if the converter encounters a corrupt HTML Help 1.x Help project (.hhp) file. |