2. Running XMLmind XSL Utility

2.1. System requirements

A Java™ 11+ runtime is required to run the XMLmind XSL Utility.

XMLmind XSL Utility is officially supported is officially supported on Windows 8.1/10/11 (32-bit or 64-bit), on Linux and on macOS (Intel® or Apple® Silicon processor) 26.x (Tahoe) and on macOS 15.x (Sequoia).

2.2. Installation

Simply unzip the distribution somewhere. Linux/macOS example:

~$ cd /opt
/opt$ unzip /tmp/xslutil-6_6_0.zip
/opt$ ls xslutil-6_6_0
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.3, DocBook 4.x, DocBook 5.0, DocBook 5.1+, XHTML) and plug-ins (FOP, Batik, JEuclid, XEP, XFC).
bin/xslutil.exe, xslutil-c.bat: Executable file and .bat file used to run XMLmind XSL Utility on Windows. More information about xslutil-c.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 licenses as well as the licenses 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-6_6_0\bin\xslutil

After testing that it works, you may want to add a shortcut to C:\xslutil-6_6_0\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-6_6_0/bin/xslutil &

Note that it's possible to specify the file to be converted as a command-line argument. Linux example:

/opt$ xslutil-6_6_0/bin/xslutil userguide/doc.ditamap &

In such case, when the file extension of the input file is well known (dita, ditamap, html, xhtml, fo, etc), the corresponding conversion to DOCX is automatically selected as well as an output file having the same name and directory as the input file, but with a "docx" extension. In the case of the above example, the "ditaToDocx" conversion is automatically selected with a "userguide/doc.docx" output file.

Running XMLmind XSL Utility on a computer having a very high resolution (HiDPI) screen

	Running XMLmind XSL Utility on a computer having a very high resolution (HiDPI) screen
XMLmind XSL Utility works fine on computers having very high resolution (HiDPI) screens. For example, it works fine on a Mac having a Retina® screen and a Windows computer having an UHD (“4K”) screen. However, on some Linux computers having HiDPI screens, HiDPI is not automatically detected. You'll have to specify the display scaling factor you prefer using the `-putpref` command-line option: xslutil -putpref displayScaling 200 Preference key `displayScaling` may be used to globally change the size of all the items comprising the user interface of XMLmind XSL Utility. Its value is a percentage between 100 and 400 or integer -1 which means use system settings. Note that using option `-putpref` updates the user preferences file. Therefore suffice to specify `-putpref` once and you are done.

XMLmind XSL Utility works fine on computers having very high resolution (HiDPI) screens. For example, it works fine on a Mac having a Retina® screen and a Windows computer having an UHD (“4K”) screen.

However, on some Linux computers having HiDPI screens, HiDPI is not automatically detected. You'll have to specify the display scaling factor you prefer using the -putpref command-line option:

xslutil -putpref displayScaling 200

Preference key displayScaling may be used to globally change the size of all the items comprising the user interface of XMLmind XSL Utility. Its value is a percentage between 100 and 400 or integer -1 which means use system settings.

Note that using option -putpref updates the user preferences file. Therefore suffice to specify -putpref once and you are done.

FlatLAF as the default Look&Feel on Linux

On Linux, FlatLAF and its light theme (called "FlatLight") is now used as the default Look & Feel. This is needed because on Linux, the “system” Look & Feel (called "Metal") looks rather outdated.

If, for any reason, you prefer to use the “system” Look & Feel, please start xslutil by running

xslutil -putpref lookAndFeelClassName fallback

This setting is done once for all. If after doing that, you finally prefer to revert to FlatLaf, simply run

xslutil -delpref lookAndFeelClassName

The FlatLAF Look&Feel is available on all platforms. For example, if you prefer a dark theme on your Mac, simply start xslutil as follows.

xslutil -putpref lookAndFeelClassName com.formdev.flatlaf.themes.FlatMacDarkLaf

As explained above, this setting is done once for all. No need to specify -putpref lookAndFeelClassName LAF_class_name after that.

Description	`Value of` `LAF_class_name`
FlatLaf Light	`com.formdev.flatlaf.FlatLightLaf`
FlatLaf Dark	`com.formdev.flatlaf.FlatDarkLaf`
FlatLaf IntelliJ (based on FlatLaf Light)	`com.formdev.flatlaf.FlatIntelliJLaf`
FlatLaf Darcula (based on FlatLaf Dark)	`com.formdev.flatlaf.FlatDarculaLaf`
FlatLaf macOS Light	`com.formdev.flatlaf.themes.FlatMacLightLaf`
FlatLaf macOS Dark	`com.formdev.flatlaf.themes.FlatMacDarkLaf`
“System” Look & Feel	`fallback`
Default Look & Feel	`default`

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^[2], XMLmind XSL Utility starts as a desktop 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 (single line; do not type “¬”) corresponding to the figure below:
```
C:\xslutil-6_6_0\bin> xslutil-c ditaToDocx¬
  C:\src\10xxe\demo\dita\dita-sample.ditamap¬
    C:\tmp\dita-sample.docx
```
On Windows, make sure to use xslutil-c.bat and not xslutil.exe.
Linux/Mac example (single line; do not type “¬”):
```
/opt/xslutil-6_6_0/bin$ xslutil ditaToDocx¬
  ~/src/10xxe/demo/dita/dita-sample.ditamap¬
    /tmp/dita-sample.docx
```


On Windows, make sure to use `xslutil-c.bat` and not `xslutil.exe`.

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.

^[2]Or just with the file to be converted as the single command-line argument of XMLmind XSL Utility.


1. Overview		3. Converting an XML document to another format