Topic markup

About DITA elements used only in topic contexts.

DITA_Finch-100x46

The linkinfo element

One of the elements that is unique to the linklist structure is also one of the least understood: the linkinfo element. The DITA 1.2 Spec itself merely says that it lets you “place a descriptive paragraph after the links that are contained in a linklist element.” But a linklist already allows the title and desc elements to provide description, so how does this element add anything more to the design? Naturally, there is something more to this story, something we can trace from the foundations of human culture, as it were.  (more…)

DITA_Finch-100x46

The link element

“It’s 10 P.M.. Do you know where your children are?” This public service announcement has rung out on American airwaves since the late 1960s, reminding parents of their accountability for childrens’ whereabouts. Likewise, DITA’s link element helps keep track of child and peer topic relationships in the neighborhood where you are reading. Sort of like the Den Mother checking off each boy’s name at the weekly Cub Scout meetings I used to attend (which all of us present responded to by saying, ever so cleverly, “President!”). (more…)

DITA_Finch-100x46

The related-links element

If three-fourths of the Earth’s surface is water, why is it still so easy for me to lose things in that correspondingly smaller amount of land? It seems like I’m always looking for misplaced things. If all those lost things just had a proper storage place, and I knew where that was, it would be so much easier to account for all my gear–especially missing car keys! (more…)

DITA_Finch-100x46

The body element

To what can we compare the body element in DITA? It’s not fluff, as in “hair with body.” There’s no inertia as in Newton’s First Law of Motion, “a body in motion tends to stay in motion.”  There’s no official entity as in a corporate body. But it is a collection of information, as in “a body of evidence.” And that thought image leads to some interesting explorations. (more…)

DITA_Finch-100x46

The searchtitle element

You know the feeling: after a busy afternoon of researching and bookmarking the documentation for a product you just bought, you go back to look for the particular link you logged about installing on weekends. But all the bookmark titles just say “Installing FooFram” with no other clue about that weekend issue. Whoever wrote those chapters needed searchtitle for the web version of that document! (more…)

1 2