Insert Menu Introduction

The Insert menu contains commands for inserting markup, graphics, and equations.

• Markup — Opens the Insert Markup dialog box.

• New Element — Opens the Insert New Element dialog box. This choice is only available for Free-form XML document type instances.

• Table — Opens the Insert Table dialog box.

• Relationship Table — Opens the Insert Relationship Table dialog box.

• Topic Reference — Opens the Resource Manager with the Topic tab active.

• New Topic — Opens the Resource Manager with the New Topic tab active.

• Graphic — Allows you to insert a graphic.

• Symbol — Adds a symbol to your document.

• Display Equation — Opens the Equation Editordialog box. Use this dialog box to add a display equation at the cursor location.

A display equation is one that appears on its own line when inserted into a text line. The default formatting for a display equation is to surround it with a line or two of vertical space and to display it in a larger type style.

• Inline Equation — Opens the Equation Editordialog box. Use this dialog box to add a display equation at the cursor location.

An inline equation is set in the same type size as the surrounding text and appears in the flow of the text with no separating vertical space.

• CDATA Section — Adds a CDATA tag to your XML document.

To display this command, Full Menus must be turned on. Go to Tools > Preferences, and choose the Window category. Turn on Full Menus.

• Comment — Adds a comment tag pair at the cursor location. Either text or text and markup can be inserted inside the comment tags. If markup is included in a comment, removing that markup from the document must not make the document structurally invalid or the operation fails.

Text inside the comment tags is visible only in the Edit view, not in the Print Preview window or in published output.

To display this command, Full Menus must be turned on. Go to Tools > Preferences, and choose the Window category. Turn on Full Menus.

• Template Field — Allows you to mark parts of a document as template. When you choose the Placeholder command, enter placeholder text in the dialog box. This text is inserted and surrounded by template tags. When you click your cursor in a template section, the entire section is highlighted so that it can be easily replaced by typing.

When you choose the Instructions command, enter instructions in the dialog box. This text is similar to comment text in that it does not appear in document output.

To display this command, Full Menus must be turned on. Go to Tools > Preferences, and choose the Window category. Turn on Full Menus.

• File — Opens the Insert File dialog box. Use this dialog box to select a file to copy into the current document at the cursor location.

• File Reference — For non-DITA documents, displays the Locate File to Reference dialog box . Use this dialog box to insert a file as an XML inclusion or file entity in your document. For DITA documents, displays a separate, undocked Resource Manager dialog box containing the Inclusion tab. Use this tab to insert XML inclusions into DITA documents.

The contents of the inclusion or entity must be valid at the insertion point or a message appears declaring that the contents are out of context at the insertion point.

• Content Reference — Opens the Resource Manager with the Content Reference tab active.

This choice is only available when you are editing a DITA topic or map.

• Key Definition — Opens the Resource Manager with the Key Definition tab active.

• Key Reference — Opens the Insert Key Reference dialog box.

• Link — Opens the Insert Link dialog box.

If an intelligent graphic is selected in the Edit view, opens the Update Graphic Object Links dialog box instead.

• Link/Xref — Opens the Resource Manager with the Link/Xref tab active.

• Link from Intelligent Graphic — Opens the Update Graphic Object Links dialog box.

This choice is only available you are editing a DITA topic and have selected an intelligent graphic.

• Navigation Reference — Opens the Insert Link dialog box.

• Generate ID — Generates an ID for the active element in a DITA document.

This choice is only available when you are editing a DITA topic or map.