New in this documentation release

Build 4.1.9 updates

Build 4.1.7 updates

  • Added the procedure to Branch conrefs.
  • Documented how topics can be branched across multiple maps within the same branch. See About branching for more information.
  • Added more information to the Taxonomy chapter. See Taxonomies for more information.
  • Provided more information about the Notify field in procedure Create a Build Manifest.

Build 4.1.6 updates

DITA CMS 4.1 updates

  • You can now create a Build Manifest, which is a DITA CMS object that allows you to configure a list of different outputs for a map.
  • DITA CMS 4.1 introduces a new and improved version of the concurrent localization manager. See Localizing documents with the DITA CMS for more information.
  • You can now import external documents into the DITA CMS and mark them as read-only. See Importing content as read-only for more information.

Build 4.0.8 update

DITA CMS 4.0 updates

  • The following terminology has changed in this release of the DITA CMS:
    • The term Content Store is now used to represent a docbase.
    • The Postmaster is now called the Scheduler.
  • You can now create snapshots of your working maps. A snapshot is a DITA CMS object that captures a map at a particular point in time. You can use this snapshot to rebuild the map and the objects that it contains exactly as they were when the snapshot was created.
  • You can search the Content Store more easily thanks to Search view enhancements.
  • The DITA CMS now provides the Referable-Content view, which lets you search for reusable components and insert them into documents.
  • You can now reuse a previously entered comment when you release a document or change its status.
  • If you are using a bug tracking system (such as JIRA or Bugzilla), you can add the bug number that you are fixing when you release a document.
  • The DITA CMS provides the Information view, which displays information about an object selected in any DITA CMS view (such as the Search Results and DITA Map views).
  • The DITA CMS now provides a Spellchecker view with additional functionality.
  • You can now configure the Generate output command to automatically open the output folder and unzip the output file when the transformation is completed.
  • You can now preview the contents of a map.
  • Other minor enhancements:
    • Removed support for resource package map template.
    • In previous releases, you could not sort the results in views based on columns that included multiple entries (such as Labels, Versions, etc.). You can now sort results alphabetically by clicking any column header.

    • The Search for panel of the Search view now includes a Clear button.

    • In the Search Results view, you can now jump to a specific page number.
    • In previous releases, when trying to perform a search and replace operation on files that could not be locked, the DITA CMS skipped the files without warning users. A warning is now displayed.
    • When you clicked the Set Conditions button in the DITA map view and the map was not locked, no error message was displayed. The DITA CMS now displays a warning indicating that the user should lock the map.
    • A warning is now displayed when trying to delete a search that is shared by multiple users.
    • You can now apply a label when creating and cloning DITA CMS objects (maps, topics, images, and resources).

March 13, 2014 updates

Build 90 update

Build 82 update

Build 72 update

Build 60 update

Build 51 updates

  • Isolate appended search results—When you append search results or when you locate documents using the Locate button, the search results are stored in separate lists. You can now isolate results, so that you may work with the results of only one of the searches.
  • Adding topics to a reltable—You can now add topics to a reltable from the Search Results view.
  • Adding a topic and its children to a reltable—You can add a topic and all its children to a reltable in a single drag-and-drop operation.
  • How topic titles are displayed in the DITA Map view—The topic title displayed in the map may come from different sources, such as the <title> element or <navtitle> element or attribute, depending on how the topic is defined in the map. This topic describes how the DITA CMS determines the titles to display in a map.
  • Import improvements—The Update Existing Documents feature when importing documents is now complete and available.

Post 3.4

  • Creating resources from folders—You can now import either a single resource file or a folder. When you import a folder, all of its files and subfolders are also imported and the folder structure is kept in the resource object.
  • Creating soft links—Soft links create a dependency from a binary object to a DITA object. This can be used, for example, to indicate that an image is used in both a DITA CMS map and legacy documentation stored in a resource.
  • Locking images and resources—You can now lock images or resources directly from the Show/Edit dialog.
  • Exporting images—You may want to export images to edit them locally and then reimport them into the DITA CMS. This can be useful when you are working remotely, and the DITA CMS is installed on a server that does not have the proper image editing tools.
  • Editing the XML contents of a Ditaval file—You can now view and edit the XML contents of a Ditaval file directly from the DITA CMS. You can also export the contents of a Ditaval file.
  • Validate out-of-scope links—The Validate Links command detects any out-of-scope links, that is, links that point to documents that are not in the current map.
