Element Structure Menu

The Element Structure Menu is shown at the top of the editor. It shows the hierarchical structure of the XML in the document.

In the image shown here, the currently selected element is a para.

element-structure-menu-positioning.jpg

We can see this by looking at the Element Structure Menu, which shows:

section > note > itemizedlist > listitem > para.

This means the cursor is currently on a para that is inside a listitem. The listitem is inside an itemizedlist which is inside a note. The note is inside the section element, which represents the topic as a whole.

Note

Sometimes the Element Structure Menu is called the Structure Menu for short.

You can select an element in the Element Structure Menu to access a list of options. The options vary, depending on which element is the currently selected element in the topic, and also which element you selected in the Element Structure Menu.

Menu Command

Description

Go to element

Moves your cursor to the element you select in the Element Structure menu. This gives you great control over the underlying element structure.

Move element up

Moves an element up in the topic structure, at the same level as the element selected. For example, a para element inside a section can be moved up above a para element at the same level in the section. But it cannot be moved into a subsection i.e. at a different level in the hierarchy.

Move element down

Works in the same way as move element up, except that it moves the element down in the structure.

Generate ID

Generates a unique and persistent id for the selected element.

Note

Some elements will generate unique and persistent ids by default. You can select which ones, and add more in the Editor settings.

Lock content

Locks content so that it cannot be edited without first being unlocked. This is very useful if you have written something that you know should not change. For example if you have content that could be reused as a text fragment, you might want to protect it from further editing.

Disable element translation

This is useful if you have content you know should not be translated. Such content will then be marked as untranslatable when you create a translation package for your translation provider.

Text

text-submenu.png

Reuse and history of a text element:

  • Show history: Shows the revision history of a single text element.

  • Usage information: Shows where the text element is reused (if the Reuse text feature has been used).

  • Compare translations: View the text element in different languages (if applicable).

Copy

Copies the element you select. This should always be preferred to just copying by selecting directly in the editor, which is prone to mistakes. Remember that this is "structured authoring", and the document structure should be carefully controlled to give you the power of structured authoring.

Cut

Cuts out exactly the element that you select. If you place the cursor in a valid location for this element, the Structure Element Menu has an option to insert the cut content.

Paste before/after, Insert/Insert as reuse

Different ways of pasting elements, as reuse text or not, depending on your choice and the context.

Delete

Removes selected content. The editor highlights the content that will be deleted and shows its text in red.