Read Me Page
Validate WCAG, Section 508, HTML, CSS, Links, and Spelling

General

If you have a problem that isn't covered below then complete the feedback form on the main website to report it. Don't forget to leave a valid email address where you can be contacted.

top

Total Validator doesn't start or displays an error message

Please ensure that you have the latest version of Total Validator installed.

If you are using macOS, read the macOS installation notes below.

If you have a start up issue then make a note of any error messages that may appear and use the feedback form to report your problem. Don't forget to leave a valid email address where you can be contacted.

top

macOS installation notes

A message appears saying Total Validator has an "unidentified developer" or is "damaged"

When you try to run Total Validator a message may appear saying that it has an "unidentified developer" or is "damaged". The fact that you've opened the .dmg file at all, means that the download was successful and it isn't damaged, so you don't need to download it again. This is a warning from the macOS Gatekeeper because you've downloaded Total Validator from the Internet. But you can still run it as follows:

  1. Open the Applications folder in Finder
  2. Control-click (or right-click) the Total Validator icon and choose "Open"
  3. Another warning will appear. Click the "Open" button to continue

Once Total Validator has run once, the warning should no longer appear, although it may reappear if you download an update.

If the above doesn't work, then it may be that you have configured macOS to only run apps downloaded from the App Store. In this case you will have to temporarily allow apps downloaded from the Internet:

  1. In System Preferences: Select Security & Privacy
  2. If required, click the lock icon that reads "Click the lock to make changes."
  3. On the "General" tab, change "Allow apps downloaded from:" to "App Store and identified developers'"
  4. Start Total Validator from the Applications folder as described above using Control-click (or right-click)
  5. You may then reset your security settings back to "App Store"

top

Symantec/Norton AV quarantines Total Validator

Note: If you obtained Total Validator from anywhere other than our website, you should check that the MD5 checksum of the file matches that provided on our download pages before using it. Or if your anti-virus program highlights a different issue than "WS.Reputation.1" or "Reputation" let us know before using it.

When certain Symantec/Norton AV products detect a program they have never seen, this is automatically marked as WS.Reputation.1 and placed into quarantine, even though it is completely safe to use. So the first thing to note is that you already have a copy of Total Validator, and that you should not need to download it again. Please consult your Symantec/Norton documentation in order to restore this file from quarantine and exclude it from further scans. In some cases this may mean installing a tool from their installation media or website.

We believe that each time a user takes the program out of quarantine and excludes it from further scans, the reputation of the program increases until WS.Reputation.1 is finally removed. However, Symantec's system resets with each new version, so this issue will reoccur with each new release of Total Validator. Because only a few of our users use these Symantec products, this issue may not be resolved before our next release.

We could try to preempt this issue by sending Symantec a free copy of each new version of every product we have for them to test. But they cannot provide any timescales for this testing, nor can they guarantee that our software will be safeguarded. If Symantec were a non-profit making organisation, and there was some real evidence that this whole thing was a good idea, we would still seriously consider this. But they are not, and there is no real evidence, and so we will not be pursuing that path. Instead we suggest that you carry out one of more of the following:

  • Restore the downloaded file from quarantine and exclude it from further scans (see above)
  • If possible, configure the Symantec product to avoid this issue in future
  • Replace the Symantec product with an alternative

top

My browser doesn't show the results

When the validation is finished your browser should start up and display the results. If this doesn't happen, first check that 'Hide results' in the Options menu has not been accidentally selected.

Otherwise try using the 'Last Results' button. If this doesn't work then (Pro version only) check the browser you have selected on the Results tab; a blank entry implies using your default browser. If nothing else is obviously wrong then it could be that you have a browser installed that is not set as the 'default'. You can correct this for popular browsers as follows:

Windows/Mac: For Firefox open the tools menu, select 'Preferences' and 'General' and then the 'Make Default' button. For Chrome open the tools menu, select 'Settings', then in the 'Default browser' section click 'Make Google Chrome the default browser'. For IE open the tools menu, select 'Internet options' then 'Programs' and click 'Make IE the default browser'. In all cases restart your browser and if necessary confirm it as your default then try running Total Validator again.

Linux: Edit the script TotalValidatorPro/app/default_browser.sh or TotalValidatorBasic/app/default_browser.sh as appropriate and check that it points to your preferred browser. As an additional check if you simply run this script without any parameters then your browser should just start up normally.

If you are still having problems then it may be that the results are stored somewhere inaccessible. Some organisations mount the Windows Documents folder (the default place for the results) on a network drive, which can cause problems with browsers. With the Pro version you can enter a different results folder on the Results tab. Otherwise you may have to open the folder where the results are stored and double-click the TotalValidator.html file to see the results.

top

A "Could not connect ..." message appears

This message appears when Total Validator cannot connect to the starting web page. So ensure that you can connect using the exact same URL in your browser first.

If you can see the page with your browser, it may be that there are one or more proxy servers between you and the page, or the page requires authentication to view it. Unfortunately, if you are using the Basic version there are no options available to allow you to authenticate yourself or to specify a proxy server, although you could use one of our browser extensions to validate the source code of the page. Total Validator Pro users should look to the options on the Network and Authentication tabs for further information.

If you are using the Pro version and you still can't authenticate yourself or drill through a proxy server, then then complete the feedback form on the main website to report your issue.

top

Fewer pages than expected are being validated (Pro version only)

By default Total Validator will only follow links on the same site as the starting page. So pages on http://mysite.com will not be validated because technically-speaking http://mysite.com and http://www.mysite.com could host completely different websites.

Any links embedded within javascript will be ignored, which may reduce the pages that will be checked. Note that using links within javascript is an accessibility failure and will also exclude those people who choose to disable javascript for security reasons.

