I can’t compile my CHM file. How can I fix this issue?
Sisulizer requires installation of Microsoft HTML Workshop to localize HTML Help files. You can check HTML Workshop installation status via “Tools” menu -> “Platforms” -> “HTML”. If you haven’t installed HTML Workshop, you can here click on “Download HTML Workshop” button. It opens Microsoft site where you can download HTML Workshop. If you have installed HTML Workshop, but Sisulizer can’t detect it, you should click on “…” (browse) button and select correct path.
If you have already installed HTML Workshop and Sisulizer detect it, but during compilation localized file in Output pane appear compilation errors or localized file contains errors, you can go to “Project” menu -> “Edit source” -> your CHM source -> “Options” tab. Here you can uncheck “Create localized CHM file” option.
This feature build contents of your CHM file as HTML directory with all images, HTML, css, scripts files etc. If you are advanced web developer you can even find reason of problem, because this allows you:
- Find potential issues related to Microsoft HTML Workshop
- Check potential incorrectly items in your source CHM file e.g. invalid links, images, tags and scripts, encoding issues, because you can open output HTML files in any advanced txt/HTML editor, while this is rather impossible with compiled CHM file
- Find potential bugs in Sisulizer. This is not difficult. Simply, use any comparison tool (e.g. freeware WinMerge) or ext editor with similar feature (e.g. freeware PSPad or commercial UltraEdit) for comparing source and output HTML file. When you find differences in tags/scripts structure, encodings etc. – it could be result of bug in Sisulizer. We always appreciate information about potential bugs, because detailed bug reports allows us to improve Sisulizer.
You can also use localized output HTML files, even when compilation of CHM file failed, or compile these files with external tool.
Hint
You can use this solution to creation of WebHelp files directly from CHM files.
Janusz
Did you enjoy this post? Why not leave a comment below and continue the conversation, or subscribe to my feed and get articles like this delivered automatically to your feed reader.
Comments
No comments yet.
Leave a comment