Move Block Elements

Being able to move content quickly is one of the benefits of structured authoring in Paligo. When you move a block element, you move the selected element and all of its "child" elements too. A good example is a procedure, where if you move the procedure element, you move the procedure element and all of its "child" step and para elements in one action.

To move most types of block elements, you can use:

Table rows are different as you can only move those by using keyboard shortcuts (see Moving Table Rows).

Tip

It's worth taking the time to learn the keyboard shortcuts. When you master those, you will be able to move your block elements around very quickly.

One of the easiest ways to move most types of block elements is to use the XML tree view. You can access this in any topic - it is shown in a section on the right. Select the XML tree view text in the black header to expand the structure.

XML Structure view shows your content in a tree structure. On the left, there are blue tags for each element in your topic and these are nested to show the different levels of content.

The XML tree view shows the structure of the topic you are viewing, with the block elements shown as blue tags. To move content, select a block and drag it to the required position (the tag has to be on the dark line to complete the move).

You can move a block up and down at the same level in the structure, or you can move it left and right to place it at a lower level in the structure. For example, you could drag a paragraph into a step in a procedure.

XML Structure view shows your content in a tree structure. In this image, a procedure tag is expanded to reveal all of the steps and paragraphs inside it. A para element has been moved so that it is now inside a step.

When you position the cursor over a blue tag in the XML tree view, that element is also highlighted in the main Editor. For example, in the following image, the cursor is over the procedure tag, so the procedure is highlighted in the main editor.

The main editor is shown on the left. There is a topic with content and a procedure and all of its steps are highlighted. On the right, the XML structure view shows the cursor is positioned over the procedure tag.

Paligo checks that the elements are in a valid position while you are editing, so you cannot place an element where it is not allowed. If you try to do this, a red line is shown in the main editor and a red tag is shown in the XML tree view.

On the left, the main editor shows a topic is open. There is content in the topic and a horizontal red line is shown in a paragraph. In the XML structure view, the cursor is on a red title tag. It is red because the user is trying to move it into an invalid position. The red line in the main editor also indicates this.

To use the Element Structure Menu to move a block element up or down:

  1. Select the element you want to move.

    You can see which element is currently selected by looking at the Element Structure Menu. The element furthest to the right is the currently selected element. If you want to select one of its "parent" elements, select it in the Element Structure Menu and then select Go to Element.

    The top section of the main editor, with the menu, toolbar, and Element Structure Menu shown. The Element Structure Menu shows section, procedure, and step elements and the cursor is on the procedure element. There is a dropdown menu with Go to element as an option.
  2. Select the name of the element in the Element Structure Menu and choose Move up or Move down, depending on the direction you want to move the element.

    The dropdown menu for the mediaobject element. There is a Go to element option, a Move up option, and a Move down option. The cursor is over the Move down option.

When you are moving block elements, it's important to note that you can only move an element up or down at the same level in the overall topic structure. This is by design, as it ensures that you do not move elements into positions where they are not allowed. For example, you can move a step in a procedure up or down in the procedure order, but you cannot move the step outside of the procedure.

To use keyboard shortcuts to move block elements:

  1. Select the element you want to move in the topic.

  2. Use the keyboard shortcuts to move the element.

    Move up is AltShift on Windows and Option ⌥ Shift ⇧ on Mac.

    Move down is AltShift on Windows and Option ⌥ Shift ⇧ on Mac.

When you are moving block elements, it's important to note that you can only move an element up or down at the same level in the overall topic structure. This is by design, as it ensures that you do not move elements into positions where they are not allowed. For example, you can move a step in a procedure up or down in the procedure order, but you cannot move the step outside of the procedure.

Move Table Rows

You can use keyboard shortcuts to move table rows up or down.

  1. Place the cursor in a table cell in the row you want to move.

    It is important that the cursor is in the td element of the cell and not in a para or other element inside the cell. Check the Element Structure Menu to see that you have the cursor in the correct place (the td element should be the last element on the right):

    The Element Structure Menu. It shows a section element followed by an informaltable element, a tbody element, a tr element, and a td element.
  2. Use the keyboard shortcuts to move the element.

    Move up is AltShift on Windows and Option ⌥ Shift ⇧ on Mac.

    Move down is AltShift on Windows and Option ⌥ Shift ⇧ on Mac.

When you are moving block elements, it's important to note that you can only move an element up or down at the same level in the overall topic structure. This is by design, as it ensures that you do not move elements into positions where they are not allowed. For example, you can move a step in a procedure up or down in the procedure order, but you cannot move the step outside of the procedure.