Many options on the include tab can be used to restrict which pages are validated, so if you've set any options on this tab ensure you've read the documentation and understood how they work.

If you believe that the reason why so few pages are being validated is because Total Validator is not logging into a form correctly, then see the section on Login forms. The next section may be of use as well.

top

How do I validate multiple sites or areas (Pro version only)

Because Total Validator follows links, different parts of the same website that are not connected will not be validated. Also by default it will only validate pages on the same website as the starting page.

To get around this, create a simple web page consisting of absolute links to the various parts of your site, or listing different sites. This page may be saved to the local filesystem (i.e. no need to deploy it to a website). Then use this page as the starting page together with the Follow remote option.

The Follow remote option tells Total Validator to follow all links on the starting page only even those on different websites. Total Validator will then treat each link (on this first page only) as if was the starting page and report on all of the results together.

For finer control you can also use the Follow below, Exclude, Include and Depth options as well.

top

When I use AngularJS there are lots of errors

When AngularJS was first created it used attributes starting with ng-. This was a problem because they are not valid HTML and so cause validation errors. But this was fixed by the AngularJS team a long time ago and developers should now use attributes starting with data-ng- instead.

As the Wikipedia for AngularJS entry explains: "Since ng-* attributes are not valid in HTML specifications, data-ng-* can also be used as a prefix. For example, both ng-app and data-ng-app are valid in AngularJS."

If you are using AngularJS, you may wish to consider using our DOM validation option so that pages will only be validated after all the initial javascript has run.

top

My web pages are written using Javascript

Many modern websites are now written using a simple HTML web page and a Javascript framework or libraries to draw most of the web page. But Total Validator will normally just validate the simple HTML web page sent by your web server, because it does not execute any javascript itself.

To solve this problem use our browser extensions. These can send the DOM (the web page after the initial javascript has run) to the Total Validator application be be validated instead. So you can validate the web pages that your users actually see.

You can start a DOM validation from the application or the browser, whichever you prefer. With the Pro version you can validate an entire website this way with just one click.

top

Can I make it run faster?

There could be several reasons why Total Validator may appear to operate slowly when checking each page. Obviously it could be that your system has reached the limit of its own performance in terms of CPU power and/or the amount of available memory. However there are several things you can try to improve matters as listed below:

  • The broken links option waits for a response from the web server. If you do have any broken links then this will naturally slow down the validation. With the Pro version you can reduce the timeout from the default of 20 seconds and raise the concurrency (or set it to 0 for unlimited). Alternatively turn off the broken link check altogether.
  • The default method used to test links may send two requests and so take up to twice the timeout you've set before giving up. Explicitly setting the method to 'HEAD' or 'GET' will speed things up if you have any links that time out.
  • The spell check has a double impact on performance. It uses a lot of memory loading the dictionaries, and it can take time to spell check each word. So try turning this option off to see if this helps.
  • Try to limit the number of other applications that are running concurrently
  • When checking remote pages close any other applications that may be using the network

top

The HTML validation results are wrong

Unlike many popular validation services Total Validator uses the official W3C and ISO DTDs for HTML validation and the tests are automated from these. In other words we haven't personally made up the validation rules or translated them. So if Total Validator finds an issue on your page (or fails to find one) then it's highly likely that it's in the W3C DTD's and not a mistake in Total Validator.

Many other validators do not use the official DTDs but are interpretations of them. Because these validators do not use the official DTDs they tend to be rife with mistakes. A popular example is HTML Tidy, which as of writing says that the 'type' attribute in the <link> element is mandatory. But this is wrong and in most cases doesn't even make any sense.

However, the official DTD's cannot encode all the rules, because of the limitations of the DTD language. So we've added a whole lot of additional tests to cover these limitations. So other validators that only use the official DTDs may miss errors that are there in the standards. For example the W3C validator doesn't check the value of attributes and so will report success even when your page has many mistakes.

So before you report that another validator says that your page is okay, or reports errors that Total Validator doesn't pick up, please check the actual standards first, don't just assume the other validator is right. Note that we wrote Total Validator initially because of mistakes and limitations with other popular validators.

top

How do I check for Accessibility?

Remember that the accessibility standards are guidelines and not rules. They can't possibly cover every situation and are there to guide you into making good decisions.

To properly check a page for accessibility you need to understand the standard you are applying and manually look at the source and the output of the page. Validation tools such as Total Validator can only guide you and should never be regarded as a stamp of approval. Never let zero errors and warnings be your only target. Bear in mind that it is possible to write a web page that passes all the tests of all the validators and yet would still be difficult for people with disabilities to use. Equally, errors and warnings in validators are just there to alert you as to potential issues, and so may appear when there is actually no issue at all.

So we recommend that you always design your pages with accessibility in mind, and manually check them against the guidelines to ensure they meet your accessibility requirements. Use Total Validator to guide you and to help check for anything you may have missed, especially when making minor amendments.

With Total Validator we've tried to follow the spirit and meaning of the WAI and Section 508 guidelines, rather than blindly coding rules. So you may find many 'warnings' and 'notes' reported by other validators that simply don't appear in our results. But before you berate us, check out the guidelines themselves first, as you'll generally find that this tends to be generic advice that applies to any page, or false positives. With Total Validator we try to remove most of this 'noise' to make it easier to focus on what really needs addressing.

Also note that conforming to accessibility standards also means strictly validated HTML, so that accessibility technology can properly read your site. So you should always validate your HTML to ensure your site is truly accessible, and very few other accessibility tools can do this to the level of Total Validator.

top

An error message is displayed

Many error messages are self explanatory and should help you to correct the problem is yourself.

If you have a message that doesn't make sense then make a note of it and complete the feedback form on the main website to report your problem. Don't forget to leave a valid email address where you can be contacted.

top