Omni Systems, Inc. Mif2Go User's Guide, Version 55
> 11 Generating JavaHelp or Oracle Help > 11.3 Setting up a JavaHelp or Oracle Help project > 11.3.6 Establishing an Oracle Help environment
To use Oracle Help for Java, you must have both
Oracle Help and a Java Virtual Machine (JVM) installed on your system.
Oracle Help version 5.0 requires Java SE version 5.0 or a later version.
If you plan to create .jar
files, you will
also need jar.exe
from the Java Developer’s
Kit (JDK).
Oracle Help for Java is available for download from the Oracle Technology Network; see §11.2 Obtaining tools for a Java-based Help system.
Edit Windows System environment variable CLASSPATH
(or create CLASSPATH
if it is not already defined
on your system):
Control Panel > System > Advanced > Environment Variables
What you add to CLASSPATH
depends on which version of Oracle Help you are using; the dependencies
and file names changed between versions 4 and 5.
If you are using Oracle Help version 4, append
to CLASSPATH
the following paths, separating
each path from the next with a semicolon:
where\you\installed\ohj\help4.jar
where\you\installed\ohj\help4-demo.jar
where\you\installed\ohj\help4-indexer.jar
where\you\installed\ohj\ohj-jewt.jar
where\you\installed\ohj\oracle_ice.jar
For example (all on one line, of course):
CLASSPATH=D:\ohelp\help4-indexer.jar;D:\ohelp\help4-demo.jar;D:\ohelp\help4.jar;D:\ohelp\ohj-jewt.jar;D:\ohelp\;D:\ohelp\oracle_ice.jar;D:\ohelp\help4-indexer.jar
If you are using Oracle Help version 5, append
to CLASSPATH
the following paths, separating
each path from the next with a semicolon:
where\you\installed\ohj\ohj.jar
where\you\installed\ohj\help-share.jar
where\you\installed\ohj\share.jar
where\you\installed\ohj\help-demo.jar
where\you\installed\ohj\help-indexer.jar
where\you\installed\ohj\jewt.jar
where\you\installed\ohj\oracle_ice.jar
For example (all on one line, of course):
CLASSPATH=g:\ohj5;g\ohj5\ohj.jar;g:\ohj5\help-share.jar;g:\ohj5\oracle_ice.jar;g:\ohj5\jewt.jar;g:\ohj5\share.jar;g:\ohj5\help-indexer.jar
Given these settings for CLASSPATH
,
if you have also established a path to java.exe
in a current JRE (see §11.3.5 Establishing a JavaHelp environment),
to view the results of generating Oracle Help you should be able to use
a .bat
file with commands like the following:
java oracle.help.demo.ChoiceDemo "\path\to\MyOutput\help\MyDoc.hs"
In practice, for Oracle Help 5, we find that
setting the CLASSPATH
environment variable
is not sufficient; you must still supply the same dependencies to the
java
command as an argument to -classpath
.
For example:
REM The following java command must be all on one line:
java -classpath
"ohj.jar;help-share.jar;oracle_ice.jar;jewt.jar;share.jar;help-demo.jar"
oracle.help.demo.ChoiceDemo "G:\OmniSys\UG\ohj\help\ugmif2go.hs" %*
Your experience might be different.