Introduction
The editor uses a Content Completion Assistant (CCA) to help you insert valid XML content. It offers a list of provisions and their elements that are valid at your cursor’s location and will insert your selected provision in the next correct place in the document.
How to insert a provision using the Content Completion Assistant (CCA)
To activate the CCA, click Enter
Select the provision/element you wish to insert next, using the down/up arrows or mouse and click Enter again
The selected provision/element will be inserted in the next correct place.
How to insert a provision using the keyboard shortcut for default next element
Place cursor in either the heading or text element for a provision and click Ctrl + Enter
The system will insert the next default element
How to insert a provision using right-click menu in the Editor
The system will present a context menu
Select “Insert element…”
The system will present the CCA
How to insert a provision using the upper toolbar
Place cursor in the provision that you want to insert your new provision after
Select Insert > Insert Element… from the drop-down menu in the upper toolbar
The system will present the CCA
Hints and tips
You can insert an additional paragraph of text within a provision e.g. a step which contains two <p> paragraphs of text by using the keyboard short cut Shift + Enter
You can use the search input field at the top of the CCA to quickly find the desired provision/element. It will dynamically display matching provisions/elements that begin with the characters entered in the search field.
You can navigate through the list of valid provisions/elements using the up and down arrow keys or select them using the mouse.
Provisions are being auto-numbered using the auto-assign number rule (see Annex 6 - ‘Auto-assign numbering rule’ in Annexes)
Whenever a provision is inserted, the cursor will appear by default in the heading or if provision doesn’t have a heading, into the text element
Each provision has a default next element configured which will appear at the top of the CCA which means you can insert them by double-clicking Enter or by using the keyboard shortcut – Ctrl + Enter (see Annex 2 - ‘Next default provision’ in Annexes)
Schedule paragraphs will convert to schedule sub-paragraphs when you insert another schedule subparagraph after the schedule paragraph’s content
(Bills only) Sections will default to having a subsection in them when first inserted. You can use ‘promote’ (ALT + [) to promote it into section/content.
New provisions are inserted after the element that your cursor is in. To insert a provision before the first provision in the series, it is sometimes useful to ‘view block tags’ (from Document > Preferences… in the toolbar menu) and place the cursor before the starting tag of the first provision in the series. From here you can use the CCA to insert the provision at the beginning of the series
(SI/SSIs only) When inserting a second schedule, the system will automatically insert the ‘SCHEDULES’ heading before the first Schedules.
(SI/SSIs only) Regulation (or Articles etc.) text will convert to Sub-paragraph text if you insert a Sub-paragraph (1) after it or even before you have added any content. And vice versa, when you delete the penultimate sub-paragraph, the remaining sub-paragraph will automatically convert into plain Regulation (or Article etc.) text.
The combined numbering format used by SI/SSIs will happen automatically when you insert your child provision into the parent e.g. inserting a sub-paragraph (i) into the first paragraph (a) – will become:
(a) (i) sub-paragraph text here.
(UK Bills only) to insert a ‘note’ at the top of the bill e.g. for Money bill rubrics, place your cursor in the ‘preface’ element. To do this either
Place cursor at the beginning of the Stage version rubric in blue writing at the top of the bill and use left arrow to move cursor through XML tags until it is in ‘Preface’ element (see the breadcrumbs to check)
Go to “Document > Preferences” in the upper toolbar menu and select “Block tags” in the dialogue box that appears. This will present XML tags in the Editor View so that you can place your cursor directly after the “Preface” element
When you have your cursor in the Preface element, click ‘Enter’ and select ‘Note’ (don’t forget to return to ‘No tag’ view from ‘Document > Preferences’ when you have finished).
It is possible to insert bullet lists into your documents (bills & SIs). If you right-click on the bullet point and select "Update List Style" you can change the bullet point to an em-dash list or no bullet point.
Screencasts
Creating SI/SSIs and inserting provisions
...