1.3.3 Install DITA2Go

Before you begin:

Why no installer?

Omni Systems does not provide an installer for DITA2Go. This is done for transparency; you know DITA2Go does not “call home”, make changes to the Windows Registry, put files where your company policy does not permit them, nor alter any other files on your system. Information-system technicians can see exactly what will happen, and adjust the instructions as needed to comply with company policy.

Extract files

To install DITA2Go for the first time, place DITA2Go distribution d2g_full_03.zip in your Omni Systems home directory and extract all files, allowing the extraction process to create subdirectories.

Note:  If your unzip or uncompress utility puts the extracted files in a directory named after the distribution archive, move them up one level so they are directly under the Omni Systems home directory. For example, executables should be in %OMSYSHOME%\common\bin, not in %OMSYSHOME%\d2g_full_03\common\bin.

Check directory structure

You should have a directory structure that looks like this:

%omsyshome%
  |
  |--common
  |    |--bin
  |    |--local
  |    |--omnihelp
  |    +--system
  | 
  |--d2g
  |    |--documents
  |    |--dtds
  |    |--local
  |    |--specializations
  |    |--system
  |    |--usersguide
  |    +--zip
  |
  +--demo
       |--DITA2GoUG
       |--DITA4Publishers
       +--DITATestSuite

Finish installing

To complete the installation:

  1. Move the DITA2Go distribution .zip file to subdirectory %OMSYSHOME%\d2g\zip, where it will be available for future reference.
  2. In subdirectory %OMSYSHOME%\d2g\usersguide, extract all files from UGDITA2Go_OH.zip. This is the DITA2Go User's Guide, OmniHelp edition.
  3. On your desktop, create a shortcut to:

    %OMSYSHOME%\common\bin\d2gpm.exe

    This gives you double-click access to the DITA2Go Project Manager, which you will use to create, modify, and run DITA2Go conversion projects; see §2. Converting DITA documents.

  4. On your desktop, create a shortcut to:

    %OMSYSHOME%\d2g\usersguide\_ugdita2go.htm

    This gives you double-click access to the DITA2Go User's Guide, OmniHelp edition. You can download other editions from Omni Systems; see Availability.

Next: §1.3.4 Make Omni Systems executables accessible.

Previous Topic:  1.3.2 Download a DITA2Go distribution

Next Topic:  1.3.4 Make Omni Systems executables accessible

Parent Topic:  1.3 What you need to do

Sibling Topics:

1.3.1 Set up a framework for Omni Systems applications

1.3.2 Download a DITA2Go distribution

1.3.4 Make Omni Systems executables accessible

1.3.5 Check your DITA2Go installation

1.3.6 Obtain tools for Help systems or eBooks

1.3.7 Establish system-wide configuration settings

1.3.8 Obtain a file comparison tool (optional)

1.3.9 Download the DITA2Go User’s Guide (optional)

1.3.10 Integrate DITA2Go with <oXygen/> (optional)