Fixing broken links using the Fixup link references wizard

The Fixup link wizard locates and corrects broken links in a selected resource. This wizard is useful as a general clean-up tool or if you move a file that you know is a target of several links.

To fix a link using the Fixup link references wizard, complete the following steps:

1. Right-click a resource (a project, folder, or file) from the Project Navigator view.

2. Select Link Utilities > Fix Broken Links; the Fixup Link References wizard opens. The wizard populates the table with the broken links, the suggested fixed link, and the location of the broken link. Each link is set to either be fixed or skipped.

3. Select how you want the links to be structured by choosing one of the following styles from the pull-down menu: Use existing style, Use document relative links, Use document root relative links; the Fixed Link column is updated to reflect the structure selection.

4. Check the Group links that go to the same destination check box to group all of the broken links that point to the same location into one row in the table. Any change you make to that grouped row will be applied to all instances of that broken link.

5. For each broken link, indicate whether the wizard should Fix or Skip the link by clicking the icon to the left of the row to cycle through the different options, or by selecting a row and clicking the buttons to the right of the table.

   Each time you change a designation, the counter at the bottom keeps track of how many link are selected to be fixed or skipped.

6. Ensure the link text in the Fixed Link column is accurate.

   Initially, this column may appear blank if the wizard can not find a suggested way to fix the broken link. You can manually edit the text of the fixed link by clicking in the Fixed Link column, double-click a link, or select a row and click Suggestions for suggested ways to fix the link.

   • Select one of the suggestions in the Suggestions field to populate the Fixed Link field. (Links to resources within the current project are listed above suggestions to links to resources in external projects.) All suggestions are structured with paths relative to the document root; however, the Fixed Link field in the Fixup Link Reference wizard will be populated according to the structure you designate.

   • Alternately, click Browse to locate the location of the link target manually. You can browse for a File, Servlet, or Class.

   Click OK when you are satisfied with the new link.

   The Fixed Link field is populated in the table in the Fixup Link Reference wizard.

7. When you are satisfied with your selections and the fixed link values, click Fixup Links. The links will all be updated to reflect the values in the Fixed Link column.

When deciding how to fix the broken link, it may also be useful to look at the Context view, which displays the source where the broken link is located. Select a different broken link row in the table and the Context view is refreshed with the source surrounding the selected broken link.

Another feature of this wizard that may be helpful when fixing broken links is the ability to sort the broken links by location. Clicking the Found in Page heading will sort the rows by their location. This may be useful if you want to correct broken links based on their page location.

 

Related concepts

Managing links - overview