The tools

Majix provides direct access to a set of auxiliary tools. The list of these tools is made available by using the "tools" button in Majix main window. This dialogue box will appear:

The following tools are provided:

• Editor of the configuration file

• XML parsing using a SAX compilant parser; the default parsert is XP.

• XML parsing using nsmls

• Application of a XSL stylesheet using XT

• Splitting of an XML file conforming to mydoc.dtd into smaller "pages".

Editor of the configuration file

An interactive tool is provided to edit the configuration file (see the section Editing the configuration file).

XML parsing using a SAX compliant parser

This tool checks a XML file using a SAX compliant parser. The default parser is James Clark's XML parser written in Java called XP, but you can change the parser by specifying its class in the configuration of Majix (see the Editor of the configuration file). This tool is always available.

XML parsing using nsgmls

This tool checks a XML file using James Clark's XML and SGML parser nsgmls. XML checking using nsgmls is much more thorough than with XP. However, due to its size, nsgmls is not provided with Majix installation. To use nsgmls from Majix, you need to:

• download SP distribution (which includes nsgmls) from James Clark web site: http://www.jclark.com/.

• configure Majix using the Editor of the configuration file to enable the use of nsgmls and to tell Majix the path of nsgmls executable and catalog file.

Application of a XSL stylesheet using XT

As described in "Browsing XML documents", you can transform XML into HTML or XML conforming to another structure using XT, driven by a XSL stylesheet.

Splitting of an XML file

Converting a big Word file into XML provides a big XML file. Applying an XSL stylesheet to that XML file will build a big HTML file, where it is often better to limit the size of individual HTML files destined to be downloaded on the web.

A small tool is provided with Majix which will split a XML file conforming to mydoc.dtd into a set of smaller XML files.

Note: this has been developed to produce the downloadable version of the documentation of Majix, and is not a general-purpose XML splitter.

More precisely, the splitter tool will:

• extract the sections of level 1 (delimited by tags <h1>) and put them into separate files;

• build a table of content with the headings of these sections, conforming to the DTD mytoc.dtd

• apply a XSL stylesheet to the generated XML files

• apply a XSL stylesheet to the table of content

• insert the HTML table of content in the generated HTML files.