Installing w2x

Requirements

XMLmind Word To XML (w2x for short) requires the Oracle Java™ runtime 1.6 to 1.8 (new Java 9 not yet supported). However, w2x is officially supported by XMLmind only on Windows XP to 10, macOS 10.13 (High Sierra), 10.12 (Sierra) and 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 "1.8.0_131"

Java(TM) SE Runtime Environment (build 1.8.0_131-b11)

Java HotSpot(TM) 64-Bit Server VM (build 25.131-b11, 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.

This setup.exe files 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.

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

Follow the instructions of the installer.

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. However, this private runtime is not necessarily the one which will be used to run w2x-app:

- If you have an Oracle Java runtime at least as recent as the bundled one installed on your computer, this runtime will be used to run w2x-app.

- Otherwise, it's the bundled runtime which will be used to run w2x-app.

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_3_0.zip

C:\> cd w2x-1_3_0

C:\w2x-1_3_0> dir

... <DIR> bin

... <DIR> doc

... <DIR> legal

...

XMLmind Word To XML is intended to be used directly from the w2x-1_3_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_3_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.