Skip to main content

Move Content

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.

Table rows are different as you can only move those by using keyboard shortcuts and the XML Tree (see Move Table Rows).

To learn about the parent-child relationship and how it affects moving, copying and deleting, see Understanding Content Structures.

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.

Move Block Elements with XML Tree View

One of the easiest ways to move most types of block elements is to use the XML Tree View. You can access this by opening a topic in the main Paligo editor—it is shown in a section in the panel on the right. Select the XML Tree View 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).

Note

When you move an element, you also move the elements that are inside it (its "child" elements). To learn about the parent-child relationship between elements in a topic, see Understanding Content Structures.

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.

Tip

You can move entire tables in the same way as other block elements. But for table rows, you can only use the XML Tree View or keyboard shortcuts (see Move Table Rows).

Move Block Elements with the Element Structure Menu

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.

Move Block Elements with Keyboard Shortcuts

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

Table rows are slightly different to other block elements.

Move Table Rows with the XML Tree View

You can use the XML Tree View to move rows in a table. Note that you can only use the XML Tree View to move rows, you cannot move columns or individual cells.

You can move a row:

  • To another position in the same table

  • Into a different table (in the same topic).

To move a table:

  1. Open a topic in the editor and select the XML Tree View in the side panel.

    The XML Tree View shows the main elements in your topic as blue boxes, arranged in a hierarchy that matches the structure. Any box with a white cross has lower level content. If you select the white cross icon, the tree expands to show the lower levels.

    XML Tree View. It shows the hierarchical structure of the current topic. There are blue boxes for each of the block elements, organized in a hierarchy.
    XML tree view of a topic. It shows section at the top level. Second level elements are title, para, and table. Inside the table there is a tbody element. Inside the tbody element there are 5 tr elements, each representing a table row.

  2. Expand the tree to locate the table block and then expand that until you can see the table rows (tr).

  3. To move a table row, select it and then drag it to a new location in the XML Tree View. Paligo will only let you move it to another valid position, so you can move it to another position in the current table or you can move it into a different table.

Keyboard Shortcuts for Moving 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.

In this section: