Help for CHM Customization

Having trouble installing <oXygen/>? Got a bug to report? Post it all here.
antoterrence
Posts: 28
Joined: Sat May 04, 2019 5:55 pm

Help for CHM Customization

Post by antoterrence » Thu Jul 04, 2019 2:22 am

Is there a tutorial or documentation on CHM customization? I searched your documentation but found none.

Radu
Posts: 6507
Joined: Fri Jul 09, 2004 5:18 pm

Re: Help for CHM Customization

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

antoterrence
Posts: 28
Joined: Sat May 04, 2019 5:55 pm

Re: Help for CHM Customization

Post by antoterrence » Sat Sep 28, 2019 10:20 am

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: 6507
Joined: Fri Jul 09, 2004 5:18 pm

Re: Help for CHM Customization

Post by Radu » Mon Sep 30, 2019 8:06 am

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