Help > Authoring > Dialog Boxes > Edit Window > Insert Dialog Boxes > Insert Markup Dialog Box (Smart Insert)
  
Insert Markup Dialog Box (Smart Insert)
This Insert Markup dialog box displays when you select Insert > Markup if Smart Insert is configured in the document type's .dcf file, and turned on (using the Tools > Preferences > Edit, Use Smart Insert Feature check box).
* 
The options in this dialog box depend on the document type and the Smart Insert configuration in the .dcf file.
Following are the options available in the Insert Markup dialog box for the Arbortext XML DocBook document type when Smart Insert is turned on:
• Category — Specifies the category of element to be inserted. If you are unsure of which category to use, the last option in the list, ALL, lists all available elements if Smart Insert box is checked, and only elements valid at the insertion point in the document if the Smart Insert option is not selected.
• Smart Insert check box — Turns Smart Insert on or off. This functionality allows insertion of a desired element at the nearest valid location.
• Direction — Specifies the direction in which Smart Insert searches for a valid context in which to insert the selected element.
• The element list box contains a list of valid elements determined by the current settings.
* 
There is a limit to how far Smart Insert will search. A maximum of 10 contexts are searched in the specified Direction. This means that the potential insertion point is moved from its initial position up to 10 subsequent changes of context searching for a valid insertion point. Context changes occur as the insertion point traverses different elements. For example, assume the insertion point is within an emphasis element in an itemizedlist:
• An insertion point within an emphasis element changes context if it moves out from between the emphasis tags and into the context of a surrounding para
• The context changes again when the insertion point moves between the para and a surrounding listitem.
• It changes again going into the listitem
• Then when it is between that and the next listitem
• Then from there into the next listitem, and so on.
If a valid context is not found after searching the maximum context range, a tag structure is built around the element to be inserted in a further attempt to find a context where it can be inserted. A parent element is wrapped around the element. Then the maximum context range is tried again, this time attempting to insert the element and its parent rather than just the element itself. Once the maximum context range of 10 and the maximum structure depth of 5 is reached and no valid context for the element is found, no element is inserted. Move the insertion point to another location (beyond the maximum context range), and try to insert the element again.
Related information 
Inserting Markup