15.6 Site Reporting
The Clean Up HTML command is a great way to make sure your code is well-written.
But what if you forget about it until after you've built all 500 pages of your site? Do you
have to open each page and run the command梬hether there's a problem or not?
Fortunately, no. Dreamweaver's Site Reports feature makes identifying problems
throughout a site a snap. As well as locating the problems fixed by the Clean Up
HTML command, it makes Dreamweaver check your pages for other problems, such
as missing titles, empty Alt properties for images and other problems that might make
your Web site less accessible to disabled Web surfers.
To save time when running a report, you can exclude select folders from a Site Report operation using
the Cloaking feature described in Section 16.2.3.
After running a report, Dreamweaver displays a list of pages with problems. Unfortunately,
the Site Reports feature only finds problems; it doesn't fix them. You have
to open and fix each page individually.
To run a report on one or more Web pages, proceed like this:
The Reports window opens (see Figure 15-11).
From the Report On menu, select the files to analyze.
Dreamweaver can report on a single Web page, multiple pages, or even an entire
site. Choose Current Document to check the Web page that's open at the moment.
Entire Current Local Site checks every Web page in the local site folder, including
folders inside it. This option is great when you want to check your entire site prior to
uploading it to a Web server and making it "live" (more on that in Chapter 16).
Selected Files in Site checks only the files you choose in the Files panel. You need
to open the Files panel and select files in the local file list for this to work. See the
box in Section 220.127.116.11 for methods on selecting files in the Files panel. Choose this option
when you've modified or added pages to a site, and are ready to move them
to the Web server.
Dreamweaver's Site Reports feature makes quick work of
finding common page errors. It's also one of Dreamweaver's
many customizable features. You can download additional
types of reports from the Macromedia Exchange Web site or
even program your own. For more information on customizing
Dreamweaver and using Macromedia Exchange, see Section 20.2.1.
Folder checks all Web pages in a selected folder. After you choose this option, an
empty field and a folder icon appear. Click the folder icon; a dialog box gives you
the opportunity to locate and select the folder you wish to check, including any
folders inside it. You can also use this option when you wish to check pages that
aren't actually part of the current site.
Select the types of reports you want Dreamweaver to generate.
The Reports window is divided into two types of reports. The first set, Workflow
reports, mostly deal with features that facilitate working with others as part of a
production team (see the following chapter). The last option in this group桼ecently
Modified梚s new in Dreamweaver MX 2004. It generates a list of files that
have either been created or modified within a certain number of days or within
a range of dates (February 1 of last year to the present, say). When you run this
type, Dreamweaver lists the files in the Site Reports panel and opens a Web page
listing the files in your browser.
The Recently Modified site report looks for files created or changed in the last seven days, but you can
adjust that time frame. Select Recently Modified in the Reports window and click the Report Settings button
(Figure 15-11). A window appears like the one pictured in the box in Section 18.104.22.168, where you can change the
range of dates to check.
In fact, you'll probably find the technique described in Section 22.214.171.124 more useful. It not only identifies recently
modified files, but also selects them in the Files panel, giving you a lot more options for acting on this
information. For example, with those files selected you can upload them to your Web server, run Find and
Replace operations on just those files, or access many other tools.
The second type, HTML reports, are useful for locating common errors, such as
forgetting to title a Web page or forgetting to add an Alt property to an image.
Three of the HTML report options?span class="docEmphBold">Combinable Nested Font Tags, Redundant
Nested Tags, and Removable Empty Tags梥earch for pages with common code
mistakes. These are the same problems fixed by the Clean Up HTML command
The Accessibility report lets you see how usable your site is to people with disabilities.
This sophisticated command checks to see how well your pages conform to
Web accessibility guidelines mandated by the U.S. Government and recommended
by the W3C (Section 15.7). This option produces detailed reports, so it's usually best
to run it separately.
Turn on Missing Alt Text to search for pages with images that are missing an alternate
text description (Section 5.2.2). If you select the Accessibility option, you can
leave this turned off; the Accessibility analyzer already includes missing Alt text.
Finally, turn on Untitled Documents to identify pages that are either missing a
title or still have Dreamweaver's default title ("Untitled Document").
Dreamweaver analyzes the pages you specified. It then produces a report that lists
pages that match your report settings (see Figure 15-12). Each line in the Results
window displays the name of the file, the line number where the error occurs, and
a description of the error.
In the first release of Dreamweaver MX 2004, Dreamweaver also searches files that aren't Web pages,
like XML files that Dreamweaver produces behind the scenes. In Figure 15-12, you can see a file called banner.
lbi梐 Dreamweaver library file (see Chapter 17). Since a library file is just a snippet of HTML code rather than
a full Web page, it doesn't have a <title> tag (and shouldn't), so the error listed here is misleading.
This is one of the glitches that Macromedia hoped to fix in the 2004 bug-fix release. To see if the patch is
available as you read this, visit:
If you decide that the report
is taking too long, you can
always stop it by clicking the
icon in the lower-right corner
of the Results panel. It looks
like a red stop sign with an X
through it, and only appears
while a report is running.
In the Results panel, double-click the file to open it (see Figure 15-13).
Dreamweaver opens the file and automatically highlights the offending code.
The Site Report command won't identify XHTML syntax errors like those fixed by the Clean Up XHTML
command (Section 15.5).
Fix the problem according to its type.
For a page containing Combinable Nested Font Tags, Redundant Nested Tags, or
Removable Empty Tags errors, use the Clean Up HTML command as described
in Section 15.5.
For pages missing a title, add one using the technique described in Section 1.2.1.
For Accessibility problems, read the detailed discussion starting in Section 15.7.
You can add Missing Alt properties using the Property inspector, as described
in Section 5.2.2, but you may find it faster to use Dreamweaver's powerful Find and
Replace command (Section 19.3).
Continue opening files from the Results window and fixing them until you've
corrected each mistake.
The life cycle of a typical HTML error.
Top: After running a report, you might
find a common HTML error, like an
empty link tag. Select the page in the
Results window and click the Open
Second from top: The page opens
with the offending code selected in
Split Code view. (Dreamweaver often
highlights the problem HTML code so
that you can identify the problem.)
Since you can fix this particular
error梐nd more梬ith the Clean Up
HTML command, choose Commands
Clean Up HTML.
Third: The Clean Up HTML/XHTML
window opens. Even though you can
just clean up the error you identified
earlier, it won't hurt to clean up other
problems that might appear in your
code (and somewhere else in the site
report Results window). Click OK to
clean up the HTML.
Bottom: Dreamweaver reports back
to you. Mission accomplished梒ode
Unfortunately, Dreamweaver doesn't provide a quick, one-step method to fix any
of these problems. Except when using the Find and Replace tip for adding missing
Alt text, you must open and fix each page individually.
If you want to save the results of your report, click the Save Report button. Dreamweaver
opens a Save As dialog box, and lets you save the report as an XML file.