Page 1 of 1

Help for CHM Customization

Posted: Thu Jul 04, 2019 2:22 am
by antoterrence
Is there a tutorial or documentation on CHM customization? I searched your documentation but found none.

Re: Help for CHM Customization

Posted: Thu Jul 04, 2019 7:57 am
by Radu
Hi,

I do not know a tutorial but for CHM you can customize a couple of things:

1) Using CSS you can customize how the HTML content is rendered. You can create your custom CSS and then edit the transformation scenario, in the Parameters list set the "args.css" to point to your custom CSS stylesheet and the parameter "args.copy.css" to "yes" in order to copy the custom CSS inside the CHM.
2) In the folder OXYGEN_INSTALL_DIR/frameworks/dita/DITA-OT3.x/plugins/org.dita.htmlhelp/xsl/map2htmlhelp there are two XSLT stylesheets, one creates the .hhc and the other the .hhp file.
The .hhc file is the table of contents and the .hhp contains information for compiling the CHM and various settings which are read by the HTML Help Workshop when creating the CHM. You can google for more information about them. Unfortunately information on these files is not very abundant on the net.

Regards,
Radu

Re: Help for CHM Customization

Posted: Sat Sep 28, 2019 10:20 am
by antoterrence
Radu wrote:
Thu Jul 04, 2019 7:57 am
Hi,

I do not know a tutorial but for CHM you can customize a couple of things:

1) Using CSS you can customize how the HTML content is rendered. You can create your custom CSS and then edit the transformation scenario, in the Parameters list set the "args.css" to point to your custom CSS stylesheet and the parameter "args.copy.css" to "yes" in order to copy the custom CSS inside the CHM.
2) In the folder OXYGEN_INSTALL_DIR/frameworks/dita/DITA-OT3.x/plugins/org.dita.htmlhelp/xsl/map2htmlhelp there are two XSLT stylesheets, one creates the .hhc and the other the .hhp file.
The .hhc file is the table of contents and the .hhp contains information for compiling the CHM and various settings which are read by the HTML Help Workshop when creating the CHM. You can google for more information about them. Unfortunately information on these files is not very abundant on the net.

Regards,
Radu
Hi Radu,
I did take a look at these files. Any idea which XSLT file handles the Help Viewer configurations? I want to add a custom Next and Previous button. Also, want to remove certain buttons from output. I did google for information, but very little. If you know which file I should touch for customization, I will figure out the rest. Thank you in advance.

Re: Help for CHM Customization

Posted: Mon Sep 30, 2019 8:06 am
by Radu
Hi,

I think the hhp file should be the one modified for this but I do not know much about this I'm afraid.

Regards,
Radu