Structured authoring using DITA

Structured authoring enforces structure to the authoring of documents. When you create a struc­tured document in FrameMaker, you are required to select a structured application on which you want to base the document. The structured application defines the structure and formatting rules that are enforced when creating your document. The Darwin Information Typing Architecture (DITA) is an open XML standard for structured authoring. When authoring in DITA, you can also use the DITA Open Toolkit for published output. See DITA Open Toolkit.

DITA Topics

DITA topics are the most granular units of DITA content. Each topic should be authored around a single subject of content. For details, see DITA topics.

See the specifications on DITA topics.

Information typing

Information typing is the practice of identifying types of topics that contain distinct kinds of information, such as concepts, tasks, and reference information. Topics that answer different kinds of questions can be categorized as different information types. The base topic types provided by DITA (a generic topic, plus concept, task, and reference) provide a usable starter set that can be adopted for immediate authoring. For details, see DITA topics.

See the specifications on Information typing.

DITA Maps

The DITA map is like a table of contents listing and linking the topics for a specific output. DITA maps assemble topics into sequence and hierarchy tailored to specific delivery require­ments. You can have multiple maps, each one arranging the topics for different requirements, such as a reference manual, a tutorial, or online Help. A DITA map file has the extension .ditamap.

For details, see DITA topics.

See the specifications on DITA maps.

Bookmaps

A bookmap is a specialization of a DITA map. You can save a DITA map as a bookmap. In a bookmap, highest-level topicref elements in your DITA map become chapters in the FrameMaker book, containing any nested topicref elements. Formatting is determined according to which structured application you have selected for books in the DITA Options dialog box. For details, see Bookmaps.

See the specifications on Bookmaps.


September 30, 2016

Legal Notices | Online Privacy Policy