Dismiss
InnovationQ will be updated on Sunday, Oct. 22, from 10am ET - noon. You may experience brief service interruptions during that time.
Browse Prior Art Database

Integrated Editor for DITA Topics and Ditamaps

IP.com Disclosure Number: IPCOM000239197D
Publication Date: 2014-Oct-20
Document File: 4 page(s) / 82K

Publishing Venue

The IP.com Prior Art Database

Abstract

Darwin Information Typing Architecture (DITA) reltables are useful for modeling links among DITA topics, but even experienced information developers have trouble seeing intuitively what links the file specifies. The only way to see for certain what links the file will create is to run a build and look at the individual output files to see which files are linked to which other files. A much better way to work with reltables is to process the current state of the reltable and show what links it will create. This processing can be done in real time with the simple rules of ditamap linking. A DITA reltable editor can integrate this tabulated information with a view of the reltable itself, which provides a complete picture of the effects of the reltable on the DITA content.

This text was extracted from a PDF file.
This is the abbreviated version, containing approximately 51% of the total text.

Page 01 of 4

Integrated Editor for DITA Topics and Ditamaps

Darwin Information Typing Architecture (DITA) reltables are useful for modeling links among DITA topics, but even experienced information developers have trouble seeing intuitively what links the file specifies. The only way to see for certain what links the file will create is to run a build and look at the individual output files to see which files are linked to which other files. A much better way to work with reltables is to process the current state of the reltable and show what links it will create. This processing can be done in real time with the simple rules of ditamap linking. A DITA reltable editor can integrate this tabulated information with a view of the reltable itself, which provides a complete picture of the effects of the reltable on the DITA content.

A typical reltable editor shows only the organization of the table itself, in columns and rows. Placing a topic in the table causes it to be linked to other topics according to DITA rules. For example, a topic in cell 1 of a given row is automatically linked to a topic in cell 2 of the same row. However, a topic in a cell is not linked to topics in the same cell, unless certain overrides are added to the table. Because the proximity of one topic to another in the table does not necessarily indicate that the files are linked, it's difficult to see the links that the file specifies.

Similarly, a single topic can be in many places in a reltable, and thus the file can have many links. Most DITA tools are smart enough to not create duplicate links if the file is in multiple places, but this added complexity makes it even more difficult to see the links that the file specifies. Thus, the typical reltable editor does not answer...