Merging Existing HelpsetsGeneral RemarkIt is possible to merge several helpsets and to present them together in the helpviewer. Be sure that you create the search database for each helpset before you merge it! Otherwise your application might be killed by a JavaHelp invocation. Dynamic MergingDynamic merging is done during Runtime. The program checks whether certain helpsets are available and merges them programmatically. This makes sense, if you have a software that consists of modules that may be available or not. Each module comes with its own helpset. Please check the JavaHelp API documentation and the User Guide on how to do that. It is not explained here. Static MergingGiven that you have a number of helpsets, you can merge them by creating subhelpsets. This is easily done with the HS Editor. JHelpDev saves the subhelpset configuration in its project file. A problem is, that the index of the helpsets is merged but it is not in alphabetical order afterwards. Static merging makes sense if you for instance divide the creation of the helpsets between different authors. Every author creates its own helpset. Finally the topics are easily put together. Example .hs file: <?xml version='1.0' encoding='ISO-8859-1' ?> <!DOCTYPE helpset PUBLIC "-//Sun Microsystems Inc.//DTD JavaHelp HelpSet Version 1.0//EN" "http://java.sun.com/products/javahelp/helpset_1_0.dtd"> <helpset version="1.0"> <title>HelpSet 1</title> <maps> <homeID>hs1_file1</homeID> <mapref location="hs1.jhm" /> </maps> <view> <name>TOC</name> <label>Table Of Contents</label> <type>javax.help.TOCView</type> <data>hs1TOC.xml</data> </view> <subhelpset location="../helpset2/HelpSet2.hs" /> </helpset> This example assumes, that the subhelpset is in the
relative directory |