Description David Green 2009-01-16 12:10:54 EST

h1. Overview

with this enhancement the position of sections in a document can be moved by using drag and drop in the editor outline view.  Dragging an item will show it's new position with a line indicating the drop position.  When dropped, the heading and it's related content including sub-sections wil be moved in the document.

h1. Discussion

Whitespace handling may prove slightly difficult, since the editor has no knowledge of how headings work in any given markup language.  The offset of the heading in the document is where the markup starting it begins (usually the start of a line), and the end of a section is denoted by the next heading at the same level or the end of the document.  We have the following cases:

# moving a section to the start of the document
# moving a section to the end of the document
# moving a top-level section up/down within the document relative to its peers
# moving a sub-section up/down relative to its peers, or relative to sections of the same level elsewhere in the document
# moving a section to a different position in the document where there is a level mis-match

How whitespace is handled in these cases and how to determine the character offset should be planned carefully for each case.  With knowlege of common markup languages such as Textile, MediaWiki and Confluence it may be possible to have it work without markup language specific extensions.