Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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

Specify the lower-level provisions that you would like to ‘wrap’ within a grouping provision by:

  • Selecting one or more contiguous, sibling provisions using the structure view (Ctrl + mouse click), or

  • Highlighting the provisions in the Editor

Specify you would like to ‘wrap’ by

  • Placing your cursor in the highlighted text and using the right-click menu and select ‘Wrap element…’,

  • From the upper toolbar, select ‘Tools > Wrap element…’

Using the keyboard shortcut Alt + w

  • If your selection is valid, the system will present a list of valid grouping level provisions that you can insert

Select one to insert it

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

Info

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)