### 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.

#### August 21, 2012, update 03

Editing configuration files:

- Use relative path settings with care! Some path settings have changed their relativity, notably those listed in Table 3-1; see §3.4 Specifying file paths in configuration settings.

Setting basic conversion options:

- One setting for output file extension and cross references. 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

  XrefFileSuffix

  XMLSuffix

  HTMLSuffix

- Override, or produce the effect of, the @print attribute. New setting PrintProject, new PI marker Print; see §4.1.7 Producing print output selectively.
- Pop up current log file if conversion errors occur. New settings EditorFileName and HistoryFileName; see §4.2 Logging conversion events.

Mapping elements to output formats:

- Ignore outputclass attributes for border and shading properties. New setting OutputclassHasBorderShadeFormats; see §6.2 Specifying options for naming formats.
- Specify a default heading for <note> elements. The DITA2Go default is no heading; see §6.5.8 Understanding default attribute-based prefixes and headings.
- Designate a table row as a table footer row on output. New setting TableFooterClass; see §6.9 Specifying formats and options for tables.
- Give draft comments special formats; see §6.11 Specifying options for draft comments.

Configuring format components:

- Include page numbers, text, and spaces in cross-reference formats. Previously undocumented building blocks; see Table 8-5.

Specifying conditional processing:

- Limit the scope of keydefs to named map branches. New settings UseBranchKeydefs and KeydefsOnlyWithinBranch; see §9.6.6 Limiting the scope of keydefs by branch.
- Keyref named map branches. New PI marker type KeyrefBranch; see §9.6.7 Directing a key reference to the correct branch.

Including content by reference:

- Push to more places than specified for DITA 1.2. New push actions pushatstart and pushatend; see §10.1 Pushing and pulling content by reference.
- Include external code snippets. New PI marker types ExtCode*, plus support for RFC 5147 fragment identifiers; see §10.2 Referencing external code or text fragments.

Defining element sets and properties:

- Assign element type properties to class attributes. Not just to element names; see:
  - §11.2.3 Assigning properties to element types
  - §B. Element type default properties.
- New element type properties: CascadeSet, CascadeItem, Draft, Abbrev, NoLevel, NoNumber, Task, BookTitle, PList, PLEntry, PLTerm, PLDef, Navtitle, Reference, Glossary, and Trademark; see:
  - §11.2.2 Understanding what properties are available
  - §B. Element type default properties

Generating lists and indexes:

- Specify different suffixes for the base names of generated files. New settings TOCSuffix, LOFSuffix, LOTSuffix, and IDXSuffix; see §14.2 Naming generated HTML list and index files.
- Get navigation titles into the TOC. And set defaults to use if attributes are missing. New settings TopicheadsHaveNavtitles, LockAllNavtitles, UseAllInTOC; see §14.3 Generating a table of contents.

Converting to print RTF:

- Produce .doc or .docx files via Word macro. See §15.10.1 Supporting more than one version of Word.
- Double any backslashes in included RTF code. And double them again in a macro; see §15.8 Including RTF code for Word output.
- Remove unwanted empty paragraphs at end of topics. New setting FrameEndPara; see §15.4.4 Omitting content from RTF output.

Producing on-line Help:

- Choose plain or modified topic titles for TOC entries. New setting UseNavtitleMarkers; see §16.4.2 Including contents entries in HTML-based Help.
- Produce index meta elements for Microsoft Help Viewer. New setting UseHVIndex; see §16.5.2 Preparing index entries for Microsoft Help Viewer.

Generating Microsoft HTML Help:

- Omit code-page mapping for uncompiled HTML Help. New setting UseCodePage; see §18.3.5 Deciding whether to compile HTML Help.
- Exclude selected topics from FTS for HTML Help. An inelegant hack via @search or new PI marker Search; see §18.10 Providing full-text search (FTS) for HTML Help.
- Generate Asian or Cyrillic HTML Help. New code-page DLLs; see §18.12 Generating HTML Help in non-Western languages.
- Fixed spaces become ideographs for Japanese HTML Help. Or you can map them to something else; see §18.12 Generating HTML Help in non-Western languages.

Generating OmniHelp:

- Exclude content from full-text search. If no @search attributes in your topicrefs, use new PI marker Search; see §19.10.6 Excluding content from being searched.

Converting to HTML/XHTML:

- For ePub, XHTML output can provide input to Calibre. See §22.1 Deciding which type of output to produce.
- For HTML 5 output, set DOCTYPE as appropriate. See §22.4.1 Specifying HTML/XML version, DOCTYPE, and DTD.
- Prevent adjacent HTML <pre> elements from merging. New setting MergePre; see §22.6.4 Preventing adjacent <pre> elements from merging.
- Generate XHTML for Confluence 4.x. New settings Confluence, ConfluenceLinks, and ConfluenceLink*; see §22.9 Generating XHTML for Confluence 4.x.
- Change the View Output starting topic for HTML/XHTML. New setting ViewOutputFile; see §22.11 Specifying a starting topic for HTML or XHTML.

Splitting and extracting files:

- Insert space or a separator between HTML topics in a single output file. New [Inserts] keyword TopicBreak; see:

  §27.6.2 Assigning code to [Inserts] keywords for splits and extracts

  §37.9.2 Invoking macros at predetermined points in output.

Setting up CSS for HTML:

- Replace spaces in CSS class names with hyphens or underscores. Instead of only alphanumerics as a value for ClassSpaceChar; see §31.7.1 Understanding CSS class name restrictions.
- Omit element tags from CSS selectors. New setting SelectorIncludesTag; see §31.7.9 Omitting tags from CSS selectors.

Including graphics in HTML:

- Omit empty alt attribute values from HTML output. New setting AllowEmptyAlt; see §32.7 Providing (or omitting) alternate text for images.

Converting tables to HTML:

- HTML table rows are now wrapped in groups by default. Reversed setting HeadFootBodyTags; see §33.3.2.4 Wrapping table row groups.

Automating DITA2Go conversions:

- Execute system commands before and after conversion. New automation keywords SystemStartCommand, SystemWrapCommand, SystemEndCommand; see §43.1 Executing operating-system commands.

Producing deliverable results:

- Gather referenced graphics files for distribution. New setting CopyOriginalGraphics; see §44.7.1 Copying referenced graphics to a distribution directory.

Previous Topic: Availability

Next Topic: Colophon

Parent Topic: About this guide

Sibling Topics:

Availability

Colophon