Gretyl's Portal

Heretto Help

Show Page Sections

Topic Elements Actions

Tag Modes

The Content Editor enables you to view topic elements in different tag modes. Tags help understand in which DITA elements your content is nested. This feature can help authors organize their content according to their DITA standards.

Tip:

In the Content Editor, you can switch between different tag modes by clicking the gear on the toolbar and using the Tags drop-down menu.

Table 1. Tags Menu Options
OptionDescriptionExample
Full Tags With AttributesDisplays the entire DITA element syntax, including any attributes. example of Full Tags With Attributes mode
Full TagsDisplays only the DITA element name.example of Full Tags mode
Short TagsDisplays a gray tag indicator wherever a DITA element occurs.example of Short Tags mode
No TagsTurns off all tags in the Content Editor.

Insert an Element in a Topic

You use the quick insert menu to insert elements into your content.

  1. In the Content Library, double-click a topic.
  2. In the Content Editor, place your cursor where you want to insert an element.
  3. Open the quick insert menu by doing one of the following:
    • Press Ctrl > Enter (Windows) or Cmd > Enter (Mac).
    • Click the plus icon on the left side of the Content Editor.
  4. In the quick insert menu, type an element name or scroll through the list of available elements.
    For detailed information on the DITA elements, see Oasis: Element quick reference.
  5. Insert an element by doing one of the following:
    • Click the element.
    • By pressing the Up arrow and Down arrow keys, highlight the element and press Enter.
    • Drag and drop the element.
      A video showcases how the user can insert an element by drag and dropping it from the quick insert menu.
    Tip:

    The elements that display in the quick insert menu are context-sensitive. The arrows indicate where and how the element will be inserted under the DITA structure of the content. Vertical arrows indicate that a new element will be inserted before or after the current element. Horizontal arrow indicates that a new element will be inserted as a child of the current element. To change the element suggestion mode, use the Insert drop-down menu and select Before, After or Intelligently.

Copy and Paste an Element in a Topic

You can copy and paste elements it in the same topic or different topics by using the footer or tags.

  1. In the Content Library, double-click a topic.
  2. To copy an element by using the footer, do the following:
    1. Place your cursor in the element that you want to copy.
    2. In the footer, click the element that you want to copy.
      Figure 1. Element Context Menu
      A user can copy an element by clicking the element name in the footer menu.
    3. From the context menu, select Copy.
  3. To copy an element by using the Tags context menu, right-click a tag and select Copy.
    Figure 2. Tag Context Menu
    A user can copy an element by right-clicking its tag and selecting the Copy operation.
  4. To paste the element, in the same or a different topic, right-click in the desired position and select Paste.

Move Elements in a Topic

You can reorder elements in topics by using the footer or by dragging and dropping tags.

  1. In the Content Library, double-click a topic.
  2. To move an element by using the footer, do the following:
    1. Place your cursor in the element that you want to move.
    2. In the footer, click the element that you want to move.
      Figure 3. Element Context Menu
      A user can use the breadcrumbs section in the footer to select the right element in the topic structure.
    3. From the context menu, select Move Up or Move Down.
      Tip: The Move Up and Move Down options display if the element can be moved to a valid position.
  3. To move an element by using the Tags, drag and drop a tag to a new position.
    A user can drag and drop tags to change positions of selected elements.
    Tip: You can drag and drop tags between different Content Editor.
    Figure 4. Drag and drop elements between windows. In this example, the ul element is being dragged and dropped from one browser window to another browser window.
    A user can drag and drop tags between browser windows.

Wrap an Element in a Topic

You can wrap elements in other elements by using the footer or tags.

  1. In the Content Library, double-click a topic.
  2. To wrap an element by using the footer, do the following
    1. Place your cursor in the element that you want to wrap in another element.
    2. In the footer, click the element that you want to wrap.
      Figure 5. Element Context Menu
      A user can select an element by using the breadcrumbs section in the footer.
    3. From the context menu, select Wrap Element.
  3. To wrap an element by using the Tags context menu, right-click a tag and select Wrap Element.
    Figure 6. Tag Context Menu
    A user can wrap an element by right-clicking its tag and selecting the Wrap Element operation.
  4. In the quick insert menu, do the following:
    Figure 7. Quick Insert Menu
    The Quick Insert Menu enables a user to select a parent element that will wrap a current element.
    1. Type an element name or scroll through the list of available elements.
    2. Wrap the element by pressing Enter or by clicking the element.

Unwrap an Element in a Topic

You can unwrap elements by using the footer or tags.

  1. In the Content Library, double-click a topic.
  2. To wrap an element by using the footer, do the following
    1. Place your cursor in the element that you want to unwrap.
    2. In the footer, click the element that you want to unwrap.
      Figure 8. Element Context Menu
      A user can select an element by using the breadcrumbs section in the footer.
    3. From the context menu, select Unwrap Element.
  3. To unwrap an element by using the Tags context menu, right-click a tag and select Unwrap Element.
    Figure 9. Tag Context Menu
    A user can unwrap element by right-clicking its tag and selecting the Unwrap Element operation.

Replace an Element in a Topic

You can replace elements with other elements by using the footer or tags.

  1. In the Content Library, double-click a topic.
  2. To replace an element by using the footer, do the following
    1. Place your cursor in the element that you want to replace.
    2. In the footer, click the element that you want to replace.
      Figure 10. Element Context Menu
      A user can select an element by using the breadcrumbs section in the footer.
    3. From the context menu, select Replace Element.
  3. To replace an element by using the Tags context menu, right-click a tag and select Replace Element.
    Figure 11. Tag Context Menu
    A user can replace a current element by right-clicking its tag and selecting the Replace Element operation.
  4. In the quick insert menu do the following:
    Figure 12. Quick Insert Menu
    The Quick Insert Menu enables a user to select an element that will replace a current element.
    1. Type an element name or scroll through the list of available elements.
    2. Replace the element by pressing Enter or by clicking the element.

Remove an Element from a Topic

You can remove elements from a topic by using the footer or tags.

Important: Removing an element deletes the element contents and its child elements.
  1. In the Content Library, double-click a topic.
  2. Place your cursor in the element that you want to remove.
  3. To remove an element by using the footer, do the following:
    1. In the footer, click the element that you want to remove.
      Figure 13. Element Context Menu
      A user can use the breadcrumbs section in the footer to select the right element.
      Tip:

      Hovering over an element in the footer highlights its location in the topic.

    2. Click Remove.
  4. To remove an element by using the Tags context menu, right-click a tag and select Remove.
    Figure 14. Tag Context Menu
    A user can remove an element by right-clicking its tag and selecting the Remove operation.