Edit online

Creating a New DITA Topic

The basic building block for DITA information is the DITA topic. DITA provides a variety of specialized topic types, the most common of which are:
  • Topic - The base topic type from which all other topic types are specialized. Typically, it is used when a more specialized topic type is inappropriate.
  • Task - For procedural information such as how to use a dialog box.
  • Concept - For general, conceptual information such as a description of a product or feature.
  • Reference - For reference information.

Oxygen XML also supports numerous other specialized topic types that you will find templates for in the various folders in the New DITA file dialog box. They include DITA 1.3 specializations, Lightweight DITA templates, MathML composites, Markdown documents, and other DITA specialized topic and DITA map types such as Glossentry, Troubleshooting, Questions and Answers, Bookmap, and Subject Scheme Map.

To create a new DITA topic and add a reference to it in your DITA map, follow these steps:

Creating a New DITA Topic Using the New File Wizard

The New DITA file dialog box allows you to create a new DITA topic using various types of DITA file templates and provides some options that help you to configure the new topic.

Figure 1. New DITA File Dialog Box
Figure 2. New DITA File Dialog Box
Note:
The templates that appear in this dialog box include all templates that have an associated .properties file and the type property is set to dita, as well as templates that do not have an associated properties file or the type property is not defined. It will also include custom templates that you create using the procedures presented in Creating New Document Templates.

The New DITA file dialog box includes the following features and options:

Choose a file template
Use the template preview pane to select the appropriate type of DITA file you want to create. Once you select a template, the other options will appear below the preview pane.
Tip:
You can use the text filter field at the top of the dialog box to search for a specific template.
Title
Depending on the selected file template, the value of the Title field is set in:
  • The <title> element of a DITA topic file. The <title> element needs to be the first child of the root element.
  • The <glossterm> element of a Glossentry file.
New Topics Preferences
Pressing this button opens the DITA New Topics preference page.
Save as
Use this option to specify a file name and path for the new file.
Create
When you click this button, a reference (<topicref>) to the new topic is added to the current DITA map and the new topic is opened in the editor.

Other Ways to Create a New DITA Topic

In addition to the methods described above, Oxygen XML also provides other ways to create DITA topics, including the following:
  • Fast Create Topics - You can use the Fast Create Topics feature to quickly create multiple skeleton topics at once and you can specify their hierarchical structure within the DITA map.
  • Extract Topic From Selection - When editing a DITA topic in Author mode, an Extract Topic From Selection action is available in the contextual menu (and the DITA menu). It creates a new DITA topic from a selection of content in the current topic.