To cash a check or apply for a job, normally you validate your identity by opening up your pocketbook or wallet to show the various forms of identity you carry with you. The prolog in a DITA topic is like that wallet, holding the information that other applications might need to know about your topic. (more…)
The titlealts element
When you need more than just the regular title as the text for links to your topic, the name to call is titlealts!
Titlealts can push a shorter version of the title into your navigation when needed, and provide a more specific version of the title for search results. It’s like having your own personal butler, keeping your linked appearance spiffy in all situations. Read more about The Children of Titlealts in the upcoming sequels, navtitle and searchtitle. (more…)
The reltable element
For Valentine’s Day, what could be more appropriate than a tryst with DITA’s relationship table? It was suggested to me that “Like real relationships, they are difficult to understand sometimes and even more difficult to build….” So let’s all hum “Getting to know you, getting to know all about you” as we open this Valentine card. (more…)
The topic element
What does a DITA “topic” have in common with Dirty Harry’s .44 Magnum, “Peacekeeper?” Don’t dig too deeply for an answer. It’s just that in both cases, the names are descriptive euphemisms for something much more banal: guns and proses. (more…)
The title element
The <title> element in DITA is pervasive; you find it not only as the title for a map or topic but also as the title for figures, tables, linklists, and sections/examples (and less obviously in the data element, where it is available for various specializations of that metadata element). Topic titles are the only case in DITA in which the representation of the title might change as topics are nested; all other uses represent labels, and thus generally have consistent representation as bolded phrases rather than as heading elements. (more…)
The map element
You might think of a DITA map as the Swiss Army Knife of lists. When you do a search on the web, you get back a list of topics that match that query. When you sort business cards from a conference by company or job title, you are creating a hierarchical list of people by that category. Similarly, a DITA map is basically a list of resources that fits a particular reading sequence and hierarchy, possibly one of many depending on how the information was organized. (more…)
The dita element
Which element is not the most important element in DITA? Paradoxically, that would be the <dita> element. This element defines a container that can hold one or more DITA topics, but it has no formal meaning as a part of structured representation. You might use it to group several topics in a single file unit for ease of loading and working on in parallel, particularly when using file-based content in a word processor-based DITA editor such as FrameMaker or Simply XML or Quark XML Author. (more…)