Quick Installation for the Specialist

To get Jago to run, you need to install a Java run-time locally. You must use the 1.1.x runtime. Then download the new version jago.zip from our server. You can start Java with

set CLASSPATH=path_of_jago.jar
java jagoclient/Go

or the corresponding command in UNIX. If you are using a foreign language ressource, add it to the CLASSPATH. If you are using another runtime (like the Internet Explorere runtime with the jview command or the jre of Sun), replace the java command, of course.

Instructions for the Computer Novice

Follow these steps for Windows 95/NT systems.

  1. Download the Java 1.1.x runtime from Sun's site or from our site.
  2. Install it. You simply have to run the EXE file. You need not be Administrator on Windows NT.
  3. Download the self installing Jago version.
  4. Start the downloaded jago95i.exe program.
  5. You can now start Jago with the proper icons.

Normal Installation

Unix and Other

Make sure you have a Java Runtime of version 1.1 or higher. The ZIP-file must be unzipped. This will create a directory Jago.

The program may be started from a command line with

set CLASSPATH=jago.jar
java Go

This assumes that the java program is in your program path. If not, insert the directory of java (usually .../java/bin or something similar) into the path. You may want to do all this in a shell script.

Windows 95/NT

This assumes, you have a local Java runtime installed (either Sun's or the one from Intenrnet Explorer 4.0). If you haven't, install the 1.1.x Java runtime environment, which you may find on our server. Just run the file. Then you download the Jago ZIP file (for a self installing version, see above).

You will have to unzip the Jago ZIP file. This will create a directory named Jago.You can then go that directory (assuming it is C:\Jago) and start Jago with

C:
cd \jago
jrew -cp jago.jar Go

You should put this into a batch file and set up an icon to run this batch file. In case of the Internet Explorer 4.0 runtime, use

jview Go

instead. If you have installed the JDK from Sun, use

set CLASSPATH=jago.jar
javaw Go

I have written more help for this system into the FAQ.

Local Language Support

First of all, you can send local characters to the server. Java keeps the characters internally as UNICODE, and will send them using your local encoding. To view these characters properly, you will have to enter your local encoding in the server edit dialog. By default, your local encoding is used here. However, you can change this to 8859_1, which is a good default.

Masamitsu Junji took the effort to rewrite Jago to support international menus and dialogs. He also prepared a Japanese version. To use a local version, you need the proper resources. I will bundle each local resource into jar files and publish them on my server. To use these resources, add them into your classpath. E.g., start Jago with

jrew -cp jago.jar;JagoResource_de.jar Go

This examples is for the German version. Available local version are

Since it is best to have the version of Jago which fits your resource file, you should download the Jago version from the same site as your resource. Jago will continue to work with an older resource file, but some strings may not translate and some help files may be outdated.

You can run Jago in another language (even if it is not your locale) by downloading its resource and setting the language with the corresponding menu item. Normally it will run in your local language automatically, if you have installed the resource.

To prepare your own local version, you need to do the following

  1. Download the Resource files and unzip them. You can use any unzip program that handles long filenames.
  2. Rename JagoResource.properties into JagoResource_lg.properties, where lg is your language (de for german, en for english). If you are not sure about the correct letters for your language, run jago with the -dump parameter and look into the dump file.
  3. Rename the help files in the same way.
  4. Copy the renamed resource file and the help files into your jago directory.
  5. Translate the resource file and the help files.
  6. The HELP_SUFFIX resource int JagoResource_lg.properties must have the value _lg (your language).
  7. Either jar the resource file and the help files and append the jar file to your classpath as above, or append the jago directory to your classpath.
  8. Send the resource to me.