DITA, DTDs, FrameMaker, and other tools
A couple of people have asked lately what the difference is between a DTD and DITA, and in one case FrameMaker vs XML, so I thought the topic of schemas was worth discussion. Here, we’ll cover what a DTD really means, how to compare it to a DITA schema, and figure out where an authoring tool like FrameMaker fits in the picture.
On the scale of big-picture vs small-picture comparisons, the scale is:
- First: structured and unstructured content
- Second: DTD and DITA
- Third: FrameMaker and other authoring tools
We’ll start in the middle, with DTDs and DITA, and in future posts, discuss the first and third comparisons.
DTD and DITA
DTD stands for Document Type Definition. This is actually a misnomer, because the DTD doesn’t define the document type, it defines the document’s structure, so should be called Document Structure Definition. This file, which works in the background, enforces the structure of a document.
For example, you decide that a procedure in a User Guide has 1 heading, followed by 1 paragraph, followed by numbered steps, which could each contain a table, note, or graphic. Your DTD would enforce this standard by limiting the options that an author could choose at any given point.
Similarly, DITA is a Topic Structure Definition. Because DITA is topic-based, not document-based, this file enforces the structure of each topic. DITA comes with four topic types, and can be specialized as needed.
An easy way to explain DITA is to compare it to online help. If you were to learn how to write online help from a theoretical point of view, you would learn about writing concept topics, task topics, and reference topics, and how to link between them. These would be structured into a TOC. These are the exact topics in DITA: task, topic reference, plus a catch-all “generic” topic. And in the DITA vocabulary, a TOC is a DITA map.
Next post: Structured vs unstructured content
Comments
Leave a Reply
Recent Posts
- Setting a context for a content strategy vocabulary
- Toward a common content strategy vocabulary
- The added value of content through curation
- Public-sector content, web development and content strategy, and career cautions for writers
- The ROI of content
- Is it time for a content strategy maturity model?
- Getting ROI by Using Lean in Content Production
- Defining Content in the Age of Technology
- Turning Copy into Content
- Copy and content: a tale of two realities
Categories
Tags
accessibility ann rockley career development CMS content as asset Content convergence content lifecycle Content management content strategy convergence deliverables DITA Duo Consulting experience design Flash integration intelligent content interaction design Management marketing mentors open standards plain language politics processes Professional development ROI search section 508 services single-sourcing Social media STC structured content syndication taxonomy TechCraft translation Twitter usability user-centered design user-generated content User experience value XMLPopular
- Using topic-based writing to meet aggressive deadlines
- Content strategy and the new face of documentation
- A practical definition of content
- Flash pages, skip intros, and other annoying content
- Why social media seems easy but is (evidently) harder than it looks
- Abilities and aptitudes for a content strategist
- Content strategy includes convergence, integration, and syndication
- Redefining content strategy
- Strategies for adopting structured content
- CMS selection practices need maturation
Random Posts
- Should have mentioned Chicago: #contentstrategy Fits: Connecting the Dots between Business, Brand, and Benefits at the http://t.co/9jEu3J9b 5 hrs ago
- Also playing in Chicago: Content Strategy Fits: Connecting the Dots between Business, Brand, and Benefits at the... http://t.co/9jEu3J9b 6 hrs ago
- Two presentations coming up at the STC Summit: Changing the Face of a City: How Content Strategy is helping the... http://t.co/kIZBkPDU 6 hrs ago
- The Bailie Daily is out! http://t.co/8Cfucuyt ▸ Top stories today via @confab2012 16 hrs ago
- More updates...












Latest Tweets
RSS feed
Twitter