2. Running XMLmind XSL Utility

2. Running XMLmind XSL Utility
Prev		Next

2.1. System requirements

Sun or Apple Java™ runtime 1.5 or above.
100Mb of free disk space.

XMLmind XSL Utility is officially supported on Windows XP/Vista/7, on Linux 2.6 and on Mac OS X 10.4 (Tiger), 10.5 (Leopard), 10.6 (Snow Leopard). It is possible to use it on other Java™ 1.5+ platforms (e.g. Solaris), but without support from XMLmind.

2.2. Installation

Simply unzip the distribution somewhere. Linux/Mac example:

~$ cd /opt
/opt$ unzip /tmp/xslutil-4_3_2.zip
/opt$ ls xslutil-4_3_2
addon/
bin/
doc/
legal.txt
legal/

This means that uninstalling XMLmind XSL Utility simply consists in deleting the directory created by unzipping its distribution.

2.3. Contents of the installation directory

addon/: Contains XMLmind XML Editor configurations (DITA 1.1, DocBook 4, DocBook 5, XHTML) and plug-ins (FOP, Batik, JEuclid, Jimi, XEP, XFC). (As of v4.3, XMLmind XSL Utility is based on the add-on architecture of XMLmind XML Editor.)
bin/xslutil.exe, xslutilc.bat: Executable file and .bat file used to run XMLmind XSL Utility on Windows. More information about xslutilc.bat in Section 2.5, “XMLmind XSL Utility as a command-line tool”.
bin/xslutil: Shell script used to run XMLmind XSL Utility on the Mac and on Linux.
bin/*.jar: All the (non-system) Java™ class libraries needed to run XMLmind XSL Utility.
bin/icon/: Contains desktop icons for XMLmind XSL Utility.
doc/index.html: Points to copies of this online help in HTML, PDF, RTF, WordprocessingML, Office Open XML and OpenOffice formats.
legal.txt, legal/: Contains XMLmind XSL Utility licences as well as the licences and notices attached to the software components used to build XMLmind XSL Utility.

2.4. Starting XMLmind XSL Utility

XMLmind XSL Utility is intended to be used directly from the directory created by unzipping its distribution. That is, you can start XMLmind XSL Utility by typing the following command in a command prompt and then, by pressing Enter:

C:\> xslutil-4_3_2\bin\xslutil

After testing that it works, you may want to add a shortcut to C:\xslutil-4_3_1\bin\xslutil.exe on your desktop.

On the Mac and on Linux, please type the following command in a terminal, then press Enter:

/opt$ xslutil-4_3_2/bin/xslutil &

2.5. XMLmind XSL Utility as a command-line tool

XMLmind XSL Utility may also be used a command-line tool.

Without any command-line arguments, XMLmind XSL Utility is a 100% graphical application.
If you pass it the following command-line arguments, XMLmind XSL Utility will perform the conversion without displaying its main window:
```
xslutil conversion_specification_name input_xml_file output_file_or_directory
```
Windows example corresponding to the figure below:
```
xslutilc dbToDocx E:\src\4xxe\docsrc\xhtml\help.xml E:\tmp\help.docx
```
Important
On Windows, make sure to use xslutilc.bat and not xslutil.exe.
Linux/Mac example:
```
xslutil dbToDocx /home/john/src/4xxe/docsrc/xhtml/help.xml /home/john/tmp/help.docx
```

The basic idea here is to use the dialog box to add or edit conversion specifications and then to use the XMLmind XSL Utility command-line to actually perform the conversion. This way you get the best of both worlds.

Prev		Next
1. Overview	Home	3. Converting an XML document to another format