Tips for using smart paste in NI Bills

Introduction

There are 3 main options to copy content into Lawmaker

Import from Word: best option for copying whole bills; also useful if copying whole sections or schedules that contain a lot of inserted text to other document types which aren’t Acts of the Northern Ireland Assembly.
Import from Legislation.gov.uk: useful for copying whole sections or schedules that already exist in legislation.gov.uk that you might be amending or copying in your NI Bill.
Copy & paste (Smart paste): useful for smaller chunks of provisions e.g. one or two sections. You can use it to copy whole bills into the Editor but it works best on simple sections/schedules with minimal amendments to other document types.

Tips for using smart paste

Tip 1: The start of your copied provisions needs to be the highest level provision in the chunk you are copying

Due to the way that smart paste works, if your start provision isn’t the highest level provision in the chunk that you are copying, smart paste will not be able to create these higher level provisions. At best, smart paste will end at the point the higher level provision appears; at worst, it might be misidentified and inserted as a different provision requiring manual intervention to correct.

Example:

(1) This is a subsection
(2) This is a second subsection
This is a new section
1.—(1) This is a new subsection in a new section

In this example, the starting provision is a subsection which isn’t the highest level provision in this copied chunk of text.

Tip 2: Paste into Word or Notepad to strip out hidden line breaks

PDFs are especially bad for this: copying provisions directly from a PDF and pasting it into Lawmaker is unlikely to be successful and this is mainly due to the hidden formatting (namely line breaks) in it which can throw smart paste. It is also likely to include line numbering if you’ve copied a line numbered PDF which can also throw smart paste.

The recommendation is to open Word or Notepad and paste the content into it. Delete any line breaks in the chunk that you’ve copied. Select this corrected text and paste into Lawmaker

Tip 3: Remove tables, images and equations from the copied document

Smart paste hasn’t been designed to import tables, images or equations. The recommendation is to delete these from the chunk that you want to copy and paste into Lawmaker and manually insert them directly via the Editor. You can still copy text to recreate these objects.

Tip 4: Quote marks can sometimes confuse smart paste

Quote marks are a key part of the parsing logic for smart paste used to identify what provision should be inserted. If quote marks are missing, or the wrong way around or there are a lot, this can often confuse smart paste and create strange results. If smart paste is struggling, consider working around portions of text that have a lot of complicated quote marks in them (e.g. multiple defined terms in one definition).

Tip 5: Cross headings can sometimes confuse smart paste

Cross headings, particularly in quoted structures can confuse smart paste. It might be easier to delete them if they are causing issues and re-insert them after you’ve copied the chunk of text (see Wrapping and unwrapping provisions )

Tip 6: Delete the shoulder reference note in schedules

Delete the shoulder note displayed on the right-hand side between the schedule number and schedule heading if you are copying whole schedules into Lawmaker. You can easily insert them back into the pasted content by placing your cursor into the schedule number and clicking Enter and selecting Reference note

Troubleshooting incorrectly pasted provisions

If you are more confident with Lawmaker, you might prefer to work your way down through a smart pasted block of text and correct any incorrect provisions as you go. There are various tools in Lawmaker that will make this easier. The following table lists some of the more common smart paste issues with some tips on how to resolve them.

Smart paste issue	Recommended steps to resolve
Quoted structure should be to another document type	Open the Attributes right-hand panel Place cursor at the start of the pasted quoted structure. Use left arrow to move your cursor into the quoted structure element (check the breadcrumb). Update the ukl:docName to the correct document type: Northern Ireland Order in Council = nisi UK Act = ukpga Northern Ireland Statutory Rule = nisr Scottish Act = asp Act of the Northern Ireland Assembly = nia EU Decision = eudn EU Directive = eudr
The quoted structure contains incorrect provisions based on the context E.g. instead of schedule sub-paragraphs, there are subsections E.g. instead of Articles, there are sections	Step 1: ensure the document type is correct (see point above) Step 2: correct the provisions Convert subsection into equivalent provisions Place cursor at the start of the quoted structure Move cursor into the quoted structure element using the left arrow (check the breadcrumb) When in the quoted structure, click Enter to see the insert menu (which will present options valid according to the specified document type) Select the correct provision (e.g. schedule sub-paragraph or Paragraph (1)) Use multi-select in the structure view to highlight all the subsections and cut them using keyboard short cut Ctrl+X Place your cursor in the newly inserted (correct) provision and use keyboard shortcut Ctrl+V to paste the copied subsections which will be pasted as the appropriate element type Convert section into article Place cursor at the start of the quoted structure Move cursor into the quoted structure element using the left arrow (check the breadcrumb) When in the quoted structure, click Enter to see the insert menu and select Article Copy and paste the section heading into the Article heading If the section contained subsections, insert a paragraph into your Article Use multi-select in the structure view to highlight all the subsections and cut them using keyboard short cut Ctrl+X Place your cursor in the newly inserted paragraph and use keyboard shortcut Ctrl+V to paste the copied subsections which will be pasted as paragraphs Note: you will need to work section-by-section to convert the content into Articles.
The text is pasted as a block of text rather than individual provisions.	Depending on the size of the content, it might be easier to split up the chunk of text into the appropriate provisions: Instructions Place your cursor at the end of the first provision in the block of text and use keyboard shortcut Alt+S to split the provision into 2 sibling provisions Tidy up any remaining spaces and repeat until you’ve broken the text into a series of sibling provisions If the provisions are further broken down into child elements, use demote (Tools > Demote provision) to convert a sibling provision into a child provision e.g. a paragraph
The highest provision in the inserted text is made up of paragraphs, definitions, sub-paragraphs or sub-sub-paragraphs.	Paragraphs, sub-paragraphs, sub-sub-paragraphs and definitions are the same elements for SIs, Northern Ireland Orders in Councils and Bills. This means that if your quoted structure is made up of these lower level provisions, but it is the wrong document type: you only need to update the document type (see the first row in this table) - the provisions will not need converting.

Depending on your confidence levels and experience with Lawmaker, it might be easier to copy smaller chunks into Lawmaker. By all means, copy the whole portion and paste it into Lawmaker to see if smart paste can handle it. If there are obvious issues, it might be better to note where smart paste went wrong; undo the paste (Ctrl+Z) and copy up to the breaking point. Thereafter, breakdown the copy & paste into smaller chunks.