Installing w2x

Requirements

XMLmind Word To XML (w2x for short) requires the Oracle Java™ runtime 1.6+. However, w2x is officially supported by XMLmind only on Windows 7, 8 and 10, macOS 10.13 (High Sierra), 10.14 (Mojave) and Linux.

On Linux, make sure that the Java bin/ directory is referenced in the $PATH and, at the same time, check that the Java runtime in the $PATH has the right version:

$ java -version

java version "11.0.1" 2018-10-16 LTS

Java(TM) SE Runtime Environment 18.9 (build 11.0.1+13-LTS)

Java HotSpot(TM) 64-Bit Server VM 18.9 (build 11.0.1+13-LTS, mixed mode

On Windows and on the Mac, this verification is in principle not needed as the java executable is automatically found in the $PATH when Java has been properly installed.

Install on Windows

Download the setup.exe distribution.

Double-click on the setup.exe file to launch the installer.

Follow the instructions of the installer.

About Java on Windows

The setup.exe distribution includes a very recent, generally the most recent, Oracle® private Java™ runtime. Therefore, you don't need to install Java on your computer. Moreover, if you have Java already installed on your computer, then your public Java runtime will be ignored by w2x.

If you prefer to run w2x using a different version of Java, you'll have to first delete folder W2X_INSTALL_DIR\bin\jre\ in order to force w2x to use the version of Java installed on your computer.

Install on the Mac

Download the .dmg distribution.

Double-click the downloaded .dmg file to open it in the Finder.

Copy the WordToXML.app folder, an application bundle represented by icon ???, anywhere you want. For example, drag&drop this icon to the /Applications folder or to your desktop.

Start the w2x-app desktop application by double-clicking on the ??? icon (or use the Launchpad).

The first time w2x-app is started, your Mac will generally ask you to confirm that you actually want to open an application downloaded from the Internet. Click Open to confirm.

Don't worry, w2x-app has been digitally signed using a certificate issued by Apple itself. This confirmation is required for any digitally signed application not coming from the App Store.

Move the downloaded .dmg file to the Trash.

About Java on the Mac

The .dmg distribution includes a very recent, generally the most recent, Oracle® private Java™ runtime. Therefore, you don't need to install Java on your computer. Moreover, if you have Java already installed on your computer, then your public Java runtime will be ignored by w2x.

If you prefer to run w2x using a different version of Java, you'll have to first delete folder WordToXML.app/Contents/Resources/w2x/bin/jre/ in order to force w2x to use the version of Java installed on your computer.

Manual install on any Java 1.6+ platform (Windows, Mac, Linux, etc)

Unzip the .zip distribution in any directory you want.

C:\> unzip w2x-1_6_0.zip

C:\> cd w2x-1_6_0

C:\w2x-1_6_0> dir

... <DIR> bin

... <DIR> doc

... <DIR> legal

...

XMLmind Word To XML is intended to be used directly from the w2x-1_6_0/ directory. That is, you can run the w2x command by simply executing (in a Command Prompt on windows, a terminal on Linux):

C:\w2x-1_6_0> bin\w2x

Usage: w2x [-version] [-v|-vv] [Options] [-liststeps] in_docx_file out_file

-version

Print version number and exit.

-v|-vv

Verbose.

-liststeps

List the conversion steps to be executed and exit.

Use '-?' to list options.