dita-tools

This project is maintained by greenelk

dita-tools Build Status

The DITA Tools Eclipse plugin provides some useful facilities for DITA authors and editors. To perform the available actions:

Quick start

Link to the plugin download, installation and build instructions can be found on the dita-tools wiki

Checking tools

Where Used Checker

The selected dita/jpg/gif/png files files are checked to see if they are referred to by any other file in the workspace. Informational, Warning, and Error markers are created and may be viewed in the Problem view.

The default is to scan ditamap, dita, htm and html filetypes, though this may be configured through the Preferences page. Note: As this needs to cross-reference the entire workspace it may take some time to complete, even if you've only selected a single file to check.

HREF Checker

Selected resources are scanned and an attempt is made to resolve all href attributes. Check is also made that a title exists for scope="peer" references. Informational, Warning, and Error markers are created and may be viewed in the Problem view. The default is to scan ditamap, dita, htm and html filetypes, though this may be configured through the Preferences page.

CONREF Checker

Selected resources are scanned and an attempt is made to resolve all conref attributes. Informational, Warning, and Error markers are created and may be viewed in the Problem view. Only dita files are scanned.

Source <-> web mapping

Tools that provide mapping between source files and their web equivalents.

Source file finder

If you are looking at your documentation on-line and you want to find where source for the web page, or image, is located in your workspace, just.

DITA Web file finder

Right click on one or more dita, htm, or html files in your source tree and look for the "DITA Web File Finder" action. After the preferences are set, it will open up the equivalent file on a site it's been published to. You just have to supply one, or more, URL prefixes so the action knows how to construct the full URL. Examples of URL prefixes are:

Clicking on this action will open up 3 web browser tabs with views on the respective webpages.

WebFileFinder