Skip to content

Checking link consistency

Unlike the link checker on the desktop, which allows you to check only the links within a single document (see Link Checker), the link consistency check allows you to check all existing HTML files on various systems.

Note

This process can take some time for larger projects and can generate considerable load on the server. Therefore, only users with access to the superuser group can start the link consistency check.

A report of the last check is available to all other users.

  • Choose Menu -> Documents -> Link Consistency Check.

Note that the dialog box that opens is displayed in the superuser view. As you are not allowed to start or stop the report as a "simple" user, these options are not shown in your view.

The Link Validation Check dialog

Under Last update you will find the information when the link consistency check was last performed.

For each configured server, a report of the link consistency check is displayed in a separate (grey) box. The name of the respective server is displayed in a bar (in the example "LIVE SYSTEM").
Below are links with which you can directly call up the individual sections of a report. The following sections are available:

  • Broken links:
    In this section you will find links that could not be validated, because the target URL was not available.
    The following figure shows an example entry in this section:

    Example of a broken link
  • Orphaned objects:
    This section contains all files which are not referenced by other files. Here too, the individual entries are linked.

  • Dummies
    In this section you will find all documents with links that have a hash (#) as their target. Links that additionally call a JavaScript function via an event handler are not listed here.

    Note

    Links containing a Javascript call in the href attribute (e.g. javascript:myfunc()) are ignored by the link consistency check.

Note

You can run the link consistency check again.
Also note that the check takes some time and can lead to a high server load.

  1. Choose Menu -> Documents -> Link Consistency Check. If you are authorized to access the superuser group, you see the Script control dialog box.
  2. Start the link consistency check by clicking the Check link.
  3. If this is already running, you will see the remark Checking... instead of the link. In this case, you can end the already running check using the Stop button.
  4. Click Close to return to the dashboard.