Running Majix

Majix is a Java application (not an applet). You can run it on the virtual machine of your choice as long as it supports Java 1.1. Majix has been tested on Sun's and Microsoft's virtual machines, under Windows 95 and Windows NT.

Interactive execution

Majix is run by executing the main entry point in the Java class com.tetrasix.majixstandard.MajixStandard in the Java archive classes\majix.jar;classes\xp.jar. The following option is available:

• -language en or -language fr to change the language of the user's interface;

Running Majix with Sun's Virtual Machine

You can run Majix with the Sun's VM 1.1.x by typing the following command from the installation directory:

jre -cp classes\majix.jar;classes\xp.jar;classes\xt.jar;classes\sax.jar com.tetrasix.majixstandard.MajixStandard

The installation directory of Majix contains a batch file run_jre.bat which executes this command. You can run it, for instance , from the explorer.

Running Majix with Microsoft's Virtual Machine

You can run Majix, the XML converter, with Microsoft's VM by typing the following command in the installation directory:

jview /cp classes\majix.jar;classes\xp.jar;classes\xt.jar;classes\sax.jar com.tetrasix.majixstandard.MajixStandard

The installation directory of Majix contains a batch file majix_jview.bat which executes this command. You can run it for instance from Explorer.

Running Majix with other Virtual Machine

To run Majix on another Java Virtual Machine, please refer to the documentation of that machine.

Finding the configuration file

Majix stores in a configuration file the information pertaining to its access to other tools (see tools) such as a HTML browser to display the documentation. It expects to find the configuration file in the current directory with the name majix.conf. You can specify another directory by setting the system property majix.dir, and the filename by setting the system property majix.conf. For instance, if you want to use a configuration file x:\myowndirectory\mymajix.conf, you will run Majix using Sun's VM with the command:

jre -Dmajix.dir=x:\myowndirectory -Dmajix.conf=mymajix.conf

or, using Microsoft's VM with the command:

jview /Dmajix.dir=x:\myowndirectory /Dmajix.conf=mymajix.conf

Changing the Interface Language

The user's interface of Majix exists in English and in French. By default, the language used is the current language of the system. You can force an other language by using the options

-language language -country country

where language is the code of the language and country is the code of the country. The two languages currently supported are:

• language en for English language

• language fr for French language

Examples:

jview /cp classes\majix.jar;classes\xp.jar com.tetrasix.majixstandard.MajixStandard -language en -country US

or, for a french interface

jview /cp classes\majix.jar;classes\xp.jar com.tetrasix.majixstandard.MajixStandard -language fr

Batch execution

The entry point for batch execution is com.tetrasix.majixstandard.MajixBatch. It takes the following options:

com.tetrasix.majixstandard.MajixBatch [ -xp ] [-styles filename ] [-tags filename ] inputfile outputfile

where:

• -xp indicates that one wants to check the output file using XP

• -styles filename specifies a file containing a style mapping definition

• -tags filename specifies a file containing a tag mapping definition

• inputfile is the name of the input file in format .RTF or .DOC

• outputfile is the name of the output XML file.

Note: using .DOC file as input file is only supported when:

• Majix runs under jview

• Microsoft Word 97 is available

• that function has been enabled in the configuration file.

The language options are available as in the interactive version.

Examples:

jview /cp classes\majix.jar;classes\xp.jar com.tetrasix.majixbox.MajixBatch -xp foo.rtf foo.xml