Delete Content

Abstract

You can permanently delete content in Paligo, if required. Deleted content cannot be restored, so you may want to use the move to trash feature instead.

You can delete content from Paligo so that it is no longer available. But we recommend that instead of deleting, you move the content to the trash instead. This is because content in the trash can be recovered. Deleting is different as it is completely removed from your Paligo instance and cannot be recovered.

To find out how to delete content, see:

If you have content that is reused, Paligo may prevent you from deleting it. This is so that you do not accidentally delete a topic or publication that is needed elsewhere. To find out about the checks Paligo makes and how you can delete reused content, see Rules for Deleting Reused Content.

You can use the Content Manager to delete components, such as topics, informaltopics, and images.

  1. In the Content Manager, browse to the component that you want to delete.

  2. Select the options menu ( ... ) for the component and then select Delete.

    Content Manager showing a publication's options menu. The delete option is highlighted.

    Paligo will check to see if the component has any dependencies. Your content has a dependency if it is reused in another topic or publication or if another topic links to your content. If there is a dependency, Paligo will either ask you if you want to proceed with the deletion or it will tell you the component cannot be deleted (see Rules for Deleting Reused Content).

  3. If you want to proceed with the deletion, select Delete Items.

    Paligo deletes the component from the database. It cannot be recovered.

You can delete text and elements inside your topics. As Paligo uses structured content, where your text, images, etc., are in elements, you cannot just highlight multiple sections of a page and press delete. That's not how structured content works. If you want to delete multiple sections of content at once, you need to consider the structure of the topic.

To delete text in a paragraph, you can place the cursor in the paragraph and use delete and backspace to remove the characters, just like in text editing programs.

To delete an entire paragraph, you can delete the para element. Click in the paragraph you want to remove so that it is selected. In the Element Structure Menu, select the para element and then select Delete. This will remove the para element and its text.

The menu for a para element. The Delete option is highlighted.

Note

If you accidentally delete a paragraph, there is a way to restore it. You can use the Reuse text feature to search for the paragraph and then insert it again. However, this is only possible for a limited time period after the deletion took place (approximately one day). Alternatively, you could use revisions to recover a previous version of the paragraph.

For images, select the image and then, in the Element Structure Menu, select the mediaobject element and then select Delete.

The menu for a mediaobject element. The Delete option is highlighted.

Notice that you are deleting the "parent" mediaobject element, and by doing that, you automatically delete the "child" imageobject and imagedata elements that are needed for an image. This same logic a "parent" and "child" relationship applies to all parts of the topic structure.

For example, if you have a procedure list, the list has a structure like this:

<procedure>
    <step><para>This is the text for the first step.</para></step>
    <step><para>This is the text for the second step.</para></step>
    <step><para>This is the text for the third step.</para></step>
</procedure>

If you delete the procedure element, you delete the entire procedure as you are deleting the "parent" procedure element and all of its "children" elements (the step elements and the para elements, and also the text inside the para elements). If you delete a step, you delete that step, including its para and the text inside the para. It is important to understand this hierarchy, as it can save you a lot of time and effort when deleting and moving content.

Tip

You can see the hierarchy of the structure by looking at the Element Structure Menu. It shows the currently selected element on the right, and its parent elements in sequence to the left.

The Element Structure Menu. The elements are highlighted, showing section on the left, then procedure, then step, then para in turn.

Note

You can use keyboard shortcuts as a faster alternative to the menu.

Each element in Paligo can have attributes, which are properties. For example, a paragraph could have a role attribute with the value "example-style" so that it can be styled differently to other paragraphs by using CSS. If an attribute is no longer needed, you can delete it.

  1. Select the element that has the attribute you want to delete. Make sure that you have selected the correct element by looking at the Element Structure Menu, where the currently selected element is on the right.

  2. In the Element attributes section, select the X icon for the attribute.

    The element attributes section. It shows the para element is selected and it has a role attribute with a value of example-style. The cursor is next to a cross delete icon for the role attribute.

When you try to delete content, Paligo will check how the deletion will affect your remaining topics. If the remaining topics will be broken by the deletion, Paligo will either:

  • Prevent you from deleting the content

  • Ask you if you want to go ahead with the deletion, even though the content will break links in other topics.

To do this, Paligo has some internal rules that involve checking your content for "dependencies". A dependency is when a topic or some other component needs to reference another component.

The checks that Paligo runs include:

  • Do any topics link to the component you are trying to delete?

  • Do any publications contain the component you are trying to delete?

  • Do any topics contain the component you are trying to delete?

  • Are there any components with dependencies inside the folder (this only applies to folders)?

If the answer is yes, there is a dependency. Depending on the scenario, Paligo will either ask you if you want to proceed with the deletion or it will tell you that the component cannot be deleted.

If you choose to proceed with a deletion, the component will be deleted, but this will result in broken links and missing content from other topics. It is a good idea to remove these dependencies before you delete, so that other topics do not have missing content.

If Paligo will not allow you to delete the component, you can Find and Remove Dependencies, and then try again. When there are no dependencies, Paligo will let you delete the component.

If Paligo will not allow you to delete content because of dependencies, you will either need to keep the content or remove the dependencies.

You can use the Metadata information to find the dependencies, and then you will need to delete those manually in each topic, publication, or other component. To access the Metadata information, select the options menu ( ... ) for the reused publication or topic you want to delete, and then select Edit > Open Structure.

The metadata section for a topic. It shows information about the topic, including its dependencies.

The dependencies information is in the Used in, Uses, and Related publications categories. To find out more, see Find Out Where Content is Used.