Versions Compared

Key

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

Introduction

The Editor uses the Content Completion Assistant (CCA) to help you insert provisions and other elements into your document. It ensures that what you insert is valid in terms of document structure and the underlying XML.

...

How to insert a provision using the Content Completion Assistant (CCA)

To insert a provision:

  1. Press Enter to activate the CCA.

  2. Select the provision you wish to insert. You can use the up and down arrow keys or your mouse or you can start typing the name of the provision you want.

  3. Press Enter again.

The selected provision/element will be inserted in the next correct place, e.g. if your cursor is within a paragraph of a Regulation and you select “Regulation” from the CCA then a new Regulation will be inserted after the current Regulation.

When you insert a provision, default child elements within the provision like the number and heading are also inserted.

Your cursor will move into the provision that is inserted.

...

The provision that will be inserted in the provision that would appear at the top of the CCA had you pressed Enter. This will generally be the same provision as the one your cursor is in with the exception of when your cursor is a heading, opening words or closing words.

When your cursor is in

This provision will be inserted

Heading of grouping element (e.g. Part, Chapter, cross-heading)

Section if in a Bill; regulation/article etc. if in an SI/SSI

Heading of a section in a Bill

Subsection

Schedule heading

Cross-heading

Any other provision (e.g. subsection, paragraph etc.)

The same provision

How to insert an additional text paragraph within a provision

...

A child element is an element that will be inserted within the current element your cursor is in. For example, if your cursor is in a subsection then a child would be a paragraph, definition or step.

The CCA first shows options in the valid sibling

Essentially the rule has been built such that sibling element and provisions will appear first in the insert menu (also referred to as the Content Completion Assistant (CCA)) with valid child provisions appearing after. As a provision rarely exists in isolation, the rule will also provide sibling provisions for all parent provisions further up the provision ‘branch’ you are in.  There is a special rule applied to ‘heading’, ‘content’ and ‘closing word’ elements within the provisions which have enabled us to dictate the first element/provision at the top of the Content Completion Assistant which is used by the ‘default next element’ insert shortcuts.  See ‘Next default element’ table to find out what these special rules are.

...

following order:

  • First, the valid siblings of the immediate provision your cursor is in.

  • Then the valid children of the provision your cursor is in.

  • Last, the valid siblings of each ancestor above the provision your cursor is in.

So, for example, if your cursor is in a subsection within a Bill, the CCA might look like:

...

In this case:

  • The valid sibling of the provision your cursor is in is Subsection (1).

  • The valid children are: Paragraph (a), Definition, Step, Heading, Unnumbered Paragraph.

  • The valid siblings of ancestors of the provision are: Section, Cross heading, Part.

Numbering of inserted provisions

See Numbering for more on how provisions are numbered when they are inserted.

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.

...

Inserting elements in the preface

If you need to insert an element in the preface (e.g. to insert a ‘note’ at the top of a Bill e.g. for Money bill rubrics), the simplest way is as follows:

  1. Open the Preferences by selecting Document>Preferences… in the upper toolbar menu.

  2. Turn on block tags mode by selecting Block tags in the Tags display mode dropdown menu.  This will present XML tags in the Editor.

  3. Place your cursor within the Preface tags but not within any child elements inside the preface.

  4. Press Enter and select the element you want to insert (e.g. Note).

  5. Return the display mode to normal by selecting No Tags in the Preferences… dialogue box.

Automatic conversions and insertions

In some cases, when you insert a particular element, Lawmaker will automatically convert an existing element or insert an extra element to ensure the document remains correctly structured and formatted.

In particular:

  • When you insert a subsection into a section in a Bill (that isn’t currently divided), the existing content of the section will be converted into the first subsection of the section.

  • When you insert a paragraph into a Regulation or Article etc. into an SI/SSI (that isn’t currently divided), the existing content of the regulation etc. will be converted into the first paragraph.

  • When you insert a schedule subparagraph into a schedule paragraph (that isn’t currently divided), the existing content of the schedule paragraph will be converted into the first schedule subparagraph.

  • When you insert a second schedule into a UK Bill or an SI/SSI, a ‘SCHEDULES’ heading will be inserted before the first schedule.

Info

Hints and tips

  • When you insert a section into a Bill, it will contain a subsection by default. If you want an undivided section, you can use the promote function to remove the subsection - see Promoting and demoting provisions

  • When you insert an article, regulation, or rule into an SI/SSI, it will be undivided by default. You can insert paragraphs and sub-paragraphs using the CCA.

  • To insert a provision before the first provision in the series, it is sometimes useful to ‘view block tags’ (from

...

  • Document>Preferencesin 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) 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

...

  • a 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

...

  • .

  • It is possible to insert

...

  • a bulleted list 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

...