2.7.2 Understanding
how to run DITA2Go DCL
To use dcl.exe to convert
DITA documents:
- Open
a Windows Command Prompt window.
- Navigate
to the output directory where your DITA2Go project configuration
file is located.
- Type
a command of the following form:
%dcl% -f output_format [-o
output_file] input_file
where:
output_format
|
can be one of the following:
HTML
XML
XHTML
HTMLHelp
JavaHelp
OracleHelp
EclipseHelp
OmniHelp
ASCII
DITA
DocBook
Word
WinHelp
|
output_file
|
is optional for RTF or HTML output (but
required for XML output); one of:
name - base
file name (path optional), with or without extension
ext - output
file-name extension, period required
|
input_file
|
path (absolute or relative) to your .ditamap, .bookmap, .dita, or .xml file, with
extension
|
- Press
Enter.
For example, at a command prompt:
D:\Tests\HTML> %dcl% -f html ..\DITATestSuite.ditamap
would produce HTML files in directory
HTML, from map
file DITATestSuite.ditamap
located in directory Tests.
If your input_file
has an extension other than .ditamap, .bookmap, .dita, or .xml, you must
include one more argument, before the -f switch:
-s xml
to tell dcl.exe what
type of file you are converting.
Although dcl.exe provides
the -o switch
for naming output location, file, or extension, typically you do not
need this switch. For topics, DITA provides a naming method for the output
files: the copy-to attribute.
If your DITA files do not use this attribute, the names of output files
are based on the topic id attribute.
If necessary, you can remap file names for HTML output; see §43.3
Renaming output files for automated systems.
Previous Topic:
2.7.1 Executing
the correct version of DCL
Next Topic:
2.7.3 Creating
a script to run DITA2Go DCL
Parent Topic:
2.7 Converting
documents from the command line
Sibling Topics:
2.7.1 Executing
the correct version of DCL
2.7.3 Creating
a script to run DITA2Go DCL
Table of Contents • Index