Broken Pages Overview
This report will show you any broken dependencies that are on any pages in which you have access. A page gains dependency when it uses an external source for content, such as using an asset or linking to another page. It then "depends" on the external content to exist. Therefore, it becomes an issue when the directory, page, binary file, or asset is deleted. The system updates the links should a directory or page be renamed or moved, but those that are deleted still need to be repaired manually. This report will not show broken links from within Assets.
The list of broken pages is specific to the content in which you have access. This makes changing or fixing the links easier and can be used on a page-by-page basis. You can click the linked page or hover and click Preview, to see the broken link in the Preview mode for the page.
Once the page has been edited to address the dependency issue, it is removed from the Broken Pages report.
Broken Links and Dependency Tags
When a dependency is lost; for example, a linked-to page or a subscribed-to asset is deleted, the dependency tag or asset tag, path, and file name are shown within asterisks. For example:
*** Broken f:1234 /funnymonkeys/brokenpage/index.php***
*** Broken a:52 Funnymonkeys_Test_Asset: Image Gallery Asset ***
Broken links are reported in the following locations:
- Page Preview
- WYSIWYG Editor
- Page-based Link Check
- Publish-based Link Check
- Broken Pages
Additionally, the broken link reporting may appear slightly differently depending upon where viewed.
Preview View / Edit View
From the Broken Pages list view, click the linked file name to Preview or Edit the page. The broken link information is shown encapsulated in asterisks.
Broken Asset in Preview and Edit Mode
Status Bar View
When previewing a page, a broken link is displayed in the status bar (if the status bar is available in a browser) when the cursor hovers over the link. This is functional for dependency tags.
Broken Dependency Tag in WYSIWYG Editor
Broken dependency tags are not shown in the WYSIWYG editing area. A tag structure can be modified to show a broken indicator. It is shown in the Insert/Edit Link dialog.
Modifying the Broken Link Indicator in WYSIWYG Editor
It is possible to configure the URL on the page to indicate that the link is broken when in the WYSIWYG. In this case, a broken link will appear similarly to that of an asset with hash marks. In order for this option to be available, the URL will have to be displayed as part of the page content.
- Copy the Dependency tag.
- Access the source through the HTML button in the toolbar.
- Find the Dependency tag and link.
- Replace the text being displayed on the page with the Dependency tag.
- Save the changes.
This will display the URL on the page.
Keep in mind that the dependency tag will render the root relative URL if it is pointing to a page within the same site. Add the root to the tag text should the desired effect be that the whole URL appears on the page.
Example Modification Syntax
This will then create an asset-like hash box around the dependent part of the link in the WYSIWYG view.
If the linked page is deleted, dependency tag, path and file name are displayed within the asterisks and with the asset-like hash box:
Broken Asset in WYSIWYG Editor
Within the WYSIWYG Editor, a broken asset indication is shown in the editing area. It includes an a gray striped wrapper and text indicating that the asset is broken.
Deleting a Broken Dependency Tag from the WYSIWYG Editor
Within the WYSIWYG Editor, the broken link reporting is shown within the Insert/Edit Link dialog.
To view in the Insert/Edit Link dialog:
- Select or position the cursor on the link in question.
- Click the Link icon on the WYSIWYG toolbar
- This displays the Insert/Edit Link dialog. The broken link with the path and file name is displayed below the Link URL box.
- To remedy the broken dependency tag, perform one of the following actions:
- Delete the tag from the Link URL field
- Select another page by clicking the Browse icon
- Enter the URL of a page to which to link
Deleting an Asset Tag from the WYSIWYG Editor
- Navigate to the Edit mode of a page and select the appropriate editable region.
- Find the broken asset wrapper. It will appear in gray.
- Click anywhere on the asset wrapping and press the Delete key.
- To confirm the delete, click OK.
NOTE: This will delete the content that was being produced by the asset, which may or may not need to be replaced in order to complete the page.