Configuration Editor ( Pro,  Std, Lite)
The Configuration Editor is included in the professional edition. It allows you to specify your own tags, attributes, attribute values, character references, as well as create new tag name programs and edit other ones. The Configuration Editor may be confusing to use at first, but will become easier to use once you become more familiar with it and understand how it functions.
See the child topics for more information on using each tab of the Configuration Editor.
Push Buttons
- Close - Close the Configuration Editor.
- Load Config - Load a new configuration file over the current one. If the current configuration has changed and has not been saved, then you are asked if you want to load a new configuration file over the currently unsaved one.
- Save Config - Save the current configuration without asking for the filename.
- Save Config As - Save the current configuration to a file that you will be asked to specify.
- Set As Default - Set the currently loaded configuration file as the default configuration file to load when CSE HTML Validator is started.
- Help - Display help for the Configuration Editor.
Tag Names Editor ( Pro, Std, Lite)
This editor is available from the Tag Names tab of the Configuration Editor. This editor allows you to add new tag names and reconfigure existing ones. In addition, you can specify where tags can and can't be used by specifying the valid and invalid range.
List Boxes
- Tag names - This list box contains a list of tag names, like "p", "a", "title", "body", "html", "b", "i", etc. See below for the buttons used to add and delete tag names to and from this list box.
- (everywhere) - Any tag name with this assigned to its valid range will be valid anywhere in the document, regardless of any other ranges assigned.
- (first tag) - Any tag name with this assigned to its valid range will be valid if it is the first tag name in the document, in addition to the other ranges assigned.
- Tag range - Contains a list of tag names that specify where in the HTML document the tag name being configured may or may not appear. The tag name being configured may validly or invalidly appear as a tag between the start tag of any tag listed in the Tag range list box and its end tag. Priority is first given to built-in tag names (such as (everywhere) and (first tag)) then given to the most recently opened tag in the HTML document when calculating if the range of a tag is valid. To remove a tag name from this list box, select the tag name to remove and click the delete button (<-) or double-click the tag name to remove it. To add a tag name, select the tag name from the Tag names list box and click the add button (->) or double-click the tag name to add it. Use the Range View radio buttons to select whether the valid or invalid range is being viewed and edited. Note that if the valid and invalid ranges conflict, then the range of the tag is unpredictable.
Combo Boxes
- Tag Name Being Configured - Use this combo box to select a tag name to configure. The tag selected here is the tag whose configuration is being displayed and edited.
- Tag Name Category - Use this combo box to select which tag category the tag name being configured belongs to.
Push Buttons
- New Tag - Press this button to add a new tag name to the Tag names list box. The tag name that is added is the string contained in the edit box above the New Tag button. Note that the tag may not contain spaces.
- Delete Tag - Press this button to delete the tag name selected in the Tag names list box. Built-in tag names cannot be deleted. Also note that if you delete a tag name, then all other tag names that contain the deleted tag name in their range will no longer contain it.
Radio Buttons
- End Tag - Use these buttons (No end tag, Optional end tag, and Required end tag) to set the tag name being configured to require no end tag, have an optional end tag, or require an end tag.
- Range View - Use these three buttons to toggle the view in the Tag range list box. In order to change a range (add or delete a tag name from the Tag range list box), the correct view must be selected that corresponds to whether the valid range or invalid range is being viewed and edited.
Check Boxes
- Ignore to end tag - Check this box if you want HTML Validator to ignore all text (comments, tags, and entities) between the tag being configured and its end tag. You should set this only when the tag being configured requires an end tag. Note that though ignored, the text is still read and parsed, therefore, mismatched quotation marks may prevent the end tag from being found, as well as if the end tag is in a comment. Note that ignored text is still checked for high ASCII characters, if high ASCII character checking is enabled. Typically, this option is only checked for elements like "script" and "style". This option is not enabled by default.
- Warn if tag has no attributes - Check this box if you want HTML Validator to generate a warning if the tag being configured is used without any attributes. You may want to check this box for tags that are usually used or should be used with attributes. This option is not enabled by default.
- Display message when used - Check this box if you want HTML Validator to display the message in the Message When Used edit box when the tag being configured is used in an HTML document. This allows specific messages to be displayed to the user depending on the tags in the HTML document being validated. Note that even if a tag name with a displayable message is used multiple times, the message will display only for the first time the tag name is used. This avoids unnecessary repeats of the same message. This option is not enabled by default.
Programs Editor ( Pro, Std, Lite)
This editor is available from the Programs tab of the Configuration Editor. The Configuration Editor is only available in the professional edition.
The Programs tab in the Configuration Editor allows you to view and edit the tag name programs that are associated with the currently selected tag name or attribute being configured. The program for a tag name is executed each time the tag name is opened (or ended) in a document that is being validated. These programs are also called tag name programs because they are generally run when certain tags are encountered in a document that is being validated. They can also be run when certain attributes are encountered.
Radio Buttons
- Edit Program Type - Use these radio buttons to select the program to edit. Start tag name programs are run when tags are opened. End tag name programs are run when tags are ended/closed. When editing an open or end tag name program, you must specify for which tag the program belongs to by selecting a tag from the Tag Name Being Configured combo box. Text programs are run when text is encountered that is not in a tag. The start validation program is run just prior to beginning a validation and the end validation program is run at the end of the validation after all tag name and text programs have run.
Options
- Enable open program for tag - Check this box to enable the start tag name program for the tag name being configured. This option is not enabled by default.
- Enable end program for tag - Check this box to enable the end tag name program for the tag name being configured. This option is not enabled by default.
- Enable attribute program - Check this box to enable the attribute program for the attribute being configured. This option is not enabled by default.
Alternate Way of Editing Tag Name Programs
The tag name programs can be exported to an XML file for editing and then imported. This makes certain types of editing easier. These options are available in the integrated editor when the Options->Configuration Editor->Show Advanced Options menu item is checked. Use Export programs to c:\programexport.xml to export the programs to the file c:\programexport.xml and Import programs from c:\programexport.xml to import the programs back after editing. When using these import/export options, be sure to:
- Use & for & in the tag name programs.
- Use < for < in the tag name programs.
» |
