PyCharm 2017.1 Help

Validating Web Content Files

On this page:

Types of validity checks

PyCharm performs two different validity checks:

  • On-the-fly validation is available for all Web content files and is performed as you edit the file. PyCharm checks well-formedness, that is, detects various violations of syntax requirements, such as unclosed tags, wrong end-tag name, duplicate tags, unresolved links, etc. All encountered errors are highlighted in the editor.

    However, this form of code validation is rather soft, that is, not all requirements are taken into account.

  • Full validation involves structure validation in addition to well-formedness check. Full validation is available for files that are associated with an XSD (XML Schema Definition) Schema or contain a Data Type Definition (DTD). PyCharm checks whether the structure of your XML file complies with the structure defined in the corresponding DTD or Schema.

    The results of full validation are provided as a Message View.

Choosing the default HTML language level

Normally, an HTML or an XHTML file has the <!DOCTYPE> declaration which states the language level of the used in the source code from the file. This language level is used as a standard against which the contents of the file are validated. If an HTML or an XHTML file does not have a <!DOCTYPE> declaration, the contents of the file will be validated against the default standard (schema).

  1. Open the Settings / Preferences Dialog by pressing Ctrl+Alt+S or by choosing File | Settings for Windows and Linux or PyCharm | Preferences for macOS. Expand the Languages & Frameworks node, and then click Default XML Schemas under Schemas and DTDs.

    The Default XML Schemas page opens.

  2. In the Default HTML Language Level area, choose the default schema to validate HTML and XHTML files without a <!DOCTYPE> declaration. The available options are:
    • HTML 4 or HTML 5: Choose one of these options to have files treated as HTML 4 or HTML 5 and validated against one of these standards.
    • Other doctype: Choose this option to have HTML files by default validated agains a custom DTD or schema and specify the URL of the DTD or schema to be used.

      Note that code completion is available in this field: press Ctrl+Space to see the list of suggested URLs.

      /help/img/idea/2017.1/defaultHtmlLangLevel.png
    choose the XSD (XML Schema Definition) Schema to validate XML files. The available options are:

Choosing the default schema to validate XML files

  1. Open the Settings / Preferences Dialog by pressing Ctrl+Alt+S or by choosing File | Settings for Windows and Linux or PyCharm | Preferences for macOS. Expand the Languages & Frameworks node, and then click Default XML Schemas under Schemas and DTDs.

    The Default XML Schemas page opens.

  2. In the Default XML Schema Version area, choose the XSD (XML Schema Definition) Schema to validate XML files. The available options are:

Running full validation on an XML file

  1. Open the desired XML file in the editor, or just select it in the Project tool window.
  2. On the context menu, choose Validate.

See Also

Last modified: 26 July 2017