Chapter 2. Getting started with XMLmind XML Editor

There are a few things you need to learn before authoring documents with XMLmind XML Editor:

  1. Patterns looking like this are text placeholders. You can click into (or tab to) such placeholders and start typing.

  2. The node path bar, found above the document view, indicates what is selected or when there is no explicit selection, the element containing the caret.

  3. XMLmind XML Editor has 2 different kinds of selection, the text selection and the node selection.

  4. The text selection works like in any word processor or text editor. Few editing operations apply to the text selection: EditPaste, EditConvert. For example, you can convert the text selection to emphasis.

  5. The node selection looks different than the text selection: a thin red frame is drawn around the selected nodes. The simplest way to select a node is to click on its name in the node path bar.

    All the editing operations apply to the node selection.

  6. The node selection may comprise several sibling nodes, for example, two contiguous paragraphs. The easiest way to extend the node selection is to Shift-click before or after the thin red frame.

  7. The element directly containing the caret is always implicitly selected: no thin red frame around it.

    For example if you want to insert a table before a paragraph, first click inside this paragraph (but not inside any of its child elements, as this would implicitly select the child element) and then use EditInsert Before.

    However, if you want to insert a list after a table, you cannot do that using the implicit element selection because a table cannot directly contain some text. You'll have to first explicitly select this table (e.g. by clicking on "table" in the node path bar) and then use EditInsert After.

  8. Notice that the two editing operations mentioned above are EditInsert Before, EditInsert After. XMLmind XML Editor also has less commonly used EditInsert editing operation.

    EditInsert Before

    Insert an element (or text node) just before the node selection.

    EditInsert

    Insert an element right here, at caret position.

    EditInsert After

    Insert an element (or text node) just after the node selection.

    Important

    Note that XMLmind XML Editor does not work like other XML editors. In other XML editors,

    • Insert Before often means "Insert somewhere before selection".

    • Insert often means "Insert somewhere inside selection".

    • Insert After often means "Insert somewhere after selection".

  9. For the same reasons, XMLmind XML Editor has 3 paste operations and not just one: EditPaste Before, EditPaste, EditPaste After. Unlike EditInsert, EditPaste is commonly used and works as expected by replacing the text or node selection with the contents of the clipboard.

  10. When XMLmind XML Editor, which is a strictly validating XML editor, does not allow you to perform the editing operation you want, it's almost always because you didn't select the right object and/or you are not using the right editing operation.

    For example, you have clicked inside a paragraph and attempt to use EditInsert to add a chapter after it. This cannot work because a paragraph cannot contain a chapter. Instead, first select the chapter which is the ancestor of the paragraph (e.g. click "chapter" in the node path bar) then use EditInsert After (not EditInsert) and select "chapter" from the list.

Watch the screencast corresponding to what's explained above.