Archive - Sep 2007

Date

Do I see HTML-like elements in the DITA materials?

Yes. Many writers have had at least some experience with HTML as a markup language. The base DITA declarations (DTD and XML Schema) incorporate a number of familiar, general HTML element names. Through specialization, these can always be extended into more specific forms. Generally, XSLT-based transformations from well-formed XHTML into DITA provides faster and more reliable migrations from HTML than copy/paste, although a skilled writer might be able to do so for small portions of content.

What is specialization?

Specialization is the process of creating new categories of topics, or information types, as well as new categories of elements, or domain types. You can define these new types using the existing ones as a base. For example, a product group might identify three main types of reference topic - messages, utilities, and APIs - and define three domains - networking, programming, and databases.

Read more

Why information types?

With information types, you can divide topics into categories that you can manage and keep consistent more easily than without information types. Information types also make it easier for users to find the information that they are looking for: how-to information in a task versus background information in a concept versus detailed specifications in a reference topic.

What is an information type?

An information type describes a category of topics, such as concepts, tasks, or reference. Typically, different information types support different kinds of content. For example, a task typically has a set of steps, whereas a reference topic has a set of customary sections, such as syntax, properties, and usage.

Can topics be nested?

Topics can be nested to create larger document structures. However, the nesting always occurs outside the content boundary, so that child and parent topics can be easily separated and reused in different contexts. Here is a sample nesting structure: <topic>
<title>A general topic</title>
<shortdesc>This general topic is pretty general.</shortdesc>
<body><p>General topics are not very specific. They are useful for
the big picture, but they don't get into details in the same way as

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