Install Java

Callisto is implemented in Java. To run Callisto on any platform, install the Java 2 Runtime Environment 1.5 or later. Java is available for free from http://java.com/ for all major operating systems.

Java is already installed in many systems. Before installing, check to see if you already have it, and which version:

For Sun Solaris, Linux, Mac OsX, Cygwin (on Windows) and other "Unix-like" systems, two quick tests are:

• Run the command which java to learn where java (if it is installed) is located in your file system.
• If installed, run the command java -version to determine which version you are accessing.

For Windows (2000, XP):

1. Click on Start->Settings->Control Panel
2. Select "Add or Remove Programs". This will list the installed programs.
3. You are looking for "Java 2 Runtime Environment, SE x.y.z", where "x.y.z" gives the version number.
4. Close the "Control Panel" and "Add or Remove Programs" windows.

Install Callisto

Callisto, as of version 1.0.10, is distributed as an installer program which unpacks all necessary files, and installs them into the directory you specify. This can be anywhere on your system. We will refer to that as your ${CALLISTO} directory. Older versions of Callisto were distributed as a compressed archive that unpacked the ${CALLISTO}.

Double-click the callisto-v.v.v-installer.jar icon, or use the following command to start the installer:

$ > java -jar callisto-v.v.v-installer.jar

Callisto now distributes shell scripts for windows and Unix. Add the ${CALLISTO}/bin directory to your PATH, (filling in the appropriate value for ${CALLISTO}) and you will be able to invoke Callisto easily from the command line.

Running Callisto

If you added ${CALLISTO}/bin to your path you can invoke Callisto from the command line:

$ > callisto

Otherwise, execute the ${CALLISTO}/Callisto.jar file.

Windows 95, 98, ME, 2000, XP, MacOSX

Double-click the Callisto.jar file. (You can also run Callisto from the Windows or Mac command line as described for Sun/Linux, below.)

1. Windows 95, 98, ME, 2000, XP: In addition, in newer versions of Callisto (1.0.10 or later?), the installer should create icons in your Start Menu. Look for Start->Programs->Callisto group, and select the Callisto icon. You may also have chosen to put an icon on your desktop.
2. MacOSX: Running on MacOSX is known to have problems.

Sun Solaris, Linux:

At a shell prompt, cd into the ${CALLISTO} directory.

Then run java, invoking the Callisto application:

$ > java -jar Callisto.jar

Language Support

Java, the language in which Callisto has been written, can render any UTF-8 file for which your computer has the appropriate fonts. Java 1.4 provides default fonts for English, most European languages, and Arabic.

If you are having trouble viewing texts in the appropriate font, try to view this same file in your web browser, setting the character encoding as appropriate. If this succeeds and you are still having trouble getting Callisto/Java to render the text file as appropriate, please contact us.

Not all languages are supported by the default font. Callisto will automatically attempt to recognize most CJK (Chinese, Japanese and Korean) documents, but will not do an exhaustive search of all fonts. In the "Format" menu, select "Format->Font->Auto-Detect Font" to guess which font best displays the current document. You can manually select the font of your choice from the "Format->Font" menu.

More fonts may be added to those tested when auto detecting. Open the "Edit->Preferences", and going to the "General/Fonts" pane. The more fonts that are auto detected, the slower the process will be.

Note for users of Windows 95, 98, 2000. The following is from the Microsoft web site: http://office.microsoft.com/en-us/assistance/HA010549991033.aspx

Multilingual system support in Windows 95, Windows 98, or
Windows 2000

  1. On the Windows Start menu, point to Settings, and then click
     Control Panel.
  2. Do one of the following:
   - In Windows 95 or Windows 98, double-click the Add/Remove
     Programs icon, and then click the Windows Setup tab.
   - In Windows 2000, double-click the Regional Options icon, and
     then click the General tab.
  3. Do one of the following:
   - In Windows 95 or Windows 98, click Multilanguage Support in
     the Components list, and then click Details. Then select the
     check boxes next to the language you want to use.
   - In Windows 2000, select the check box next to the language
     group you want under Language settings for the system.
  4. Repeat step 3 for each language you want to use.

Annotation Tasks

Install a task module by placing its .jar file, or directory, into the appropriate tasks directory and it will be available automatically the next time Callisto starts up.

There are two tasks directories: installation and personal. Most users will find it easiest to install tasks to the installation task directory, though, when an installation is shared, individuals can choose to test new Tasks by using the personal task directory.

• The installation tasks directory is ${CALLISTO}/tasks/, and annotation tasks installed here are available to all users on the system.
• The personal tasks directory is ${HOME}/.callisto/tasks/, where ${HOME} on various systems is:

Tasks in the personal tasks directory will supersede those in the installation tasks directory if they have the same identifier (Each task has an ID which is independent of the name of the .jar file).