django-output-validator 1.5

安装

• 运行 setup.py 将包安装到您的 python 路径。

• 将“output_validator”添加到您的 INSTALLED_APPS 设置中。

• 如果您已从您的 TEMPLATE_LOADERS 中删除 "django.template.loaders.app_directories.Loader"，则需要将“templates”文件夹添加到您的 TEMPLATE_DIRS 设置中。

• 将中间件 "output_validator.middleware.ValidatorMiddleware" 插入到中间件列表的早期位置（这意味着它将在其他所有内容之后获取响应对象）。它必须在执行后处理的每个中间件之后，但不能在 GZip 之后，因为它无法处理压缩的 HTML。（我在开发中禁用了 GZip 中间件）

• 修改您的 URL 配置以包含验证器的 URL。您需要在某处插入此行

  (r'^validator/', include('output_validator.urls'))

• 为应用程序添加一个设置，指定验证所使用的“validate”可执行文件的路径。这是一个mimetypes和相应验证器的字典，允许此应用程序扩展到任何其他生成的内容

  OUTPUT_VALIDATOR_VALIDATORS = {
    'text/html': '/usr/bin/validate',
    'application/xml+xhtml': '/usr/bin/validate',
  }

  我通常为此可执行文件使用一个小包装器，当它失败时弹出消息 - 以下适用于GNOME（如果您已安装notify-send程序）

  #!/bin/sh
  validate "$1" || {
      notify-send "Validation failed";
  }

• 最后，运行django admin脚本来设置数据库表

  ./manage.py --settings="yourproject.settings" syncdb

  或者，如果您使用South

  ./manage.py --settings="yourproject.settings" migrate output_validator

• 可选地设置以下设置

  • OUTPUT_VALIDATOR_IGNORE_PATHS - 这是一个将被忽略的路径前缀列表。例如，如果您在/admin/下有管理员，您可以使用此选项忽略管理员中的任何错误

    OUTPUT_VALIDATOR_IGNORE_PATHS = [
        '/admin/',
    ]

用法

在开发过程中浏览您的任何页面时，所有HTML都将进行验证。如果失败，它将被记录。您可以在“http://localhost:8000/validator/”查看所有失败（假设本地开发和上述URL conf）。

变更日志