DITA_Finch-100x46

The topicref element

A wallet stuffed with credit cards, gift cards, library cards.
Andrew Huff / Foter / CC BY-NC

Among the cards you carry with you daily, you are likely to have credit cards, loyalty cards, insurance and library cards, and more. Each one is associated by your name or other identifier to a member profile in a database. Besides your unique identifier, each profile of yours also records your level or role of membership in a group, your address, possibly some value or role that you represent to the respective group, among other data. A profile is a unique member record that describes how you relate to other members and to the group itself. You are a resource, and the profile is your resource description. And like a profile, a topicref is also a resource description. What kind of resource? Well, don’t let the name fool you. Topicref is DITA’s most versatile element!
(more…)

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…)

Water adapting to various "devices"

Why DITA, especially “for the Web?”

Anyone can put their ideas on the Internet, but not everyone does it well. That’s because effective publishing must negotiate between conflicting strategies. On one hand, there’s the desire to push the most information to the most people in the most formats in the most languages. That’s a nice goal, but can you provide the right information in the right format in the right language to the right person at the right time?  Content that is personalized, easily found, appropriately scoped, and pleasant to interact with has a name: Adaptive Content. (more…)

What is “DITA for the Web?”

“Does Don Day know about DITA?” That’s a skills endorsement question that is likely to pop up if you visit my profile page at the business-oriented social service, LinkedIn.  Beyond that quixotic thought, consider the more important question: “What does Don Day think about DITA?” In fact, what I can tell you about DITA may help you understand this XML markup standard in a much different way than you may have expected. (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…)

1 2 3