c++ - How to generate CHM with Doxygen and HTML Help Compiler? -
the short story: can generate chm file doxygen. launching chm file, observe contents , index tabs list pages, namespaces, classes, , members of classes. however, clicking on items in contents , index lists not display content.
i on computer using windows 7 professional sp1, 64-bit.
i use doxywizard run doxygen version 1.8.9.1 on code. correctly generates html output; pages, namespaces, classes, , members appear in documentation.
i further want convert html compressed html (chm) file.
i downloaded microsoft html workshop version 1.31 (i.e., htmlhelp.exe version 4.74.8703 ) microsoft website ( https://msdn.microsoft.com/en-us/library/windows/desktop/ms669985(v=vs.85).aspx ). ran installer. installer proceeding, popup message appeared:
this computer has newer version of html help.
however, installation completed successfully. and, hhc.exe program there told install.
i specify these relevant doxygen settings:
- wizard --> output:
- html checked
- "prepare compressed html (.chm)" option selected.
- expert --> html:
- generate_htmlhelp = yes
- chm_file = foo.chm
- hhc_location = c:\program files(x86)\microsoft\html workshop\hhc.exe
when run doxygen again, reports error:
error: failed run html compiler on index.hhp the foo.chm file generated expected. but, described above, missing lot of content.
i tried running hhc.exe manually on hhp file generated doxygen. not indicate errors.
c:\program files (x86)\microsoft\html workshop>hhc c:\test\html\index.hhp microsoft html compiler 4.74.8702 compiling c:\test\html\foo.chm compile time: 0 minutes, 3 seconds 292 topics 3,855 local links 83 internet links 0 graphics created c:\test\html\foo.chm, 259,580 bytes compression decreased file 1,077,915 bytes. however, result same: foo.chm file missing content.
i subsequently found had installation of html workshop on computer. but, hhc.exe exact same version. so, not problem.
can suggest else can try documentation content display in chm file?
when have seen problem (the html exists , chm has content content not visible), has been because windows security has "blocked" chm file. see if encountering try following:
- from windows explorer, right click generated .chm file , select properties.
- on general tab, if see unblock button, click it.
- close dialog , open .chm file.
(i have not encountered problem locally generated doxygen .chm files, hopeful description may fix problem.)
Comments
Post a Comment