New information
The DITA2Go User's Guide
is a perpetual work-in-progress, largely unreviewed.This section identifies
substantive additions and corrections since prior editions. Corrections
are shown in red.
May
15, 2013 version 1.2, update 4
Editing configuration files:
Setting basic conversion options:
- One
setting for output file extension. Use [Setup]FileSuffix
for all output types; see §4.1.6 Checking
output type and file extension. Though still recognized, the
following are deprecated in favor of [Setup]FileSuffix,
which overrides them in any event:
WordperfectSuffix
WordSuffix
XMLSuffix
HTMLSuffix
- Turn
off warnings about undefined formats. New setting ShowUndefinedFormats,
on by default; see §4.2 Logging
conversion events.
Configuring output formats:
Configuring format components:
- Stream
numbers have changed for figures, tables, and equations. If you number
figures, tables, or equations, and you use other than the default subformat
definitions supplied in system configuration files, you must change your
subformat definitions so that figures use stream number 8, tables use
stream number 9, and equations use stream number 10; see §8.5.2 Defining
number streams.
Generating lists and
indexes:
- You
get lists, like it or not, as per DITA spec. DITA2Go is required
to output whatever booklist components are present in your bookmap; see
§14.1 Understanding
how DITA2Go produces lists.
- Generate
and configure a glossary. New settings GenerateGLS,
GLSFile,
GLSSuffix,
GLSTitle,
GLSFormat,
GlossaryItem,
GLSTitleFormat,
GLSXrefFormat,
ResetAbbrevAt,
UseAbbrevInTitles;
see §14.7 Producing
a glossary.
- Specify
IDXTitle
in a language configuration file (correction). This
setting belongs in section [IndexText],
not in [Index]; see
§14.8.1 Specifying
output formats for the index.
- RTF
indexes now have active links. DITA2Go uses a new method that
does not involve creating the Word INDEX field.
The following settings, which have no reasonable equivalents in the new
system, are deprecated: IndexStyle,
IndexLeader,
and IndexColumns;
see §14.8.4 Configuring
index references.
- Override
default formats for index entries and references. New sections IndexEntryFormats
and IndexRefParaFormats;
see §14.8.2
Overriding formats for index entries and references.
- Configure
see and see-also entries for
variant indexes. New [IndexSeeText]
settings SeeStartListIndex
and SeeAlsoStartListIndex,
new [IndexSeeFormats]
settings IndexSeeListStart
and IndexSeeAlsoListStart;
see §14.8.3 Configuring
see and see-also index entries.
- Configure
index references. New settings UseCompactForm,
FullIndexRanges,
IndexRefSep,
and IndexRangeSep;
see §14.8.4 Configuring
index references.
- Configure
index alphabetic headings and links. New settings IndexLettersFormat
and IndexTopLettersFormat;
see §14.8.5
Including heading letters in the index.
- Toss
[HTMLOptions]UseIndex.
This setting is no longer needed for a non-Help HTML index, which will
be built if you include <indexlist>
in your map; see §14.8.6 Configuring
index features for HTML output.
- Generate
multiple variants of the same booklist type. New sections [BookLists],
[*BList], [*BLItems],
[*BLForms],
[*BLRefForms],
[IndexClasses],
[IndexLists];
see §14.9
Configuring variant booklist components.
- Provide
outputclass via PI for indexterms. If your bookmap contains more
than one indexlist; see§14.9.5
Mapping indexterms to variant indexes.
Producing on-line Help:
Generating Microsoft
HTML Help:
Generating OmniHelp:
Converting to DITA XML:
Creating HTML links
:
- Tell
DITA2Go to leave link text case alone. Although its internal
default value is No, MakeFileHrefsLower
is set to Yes in system
file d2htm_config.ini,
which is referenced for every HTML output type. If you want DITA2Go
to leave case alone in hypertext links, you must explicitly set MakeFileHrefsLower
to No in a project
or local configuration file; see §28.2.6
Forcing link text to lowercase.
Mapping text formats
to HTML/XML:
Including graphics in
HTML:
Converting tables to
HTML:
Working with macros:
Working with processing
instructions :
August 21, 2012 update 03
Generating Microsoft
HTML Help:
Converting to HTML/XHTML:
Setting up CSS for HTML:
Converting tables to
HTML:
May 1, 2012, version 4.0, update 54
Editing configuration files:
Mapping elements to output
formats:
Configuring format components:
- Include
page numbers, text, and spaces in cross-reference formats. Previously
undocumented building blocks; see Table 8-5.
Specifying conditional processing:
Including content by reference:
Defining element sets and properties:
- Assign
element type properties to class attributes. Not just to element
names; see:
- New
element type properties: CascadeSet,
CascadeItem,
Draft,
Abbrev,
NoLevel,
NoNumber,
Task,
BookTitle,
PList,
PLEntry,
PLTerm,
PLDef,
Navtitle,
Reference,
Glossary,
and Trademark;
see:
Generating lists and
indexes:
Converting to print RTF:
Producing on-line Help:
Generating Microsoft
HTML Help:
Converting to HTML/XHTML:
Splitting and extracting files:
Setting up CSS for HTML:
Including graphics in
HTML:
Converting tables to
HTML:
Automating DITA2Go
conversions:
Producing deliverable
results:
Previous Topic:
Availability
Next Topic:
Colophon
Parent Topic:
About this guide
Sibling Topics:
Availability
Colophon
Table of Contents • Index