1.3.10 Integrate DITA2Go with <oXygen/> (optional)

You can integrate DITA2Go with XML editor <oXygen/>, using external commands. You will need to set up a command for each output format you wish to produce,

  1. Use the DITA2Go Project Manager to set up a starting project configuration file in an appropriate output directory; see §2.1 Creating a DITA2Go conversion project. Use the recommended directory structure, with the output directory under the directory where your map is located.
  2. Start <oXygen/>.
  3. Go to Tools > External Tools > Preferences; select Global Options; Click New.
  4. Enter any name and description, leaving encoding at defaults; pick any shortcut key.
  5. For HTML output (for example), set Working Directory to:
    ${cfd}\html
    
  6. Set Command Line to:
    dcl -f html ..\${cfne}
    
  7. Click OK.

For other output formats, change the Working Directory name and the -f option from html to another format, such as rtf or omnihelp; see §2.7.2 Understanding how to run DITA2Go DCL.

To publish or transform your topic or map, select the map in the Editor, make sure the map is the active window, then use Tools > External Tools > YourCommand, and go. Or just use the toolbar button <oXygen/> creates for your command.

This procedure assumes you are using the recommended directory structure, with the output directory under the directory where your map is located. If you have a different directory structure, you will need to make some adjustments; see §2.7 Converting documents from the command line.

Previous Topic:  1.3.9 Download the DITA2Go User’s Guide (optional)

Next Topic:  1.4 How to update DITA2Go

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.3 Install DITA2Go

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)