Help for CHM Customization

Having trouble installing Oxygen? Got a bug to report? Post it all here.
antoterrence
Posts: 30
Joined: Sat May 04, 2019 5:55 pm

Help for CHM Customization

Post by antoterrence »

Is there a tutorial or documentation on CHM customization? I searched your documentation but found none.
Radu
Posts: 9049
Joined: Fri Jul 09, 2004 5:18 pm

Re: Help for CHM Customization

Post 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
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
antoterrence
Posts: 30
Joined: Sat May 04, 2019 5:55 pm

Re: Help for CHM Customization

Post 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.
Radu
Posts: 9049
Joined: Fri Jul 09, 2004 5:18 pm

Re: Help for CHM Customization

Post 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
Radu Coravu
<oXygen/> XML Editor
http://www.oxygenxml.com
Post Reply