Sun Microsystem's JavaHelp™ online documentation system can be used to provide help for Java-based applications. The best source of information on JavaHelp is Sun's website http://java.sun.com/products/javahelp/. They offer a JavaHelp User's Guide, a FAQ, and other documentation.
The standard DocBook XSL distribution includes customized stylesheets that can generate JavaHelp files from DocBook XML documents. The stylesheets are located in the javahelp subdirectory of the distribution. You can use one of the following stylesheet files with your favorite XSLT processor:
javahelp.xslThe main stylesheet file for generating JavaHelp output.
profile-javahelp.xslA further customization that supports profiling to filter your DocBook XSL files before generating output.
You use these stylesheets as you would the regular chunking DocBook XSL stylesheets. For example:
xsltproc \
--stringparam base.dir helpfiles/ \
--stringparam use.id.as.filename 1 \
javahelp/javahelp.xsl \
myfile.xmlSince javahelp.xsl is based on chunk.xsl, it has all the same default settings, and accepts all the same parameters for changing those defaults. Since the preceding command example does not change the chunking level, it chunks on sect1 (and equivalent first-level section), but not the first one in each chapter.
The javahelp.xsl stylesheet also generates the support files needed for JavaHelp:
jhelpset.hsHelpSet file that defines the components of your help application.
jhelptoc.xmlJavaHelp table of contents file.
jhelpmap.jhmJavaHelp Map file that maps id values to HTML files.
jhelpidx.xmlA JavaHelp index,. The index is empty unless your document has indexterm elements.
| DocBook XSL: The Complete Guide - 4th Edition | PDF version available | Copyright © 2002-2007 Sagehill Enterprises |