Viewing and Applying Markup Suggestions

The Markup Suggestions window pane lets you see a list of files where the XHTML markup (code) can be improved (e.g., empty tags, CDATA tags, empty attributes, excessive spaces). When the analysis tool finds markup issues, there are a couple of ways that you can "clean them up." First, you can click the Apply button in the local toolbar to automatically apply the suggestions to the selected files. Alternatively, you can double-click a row to open that file and work on the issues manually. You may be able to fix some issues for a specific file in the XML Editor. Other issues may require you to open the behind-the-scenes code in the Internal Text Editor.

How to View Markup Suggestions

  1. Open a project.
  2. Do one of the following, depending on the part of the user interface you are using:

    • Ribbon Select Analysis > Suggestions > Markup Suggestions.

    • Summary Window Pane Double-click the row that mentions markup suggestions.

      The Markup Suggestions window pane opens.

  3. To see more of the information in the window pane, drag the divider bar to make the pane wider.

    • Suggestion Displays the suggestion to resolve the issue (e.g., "Remove empty attribute," "Make single space").
    • Context Displays the context of the issue in question, along with a tag if applicable for the suggestion (e.g., img, p, h1, li). For example, if the issue is that a tag has an empty attribute, this shows the tag and name of the attribute within it.
    • File Displays the name of the file.
    • Title Displays the properties title of the file (if any).
    • Folder Displays the folder where the file is found.

    List of files where XHTML markup can be improved.

  4. If a certain number of items have been found, page navigation buttons in the local toolbar may be enabled. You can use these buttons to go to additional pages to display more items. You can also click View All in the local toolbar to see all results on a single page. Keep in mind that the more items you have in the project, the longer it will take to load this view.

How to Apply Markup Suggestions Automatically

  1. View the markup suggestions.
  2. In the Markup Suggestions window pane, select all issues that you want to resolve. If you want to select all rows click Click to select all rows.. You can hold the SHIFT key to select a range, or you can hold the CTRL key to select individual items.
  3. In the local toolbar, click the Apply button.

    List of files with XHTML code and how to apply the improved suggestions.

  4. A message asks if you want to apply the selected suggestions. Click OK.
  5. If your Backups folder is not empty, a message asks if you want to empty it and continue. If so, click OK.
  6. Click OK once more.

    Note If you want to undo the conversions, you can use the Backups window pane (View > Backups). See Restoring Backup Files.

How to Resolve Markup Issues Manually

  1. View the markup suggestions.
  2. You can open any file in the list to view or modify it in an editor. You can either double-click on the specific row, or right-click on the row and select Open.

  3. If necessary, you can open the file in the Internal Text Editor to work directly in the markup.

What’s Noteworthy?

Note You can also include this information in reports that you create. See Reports.

Note You can customize the suggestions that are shown in the Markup Suggestions window pane. See Customizing Markup Suggestions Shown.