Period character in intermediate html files causes problems
Status: Beta
Brought to you by:
xharzej
Menu
▾
▴
#30 Period character in intermediate html files causes problems
This one is really hard to reduce to a small case to reproduce. The problem is that the html help workshop cannot always cope with the period (.) character in the intermediate html filenames. It looks like it has worked and made a chm file from the output of NDoc3 but I get the windows error message "Cannot open the file: mk:MSITStore<my chm file>". This error occurs only with the chm file produced by NDoc3, and is not due to hhctrl.ocx versioning issues - I've tried lots of things to test this.
Then I found this page: http://helpware.net/FAR/far_faq.htm#HTML_Help_Compilation which says to avoid the . character. To prove this I ran NDoc3 on my project, renamed all the intermediate html output files to replace the . with _ in the names.
Then I modified the hhc and hhp files produced by NDoc3 and then loaded this up in the Help workshop and built that - it worked fine.
Note also this seems to be related to the size of the project; it only occurs when by NDoc3 project contains references to all 7 of my assemblies and over 6500 intermediate output files - as soon as I remove one assembly it is ok, but I can't explain exactly why this should be. Html help workshop seems to have particular problems with filenames which contain a .H like MyAssembly.MyNamespace.MyClass.Hello.html - it mistakes the .H of the .Hello for the .html extension.
many thanks for your other recent fixes, by the way.
Should say that Document X! generates very similar filenames to NDoc3 and doesn't seem to have the same problem so I could have got my facts wrong. If you want me to try a variant which uses underscores rather than periods then please let me know - perhaps create a branch in svn?
If you could do that it would be great. Please let me know about the results
Currently trunk won't build (as of r312) - or if you want me to test a branch, please let me know the full svn url you want me to test.
Cheers
r313 should compile, you can just test this revision.
Again thanks for the help.
r313 fixes this problem, thanks!