4. Adding a division

Click the " Division" toolbar button to add a new div element after caret position[1].

What does “add after” exactly mean?

Adding “after” indeed means adding after, but not always immediately after. It precisely means: after current element or any of its parent elements, at first location where it is allowed to do so. This last sentence has important consequences. For example:

• If you click in the title descendant of the teiHeader, this toolbar button will be grayed (disabled) because there is no way to add a div “after” the title of a teiHeader. Only elements like author (immediately after title), editionStmt (immediately after titleStmt), encodingDesc (immediately after fileDesc), text (immediately after teiHeader) are allowed “after” the title of a teiHeader.
• If you click in any child element of a div but its very last child element (e.g. if you click in the head of the div), this toolbar button will add a sibling div after current div.
• If you click in the very last child element of a div, this toolbar button will add a child div, that is, a sub-division, to current div.

In XMLmind XML Editor, this “add after” concept is used exclusively in the toolbar buttons[2]. At first, you'll add elements at unexpected locations but after some time, you'll find it quite predictable and very handy to use.