OLD - Wrapping provisions

Introduction

When inserting a grouping level provision around some lower-level provisions (e.g. a part around some sections), it is important that it is inserted correctly to ensure the correctly structure of the underlying XML.  We call this action ‘wrapping’. 

How to wrap a provision

1. Specify the lower-level provisions that you would like to ‘wrap’ within a grouping provision by:
   1. Selecting one or more contiguous, sibling provisions using the structure view (Ctrl + mouse click), or
   2. Highlighting the provisions in the Editor
2. Specify you would like to ‘wrap’ by
   1. Placing your cursor in the highlighted text and using the right-click menu and select ‘Wrap element…’,
   2. From the upper toolbar, select ‘Tools > Wrap element…’
   3. Using the keyboard shortcut Alt + w
3. If your selection is valid, the system will present a list of valid grouping level provisions that you can insert
4. Select one to insert it
5. The system will attempt to acquire a lock on the appropriate document fragment if it hasn’t got one already and then will insert the selected grouping-level provision, wrapping it around the selected lower-level provisions to create valid XML

Hints and tips

• There are certain restrictions in place to stop you wrapping elements without the correct structure in place e.g. you cannot wrap a set of sections within a Chapter unless they are already wrapped within a Part
• Check the structure view once you’ve wrapped your specified provisions to double-check that they have been correctly ‘wrapped’ (looking for a parent/child relationship)