Getting Started
Deploying JSite is as easy as using any other Java applet. With any HTML/text editor, simply insert the following <applet> tag into the HTML page. The basic tag looks like this:
<APPLET
CODE="earthstones/JSite.class" WIDTH=1024 HEIGHT=610
codebase="java" name="JSiteApp" hspace=0
vspace=0 >
</APPLET>
Unless otherwise noted, EarthStones' classes assume that relative paths (i.,e., any path which does not supply a fully-resolved internet address typically beginning with http://) are relative to the HTML document containing the applet's tag. Typically this file will have a name such as index.html if it is the web site's home page and must appear in the web site's root directory which we will call, for illustration purposes, public_html.
The codebase parameter set above further specifies that all java byte code (i.e., all .class files) will be found in the java subdirectory (i.e., in public_html/java). Typically this directory (or its other subdirectories) may contain other Java class libraries as well.
Finally, the code file "earthstones/JSite.class" is the JSite byte code for the applet itself and must be found along the path relative to that specified by codebase (i.e., JSite.class must appear in public_html/java/earthstones). See directory structure details for more information. EarthStones' entire class library should appear in this subdirectory. Note that most web servers run on Unix operating systems which are CASE SENSITIVE (and do not permit blank characters in directory/file names). EarthStones' classes all assume that they will reside in an earthstones (small e) directory. The use of the name java above is arbitrary but customary; however, the case used in the applet tag must agree with that used by the file system.
The width and height attributes reserve space for the applet on the HTML page. JSite is typically run as an applet that takes over the entire browser window and assumes that it is being given values appropriate for a screen resolution of 1024 x 768 pixels. Hence the values 1024 and 610 (allowing for the browser's toolbars, etc. Under normal circumstances these dimensions will not need to be altered.
The name attribute (e.g., "JSiteApp") can be set to any string value and is needed only in the event that you will want to refer to the applet from within a script. Typically JSite's all-Java approach makes this unnecessary. The optional attributes hspace and vspace which provide white space around the applet in the HTML page are irrevant when the applet uses the entire page.