2.5 Running a DITA2Go
conversion
Once you have created a conversion project with the
DITA2Go Project Manager (see §2.1 Creating
a DITA2Go conversion project), you can use
the DITA2Go Project Manager to execute the conversion. However,
you can also run DITA2Go from a command line; see §2.7 Converting
documents from the command line.
To operate DITA2Go with the Project Manager:
- On the Run Project tab, select
the conversion project you wish to run. The DITA2Go Project Manager
shows the DITA source directory, map file, and output directory, and
the output type. You can browse to a different map file, perhaps to convert
just a subset of your DITA document. The Project Manager also sets run
options based on current settings in the starting project configuration
file.
- On the Run Options tab, specify
any post-conversion steps you need for the current run, or turn off those
you do not need. With appropriate settings in place (see §1.3.7 Establish
system-wide configuration settings), DITA2Go can produce
a ready-to-distribute archive of your completed conversion, and place
the archive in the shipping directory.
Note: If you choose Run only
automation tasks, you must have the bookmap or ditamap in place in
the output directory, even though it is not needed for these tasks.
- On the Run Project tab, click
Start. When the conversion is complete, you will see a message
to that effect in the Results: field. If you chose run option
Wrap and Ship, for some output types the View Output button
is enabled by default. For other output types you will have to provide
a view-output command to enable the button; see §1.3.7 Establish
system-wide configuration settings.
- Click Show Log File to see
an event log that shows what happened during conversion.
- Click View Output (if this
button is enabled) to see the conversion output. The View Output
button works nicely for XHTML, HTML, OmniHelp, HTML Help, and Word RTF
output. However, for JavaHelp, Oracle Help, and Eclipse Help, for the
Project Manager to be able to launch the viewer, you will need to add
appropriate commands to %OMSYSHOME%\common\local\config\local_omsys.ini.
See §1.3.7 Establish
system-wide configuration settings.
You can specify options to display a console window
while the conversion is running, and a log file when the conversion is
complete. See §2.6 Customizing
the DITA2Go Project Manager.
Previous Topic: 2.4 Inspecting
and editing configuration files
Next Topic: 2.6 Customizing
the DITA2Go Project Manager
Parent Topic: 2. Converting DITA documents
Sibling Topics:
2.1 Creating
a DITA2Go conversion project
2.2 Modifying
a DITA2Go conversion project
2.3 Configuring
default DITA2Go project settings
2.4 Inspecting
and editing configuration files
2.6 Customizing
the DITA2Go Project Manager
2.7 Converting
documents from the command line