The following changes were also made to this document:
  • Removed documentation about DITA CMS variables—In DITA 1.2, support was added for keyrefs, to allow users to define variable words or phrases to be added to a map. Keyrefs replace the need for map and text variables, so this documentation for variables (textvars) was removed from the User Guide.
  • The Formatted cycle is being discontinued and has been removed from the documentation.
  • Miscellaneous edits and improvements.


  • Keyrefs and keydefs—DITA CMS now offers utilities for managing keydef and keyref functionality.
  • Spell check—You can now check spelling of selected documents in any stage of the Authoring cycle, without even opening them.
  • New document-specific toolbar options—You can now perform many DITA CMS operations such as lock and release on the document that's currently open in the editor area.
  • Extended conditional support—Enhancements make it easier to manage conditional maps and topics:
  • Taxonomy support—This feature helps you manage sophisticated keyword structures.
  • Obligatory comments—DITA CMS may now be configured so that users cannot perform actions such as release or change status without entering comments.
  • Create sub-maps—You now have the option of creating a new map as a sub-map of the current map, if you have a map open and locked in the DITA Map view.
  • Export map as tsv—You can export the map structure and save it in a format (Tab Separated Values) that can be easily imported into other programs, such as a spreadsheet.
  • Export children intersection—This utility lets you determine which documents are shared by a selected set of maps.
  • Export Dependencies as TSV—This utility exports the contents of the Dependencies view as a TSV file.
  • Switch editors—Once a document is open in the editor area, you can switch between editors using a button on the toolbar.
  • Show only latest—Lets you filter search results for the most recent versions of published and localized documents.
  • Enhanced output generator options—The Output Generator now offers many different configurable options. See Output Generator.
  • Redline compare—You can now globally compare the text of a map with its previously published versions.
  • Electronic signature—Collaborative Reviewer now includes electronic signature functionality.
  • Word XML extension—An extension is now available for Microsoft Word, that lets writers produce DITA-compliant content in a familiar environment without having to worry about XML syntax.

  • Locate errors—Many error message and warning dialogs now let you locate the implicated files in Search Results.
  • Suppress warning messages—Warning dialogs now have a checkbox—"Don't ask again"—that you can select if you don't want the dialog to appear in future. You have the option of restoring any of these messages, if you want.
  • Configure search view—You can now hide the panels you infrequently use, and arrange the order of the ones that appear.
  • Group search results—The grouping feature now lets you select the grouping criteria and its hierarchy, instead of offering a pre-configured list.
  • Documents view—This new view now contains the Recent Operations display. It also lets you designate your favorite documents and see the ones most recently used.
  • Configure column display—Select exactly the columns you want to see in each view, and then drag them into the order that you prefer.
  • Topic thumbnails—Hover over topics in most views to preview the topic.
  • Preview topics templates—The create topic dialog now includes a preview pane, so that you can see how the template you select will display.
  • Template folders for maps and topics—If your system has a large number of available templates for creating topics and map, they may be organized into folders by category.
  • Support for conditional text in topic preview—An additional pane now appears when the current topic contains conditional text.
  • Work offline—You can now continue work on topics when you are not connected to the document base. Your work will be returned to the server when you reconnect.
  • Refresh annotations—You can now see when another reviewer has added new annotations to a document you're reviewing, and you can request them from the server.
  • Archive published maps—Infrequently used maps may now be archived, so that they no longer show up in searches.
  • Default resource item—You can now designate a specific file within a resource as the default item.
  • Topic remove warning—A dialog now warns you when you are about to remove a topic (and all its children) from a map.
  • Additional shortcut keys for DITA Map view—You can now navigate from branch to branch and toggle the current branch open and shut with keyboard shortcuts.
  • Relationship table examples—Several examples of reltable usage and construction have been added to the documentation.

  • Map
    • Statistics display—You can now view a graphical summary of the status of the various documents in a map.
    • Shortcut keys for:
      • Undo and redo operations
      • Promote and demote operations
  • Projects
    • Statistics display—You can now view a graphical summary of the status of the various documents in a project.
    • Project-wide milestone support—Milestones may now be configured for the project as a whole, as well as for specific maps.
    • Email formatted maps to team members.
    • Multiple coordinators allowed on each project.
    • View and open formatted documents—Project display now includes formatted versions of the maps included in the project.
    • View and open published documents—Published versions of the project's maps are available in the tree display.
  • Localization
    • Show only latest—Searches of the Localization cycle now display only the most recent version of a specific document.
    • No impact on translation flag (Substantial Change Flag)—Optional flag allows documents with minor changes to skip review states.
    • XML International TM (Translation Memory) integration.
  • Import of multiple resolution images—The Import Images wizard offers you a way to bulk import images – and all their different resolutions – into the repository.
  • Orphan Search—The search feature now lets you search for topics which are not used in any map.
  • Warning for unreleased topics before output generation—A warning message appears if you are generating output from a map which has unreleased topics in it.
  • Restore deleted documents—You can search for deleted documents and restore them to the cycle from which they were deleted.
  • List affected documents before status change—When you change any document's status, you'll see a warning message if other documents' status will be affected.
  • Locate documents responsible for error states—A list of the responsible documents is now included in status impact dialog, out of scope error messages, etc.
  • Web Collaborative Reviewer—A web-based version of the Collaborative Reviewer allows users to access just the reviewing functionality of DITA CMS, without having to install Eclipse.
  • New DITA CMS Admin Tool—A new interface now lets you make changes to the configuration files without bothering about the details of XML syntax.
  • Substantial Change Flag—Optional flag allows documents with minor changes to skip review states.