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