Archive - Sep 13, 2007

Date

Why use maps?

Maps separate the context of your information deliverable from its content. In a typical HTML-based web site, any change to the appearance or navigation of the site typically means making updates to dozens or more individual HTML pages. DITA enables all the navigation (sequences, hierarchies, relationtions) to be managed from a DITA map, which allows authors to manage navigation from a single structure, and then generate new web pages as needed.

What is a DITA map?

Maps let you organize topics that you want to build into an output web or PDF. You can also generate navigation files based on the map structure, and generate links that get added to the topics.

A map file references one or more DITA topic files using <topicref> elements. The <topicref> elements can be nested to reflect the desired hierarchical relationships of the topics. Map files need to have a file extension of .ditamap to be processed properly.

Read more

Does DITA provide both schemas and DTDs?

The basic concepts of DITA are not tied to implementation. Both schemas and DTDs can be used to define specializable DITA elements. The current DITA Open Toolkit provides both DTDs and XML Schemas.

How does DITA differ from DocBook?

It's important to recognize that DocBook and DITA take fundamentally different approaches.

Read more

Where can I learn more about topic-oriented writing and user assistance?

The DITA FAQs provide additional information about topic oriented writing. The following sites also provide background on information architecture principles inherent in DITA:

  1. Minimalism (John Carroll)
  2. DITA: An XML-based Technical Documentation Authoring and Publishing Architecture
  3. Read more

XML.org Focus Areas: BPEL | DITA | ebXML | IDtrust | OpenDocument | SAML | UBL | UDDI
OASIS sites: OASIS | Cover Pages | XML.org | AMQP | CGM Open | eGov | Emergency | IDtrust | LegalXML | Open CSA | OSLC | WS-I