dbToHTMLHelp directly generates a
The XSLT stylesheet used to convert DocBook 4 documents is found in
dbToHTMLHelp generates intermediate HTML files in the temporary working directory (variable
%W) and not in the directory containing your input file. That's why you have to specify all the following XSLT stylesheet parameters:
Other XSLT stylesheet parameters such as
callout.graphics=1 are optional.
The reference documentation of these parameters is found in DocBook XSL Stylesheet Reference Documentation.
dbToHTMLHelp needs to execute a sequence of commands in order to copy some graphics files to the output directory and to run the HTML help compiler,
hhc.exe, on the output directory.
This sequence of commands depends on:
the paths of the directories containing the image files referenced by your input document;
where hhc.exe (part of HTML Help Workshop) is installed on your computer.
the image files referenced by your input document are found in the
screenshots/ subdirectory (relative to your input document);
hhc.exe is installed in
C:\Program Files\HTML Help Workshop\.
mkdir screenshots & copy "%~pI\screenshots\*.png" screenshots & mkdir images & mkdir images\callouts & copy "%~pX\..\images\*.png" images & copy "%~pX\..\images\callouts\*.png" images\callouts & "C:\Program Files\HTML Help Workshop\hhc.exe" htmlhelp.hhp & copy htmlhelp.chm "%O"
Note that the above sequence of commands works fine because a process command is always executed in the temporary working directory (variable
Copy all the image files referenced by your XML input file to the
In the case of the DocBook XSL stylesheets, these images resources are actually found in an
Copy all the image resources referenced by the DocBook XSL stylesheets to the
Run the HTML help compiler,
Doing so creates