Table of Contents
User Guide
Using the Topic Editor
Structured Authoring Environment
The Topic Editor is a structured authoring environment that enables you to edit topics.
Structured Authoring Environment
The Topic Editor is a structured authoring environment that enables you to edit topics.
Moving an Element Inside a Topic
Move elements in a topic to reorder them.
Moving an Element Inside a Topic
Move elements in a topic to reorder them.
Copying an Element in a Topic
Copy and paste an element in a topic to a new location in the topic or to a new topic.  
Copying an Element in a Topic
Copy and paste an element in a topic to a new location in the topic or to a new topic.  
Removing an Element in a Topic
Quickly remove all the content in an element by removing the element itself.
Removing an Element in a Topic
Quickly remove all the content in an element by removing the element itself.
Inserting a Menu Cascade
Insert a menu cascade to document a sequence of menu choices.
Inserting a Menu Cascade
Insert a menu cascade to document a sequence of menu choices.
Structured Authoring Environment

The Topic Editor is a structured authoring environment that enables you to edit topics.
The Topic Editor manages the structure of your DITA content as you work, ensuring that it remains valid at all times by preventing you from creating invalid content. The editor shows the currently selected DITA element in gray text to the left of the document.
When inserting an element, easyDITA will position it in the proper location in the DITA structure. Also, the drop down list for Inserting elements will only show elements that can be inserted at the current cursor location.

Likewise, when you remove elements, easyDITA will ask which element you want to remove. In the example below, you can remove the List Item, the Unordered List, or the Body of the DITA document. The flying arrow points to the element you are removing, and it is highlighted in red to confirm this is the element you want to remove.
You can inspect where you are in the DITA XML structure by hovering over the structure status bar at the bottom of the screen. In this example, the List Item is highlighted and the flying arrow connects the text to the structure status bar element.
You can edit DITA properties by clicking Properties in the right margin. This expands the Properties Pane. When you place the cursor in a property field to set an attribute, the arrow connects the attribute to the element in the document pane. In the example below, the Properties Pane displays properties for the selected paragraph.
Structured Authoring Environment

The Topic Editor is a structured authoring environment that enables you to edit topics.
The Topic Editor manages the structure of your DITA content as you work, ensuring that it remains valid at all times by preventing you from creating invalid content. The editor shows the currently selected DITA element in gray text to the left of the document.
When inserting an element, easyDITA will position it in the proper location in the DITA structure. Also, the drop down list for Inserting elements will only show elements that can be inserted at the current cursor location.

Likewise, when you remove elements, easyDITA will ask which element you want to remove. In the example below, you can remove the List Item, the Unordered List, or the Body of the DITA document. The flying arrow points to the element you are removing, and it is highlighted in red to confirm this is the element you want to remove.
You can inspect where you are in the DITA XML structure by hovering over the structure status bar at the bottom of the screen. In this example, the List Item is highlighted and the flying arrow connects the text to the structure status bar element.
You can edit DITA properties by clicking Properties in the right margin. This expands the Properties Pane. When you place the cursor in a property field to set an attribute, the arrow connects the attribute to the element in the document pane. In the example below, the Properties Pane displays properties for the selected paragraph.
Moving an Element Inside a Topic

Move elements in a topic to reorder them.
  1. In the Content Manager , open a topic and right-click the element you want to move.
  2. Select Move Up or Move Down .

    Expected Result
    Elements that are available to be moved display in the context menu.
  3. Select the element you want to move.
result
The element is moved to a new location in the topic.
Moving an Element Inside a Topic

Move elements in a topic to reorder them.
  1. In the Content Manager , open a topic and right-click the element you want to move.

    Expected Result
    A context menu displays.

  2. Select Move Up or Move Down .

    Expected Result
    Elements that are available to be moved display in the context menu.
  3. Select the element you want to move.
result
The element is moved to a new location in the topic.
Copying an Element in a Topic

Copy and paste an element in a topic to a new location in the topic or to a new topic.  
  1. In the Content Manager , open a topic and right-click anywhere in the element that you want to copy.

    Expected Result
    The context menu displays.

  2. Click Copy and select the element you want to copy to your clipboard.

    Step Information
    Note:Hover over an element in the context menu to highlight its location in the topic.
  3. In the same topic or in a new topic, right-click an element and select Paste .
result

You pasted your copied element to a new location.

Copying an Element in a Topic

Copy and paste an element in a topic to a new location in the topic or to a new topic.  
  1. In the Content Manager , open a topic and right-click anywhere in the element that you want to copy.

    Expected Result
    The context menu displays.

  2. Click Copy and select the element you want to copy to your clipboard.

    Step Information
    Note:Hover over an element in the context menu to highlight its location in the topic.

    Expected Result
    The context menu displays available elements to delete at the selected location.

  3. In the same topic or in a new topic, right-click an element and select Paste .
result

You pasted your copied element to a new location.

Removing an Element in a Topic

Quickly remove all the content in an element by removing the element itself.
  1. In the Content Manager , open a topic and place your cursor in the element you want to remove.
  2. Click the Remove Menu.

    Expected Result
    The elements that can be removed are listed.
    Note:Hover over an element in the context menu to highlight its location in the topic.
  3. Select the element you want to remove.
result

You remove the element from the topic.

Removing an Element in a Topic

Quickly remove all the content in an element by removing the element itself.
  1. In the Content Manager , open a topic and place your cursor in the element you want to remove.

    Expected Result
    Your cursor is in the element you want to remove.

  2. Click the Remove Menu.

    Expected Result
    The elements that can be removed are listed.
    Note:Hover over an element in the context menu to highlight its location in the topic.
  3. Select the element you want to remove.
result

You remove the element from the topic.

Inserting a Menu Cascade

Insert a menu cascade to document a sequence of menu choices.
  1. In the Content Manager , open a topic and place your cursor where you want to insert a Menu Cascade element.
  2. Click Insert -> Menu Cascade .

    Expected Result
    The UI Control element is inserted.
  3. With your cursor in the UI Control , click Insert -> UI Control .

    Expected Result
    An arrow and UI Control element are inserted.
result

You inserted a Menu Cascade element that contains two UI Control elements. Use UI Control to separate menu items.

Inserting a Menu Cascade

Insert a menu cascade to document a sequence of menu choices.
  1. In the Content Manager , open a topic and place your cursor where you want to insert a Menu Cascade element.
  2. Click Insert -> Menu Cascade .

    Expected Result
    The UI Control element is inserted.
  3. With your cursor in the UI Control , click Insert -> UI Control .

    Expected Result
    An arrow and UI Control element are inserted.
result

You inserted a Menu Cascade element that contains two UI Control elements. Use UI Control to separate menu items.