Difference between revisions of "Editorial Update/Images"
Line 1: | Line 1: | ||
<mark>DRAFT VERSION</mark> | <mark>DRAFT VERSION</mark> | ||
− | ==Using the Image Tool== | + | ==Using the Image Tool to insert and substitute images== |
− | + | After a circuitous route of dialogue and comprehensive testing with our IT contractors at TSO/WLT, we are now in a position to undertake the insertion or substitution of images, including Equations, Formulae and Forms in Parliamentary Legislation. This will enable all Legal Editors to work independently and edit image amendments autonomously without having to rely on the skills of external IT contractors, thus saving time and money. | |
+ | |||
+ | Use of the Image Tool is both easy and user friendly and primarily required access to the <strong>Image Data Update</strong> page not XMetaL. It should be stated though that some amendments, in which an image is included in the conventional insertion or substitution of a whole provision or sub-provision, will first require XMetaL access. It is only after check-in of the newly inserted or substituted provision or sub-provision, and then by selecting the <strong>Preview</strong> tab of on the <strong>Update Details</strong> page of the Editorial System, that the <strong>Image Update</strong> tab in the amended provision can then be selected to make the necessary image changes in the Image Directory, which will be thus explained. | ||
− | From the <strong>Update Details</strong> page, select the <strong>Preview</strong> provision tab. You will see the formatted version of the newly substituted provision. Select the first <strong>Update Image</strong> tab | + | ===Image is contained within a newly inserted or substituted provision=== |
+ | |||
+ | ====Example 1: Substitution of a provision which includes two formulae==== | ||
+ | |||
+ | From the <strong>Update Details</strong> page, select the <strong>Preview</strong> provision tab. You will see the formatted version of the newly substituted provision. Select the first <strong>Update Image</strong> tab: | ||
Line 13: | Line 19: | ||
|} | |} | ||
− | You will be taken to the <strong>Image Data Update</strong> page | + | You will be taken to the <strong>Image Data Update</strong> page: |
{|class=wikitable style="width: 75%;" | {|class=wikitable style="width: 75%;" | ||
Line 20: | Line 26: | ||
|} | |} | ||
− | Select the first radio button and then select the <strong>Update Affected Image</strong> tab. | + | Select the first radio button and then select the <strong>Update Affected Image</strong> tab. You will be taken back to the preview version of the amended provision where the new formula is displayed. |
− | |||
− | You will be taken back to the preview version of the amended provision where the new formula is displayed. | ||
You should then repeat the same process for the second formula, by first selecting the Update Image tab, then selecting the radio button for the second formula on the <strong>Image Data Update</strong> page and then selecting the <strong>Update Affected Image</strong> tab. This will result in the formatting of the images for both formulae in the amended provision: | You should then repeat the same process for the second formula, by first selecting the Update Image tab, then selecting the radio button for the second formula on the <strong>Image Data Update</strong> page and then selecting the <strong>Update Affected Image</strong> tab. This will result in the formatting of the images for both formulae in the amended provision: | ||
Line 32: | Line 36: | ||
|} | |} | ||
− | ===Substitution of a Form in a Schedule=== | + | ====Example 2: Substitution of a Form in a Schedule==== |
+ | From the preview of the provision, select the <strong>Update Image</strong> tab in the amended Schedule: | ||
+ | |||
{|class=wikitable style="width: 75%;" | {|class=wikitable style="width: 75%;" | ||
|- | |- | ||
Line 44: | Line 50: | ||
|} | |} | ||
− | + | On the <strong>Image Data Update</strong> page, select the radio button of the image to be substituted: | |
− | + | ||
− | |||
{|class=wikitable style="width: 75%;" | {|class=wikitable style="width: 75%;" | ||
|- | |- | ||
Line 52: | Line 57: | ||
|} | |} | ||
− | + | Next, select the <strong>Update Affected Image</strong> tab: | |
{|class=wikitable style="width: 75%;" | {|class=wikitable style="width: 75%;" | ||
Line 59: | Line 64: | ||
|} | |} | ||
− | + | You will be returned to the amended document where the image is displayed. An F-note annotation can be inserted at the Sch. 2 Title level by checking out the Schedule conventionally in XMetal. | |
{|class=wikitable style="width: 75%;" | {|class=wikitable style="width: 75%;" | ||
Line 66: | Line 71: | ||
|} | |} | ||
− | |||
{|class=wikitable style="width: 75%;" | {|class=wikitable style="width: 75%;" | ||
Line 74: | Line 78: | ||
===What to do if the image is incorrect or missing=== | ===What to do if the image is incorrect or missing=== | ||
+ | |||
+ | ====Example 1: One image is missing==== | ||
+ | |||
+ | In the preview of the amended provision, select the <strong>Update Image</strong> tab. | ||
{|class=wikitable style="width: 75%;" | {|class=wikitable style="width: 75%;" | ||
Line 80: | Line 88: | ||
|} | |} | ||
− | + | You will be taken to the <strong>Image Data Update</strong> page, however the affecting image is missing, and you will not be able to select the <strong>Update Affected Image</strong> tab: | |
{|class=wikitable style="width: 75%;" | {|class=wikitable style="width: 75%;" | ||
Line 87: | Line 95: | ||
|} | |} | ||
− | + | To combat the non-appearance of the amending document’s details, paste the URL for the amending document into the <strong>Fetch Custom Provision</strong> box. | |
− | |||
{|class=wikitable style="width: 75%;" | {|class=wikitable style="width: 75%;" | ||
Line 95: | Line 102: | ||
|} | |} | ||
− | + | The affecting image should then appear and you will be able to select the radio button to the right of the new formula and then select the <strong>Update Affected Image</strong> tab: | |
{|class=wikitable style="width: 75%;" | {|class=wikitable style="width: 75%;" | ||
Line 102: | Line 109: | ||
|} | |} | ||
− | + | You will be returned to the amended provision with the new image formula having replaced the old image formula: | |
{|class=wikitable style="width: 75%;" | {|class=wikitable style="width: 75%;" | ||
Line 109: | Line 116: | ||
|} | |} | ||
− | |||
− | ==== | + | ====Example 2: Two images are missing==== |
+ | |||
+ | From the provision preview, select the first <strong>Update Image</strong> tab: | ||
+ | |||
+ | {|class=wikitable style="width: 75%;" | ||
+ | |- | ||
+ | |[[File:Image_tool_14.png]] | ||
+ | |} | ||
+ | |||
− | + | You will be taken to the <strong>Image Data Update</strong> page where the affecting images will be missing. You should paste the amending URL for your affecting document into the <strong>Fetch Custom Provision</strong> box to retrieve the affecting images. | |
− | + | In this example, the affecting provision is: | |
+ | https://www.legislation.gov.uk/uksi/2016/257/regulation/23/made#regulation-23-1-a | ||
+ | |||
{|class=wikitable style="width: 75%;" | {|class=wikitable style="width: 75%;" | ||
− | |-[[File: | + | |- |
+ | |[[File:Image_tool_16.png]] | ||
|} | |} | ||
− | |||
{|class=wikitable style="width: 75%;" | {|class=wikitable style="width: 75%;" | ||
− | |-[[File: | + | |- |
+ | |[[File:Image_tool_21.png]] | ||
|} | |} | ||
− | + | ||
+ | |||
+ | Once the <strong>Fetch Custom Provision</strong> tab is selected, the options of the new images from the affecting provision is displayed. Select the appropriate radio button and then select the <strong>Update Affected Image</strong> tab. | ||
+ | |||
+ | |||
{|class=wikitable style="width: 75%;" | {|class=wikitable style="width: 75%;" | ||
− | |-[[File:Image_tool_17.png]] | + | |- |
+ | |[[File:Image_tool_17.png]] | ||
|} | |} | ||
− | + | ||
+ | You will be taken back to the updated amended provision preview, where the change of formula has been made for the first formula. | ||
+ | |||
{|class=wikitable style="width: 75%;" | {|class=wikitable style="width: 75%;" | ||
Line 139: | Line 163: | ||
|} | |} | ||
− | + | ||
+ | Next, repeat this process for the second image by selecting the second <strong>Update Image</strong> tab. | ||
+ | |||
{|class=wikitable style="width: 75%;" | {|class=wikitable style="width: 75%;" | ||
− | |-[[File:Image_tool_19.png]] | + | |- |
+ | |[[File:Image_tool_19.png]] | ||
|} | |} | ||
− | + | ||
+ | You will again be taken through to the <strong>Image Data Update</strong> page. Again, paste the URL of the amending document into the <strong>Fetch Custom Provision</strong> box. | ||
+ | |||
+ | |||
+ | <!--{|class=wikitable style="width: 75%;" | ||
+ | |- | ||
+ | |[[File:Image_tool_20.png]] | ||
+ | |}--> | ||
+ | |||
+ | |||
+ | |||
{|class=wikitable style="width: 75%;" | {|class=wikitable style="width: 75%;" | ||
− | |-[[File: | + | |- |
+ | |[[File:Image_tool_15.png]] | ||
|} | |} | ||
− | + | Select the appropriate radio button for the second image substitution and then select the <strong>Update Affected Image</strong> tab. | |
{|class=wikitable style="width: 75%;" | {|class=wikitable style="width: 75%;" | ||
− | |-[[File: | + | |- |
+ | |[[File:Image_tool_22.png]] | ||
|} | |} | ||
− | |||
− | |||
− | |||
− | + | You will be returned to the updated amended provision preview, with both formulae now having been substituted. | |
+ | |||
− | {|class=wikitable style="width: 75%;" | + | <!--{|class=wikitable style="width: 75%;" |
|- | |- | ||
|[[File:Image_tool_23.png]] | |[[File:Image_tool_23.png]] | ||
− | |} | + | |}--> |
+ | |||
− | |||
{|class=wikitable style="width: 75%;" | {|class=wikitable style="width: 75%;" | ||
Line 175: | Line 212: | ||
|} | |} | ||
− | You should then check out the amended provision in XMetal and edit the F-note annotation | + | |
+ | You should then check out the amended provision in XMetal and edit the F-note annotation. | ||
Line 183: | Line 221: | ||
|} | |} | ||
− | ====Substitution of a Form in a Schedule==== | + | <!--====Substitution of a Form in a Schedule==== |
{|class=wikitable style="width: 75%;" | {|class=wikitable style="width: 75%;" | ||
Line 239: | Line 277: | ||
|[[File:Image_tool_42.png]] | |[[File:Image_tool_42.png]] | ||
|} | |} | ||
+ | --> | ||
+ | ==Other amendments to images== | ||
+ | |||
+ | ===Textual amendments to images=== | ||
+ | |||
+ | If an image is not being wholly inserted or substituted, but there are textual amendments being made to forms, maps, diagrams, etc. that are held as image files, we are unable to edit the image files ourselves. Instead, update editors should manually insert an F-note annotation in a suitable position in relation to the form/map/diagram tagging and provide a more explanatory annotation using the drafter’s text. For example, a suitable position for the F-note reference might be within the <code><ukl:Number></code> tags of the Schedule that contains the form, or within the <code><ukl:Title></code> tags of the form if available (see examples [[Editorial_Update/Manual_Amendments#Scenarios | below]]). The <strong>Element List</strong> window will show you whether it is possible to insert a <code><ukl:CommentaryRef></code> tag in your chosen location. | ||
+ | |||
+ | [http://www.legislation.gov.uk/uksi/2013/3156/schedule/paragraph/23/2014-09-15 S.I. 2013/3156, Sch. para. 23]: | ||
+ | <blockquote>[[File:Image_amendment_1.png|link=]]</blockquote> | ||
+ | <blockquote>[[File:Image_amendment_2.png|link=]]</blockquote> | ||
+ | |||
+ | [http://www.legislation.gov.uk/ssi/2018/155/schedule/2 S.S.I. 2018/155]: | ||
+ | <blockquote>[[File:Image_amendment_3.png|link=]]</blockquote> | ||
+ | |||
+ | If the amendments are more complex or so large that it seems unfeasible to include details in the annotation, then we could summarise the amendments in the annotation rather than giving verbatim text, but there should still be a more explanatory F-note than usual. If you have any difficulty formulating such an annotation, consult a <strong>Review Editor</strong>. | ||
+ | |||
+ | ===Omission of an image=== | ||
+ | |||
+ | If an amendment requires that an image is omitted, the tagging for the image should be repealed and the image replaced with a dotted line with an F-note: | ||
+ | |||
+ | <blockquote>[[File:Image_omitted_1.png|link=]]</blockquote> | ||
+ | |||
+ | <blockquote>[[File:Image_omitted_2.png|link=]]</blockquote> | ||
+ | |||
+ | If you are unsure how to do this, contact a <strong>Review Editor</strong> and they can ask TSO to do the amendment. |
Revision as of 14:54, 27 April 2021
DRAFT VERSION
Using the Image Tool to insert and substitute images
After a circuitous route of dialogue and comprehensive testing with our IT contractors at TSO/WLT, we are now in a position to undertake the insertion or substitution of images, including Equations, Formulae and Forms in Parliamentary Legislation. This will enable all Legal Editors to work independently and edit image amendments autonomously without having to rely on the skills of external IT contractors, thus saving time and money.
Use of the Image Tool is both easy and user friendly and primarily required access to the Image Data Update page not XMetaL. It should be stated though that some amendments, in which an image is included in the conventional insertion or substitution of a whole provision or sub-provision, will first require XMetaL access. It is only after check-in of the newly inserted or substituted provision or sub-provision, and then by selecting the Preview tab of on the Update Details page of the Editorial System, that the Image Update tab in the amended provision can then be selected to make the necessary image changes in the Image Directory, which will be thus explained.
Image is contained within a newly inserted or substituted provision
Example 1: Substitution of a provision which includes two formulae
From the Update Details page, select the Preview provision tab. You will see the formatted version of the newly substituted provision. Select the first Update Image tab:
![]() |
You will be taken to the Image Data Update page:
![]() |
Select the first radio button and then select the Update Affected Image tab. You will be taken back to the preview version of the amended provision where the new formula is displayed.
You should then repeat the same process for the second formula, by first selecting the Update Image tab, then selecting the radio button for the second formula on the Image Data Update page and then selecting the Update Affected Image tab. This will result in the formatting of the images for both formulae in the amended provision:
![]() |
Example 2: Substitution of a Form in a Schedule
From the preview of the provision, select the Update Image tab in the amended Schedule:
![]() |
![]() |
On the Image Data Update page, select the radio button of the image to be substituted:
![]() |
Next, select the Update Affected Image tab:
![]() |
You will be returned to the amended document where the image is displayed. An F-note annotation can be inserted at the Sch. 2 Title level by checking out the Schedule conventionally in XMetal.
![]() |
![]() |
What to do if the image is incorrect or missing
Example 1: One image is missing
In the preview of the amended provision, select the Update Image tab.
![]() |
You will be taken to the Image Data Update page, however the affecting image is missing, and you will not be able to select the Update Affected Image tab:
![]() |
To combat the non-appearance of the amending document’s details, paste the URL for the amending document into the Fetch Custom Provision box.
![]() |
The affecting image should then appear and you will be able to select the radio button to the right of the new formula and then select the Update Affected Image tab:
![]() |
You will be returned to the amended provision with the new image formula having replaced the old image formula:
![]() |
Example 2: Two images are missing
From the provision preview, select the first Update Image tab:
![]() |
You will be taken to the Image Data Update page where the affecting images will be missing. You should paste the amending URL for your affecting document into the Fetch Custom Provision box to retrieve the affecting images.
In this example, the affecting provision is:
https://www.legislation.gov.uk/uksi/2016/257/regulation/23/made#regulation-23-1-a
![]() |
![]() |
Once the Fetch Custom Provision tab is selected, the options of the new images from the affecting provision is displayed. Select the appropriate radio button and then select the Update Affected Image tab.
![]() |
You will be taken back to the updated amended provision preview, where the change of formula has been made for the first formula.
![]() |
Next, repeat this process for the second image by selecting the second Update Image tab.
![]() |
You will again be taken through to the Image Data Update page. Again, paste the URL of the amending document into the Fetch Custom Provision box.
![]() |
Select the appropriate radio button for the second image substitution and then select the Update Affected Image tab.
![]() |
You will be returned to the updated amended provision preview, with both formulae now having been substituted.
![]() |
You should then check out the amended provision in XMetal and edit the F-note annotation.
![]() |
Other amendments to images
Textual amendments to images
If an image is not being wholly inserted or substituted, but there are textual amendments being made to forms, maps, diagrams, etc. that are held as image files, we are unable to edit the image files ourselves. Instead, update editors should manually insert an F-note annotation in a suitable position in relation to the form/map/diagram tagging and provide a more explanatory annotation using the drafter’s text. For example, a suitable position for the F-note reference might be within the <ukl:Number>
tags of the Schedule that contains the form, or within the <ukl:Title>
tags of the form if available (see examples below). The Element List window will show you whether it is possible to insert a <ukl:CommentaryRef>
tag in your chosen location.
S.I. 2013/3156, Sch. para. 23:
If the amendments are more complex or so large that it seems unfeasible to include details in the annotation, then we could summarise the amendments in the annotation rather than giving verbatim text, but there should still be a more explanatory F-note than usual. If you have any difficulty formulating such an annotation, consult a Review Editor.
Omission of an image
If an amendment requires that an image is omitted, the tagging for the image should be repealed and the image replaced with a dotted line with an F-note:
If you are unsure how to do this, contact a Review Editor and they can ask TSO to do the amendment.