adaptive content

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

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

The navtitle element

A navtitle, in DITAspeak, is a shorter version of a longer, actual topic title that can be displayed in navigation menus or other contexts where a more succinct version is preferred. In fact, any application that publishes adaptive content can make use of this version of the title in place of the main title for summary views of the topic such as in a sidebar blurb or for progressive disclosure in a responsive theme. (more…)