Skip to main content
January 12, 2012

DITA reporting tools in oXygen

Need some basic metrics on your DITA files? Wondering whether your topics are the right length or not? Check out this new feature in oXygen version 13.

There’s a new DITA Map Metrics report in oXygen v13. It provides information about your map file, the size of the topics, the elements you used, and more.

To run the report, you use a transformation scenario, so you first open the map (and make sure you select the root element of the map or you get a partial report, which was a surprising “feature”), and then select Document > Transformation > Configure Transformation Scenario.

Select the DITA Map Metrics Report and then Transform Now.

An excerpt of the result is shown below:

The report will tell you which elements you are using, the average length of your topics, and much more. It’s extremely useful for evaluating the completeness of a DITA map. For example, if the report shows lots of short topics with only a few words, that would tell you that those topics are probably incomplete. Conveniently, the list of shortest topics is linked to the source files, so you can click on the link and see the file immediately to figure out what to do.

George Bina of oXygen showed me this report at tekom in October. My advice was to charge extra for it, but you’ll be pleased to know that he ignored me and included the report in the regular product.

The report itself is generated by an XSLT file that runs through the DITA Open Toolkit. You could modify the XSLT to create your own custom report or extend what’s there.

I anticipate using this report quite heavily over the next year as I work on a new book.