我如何做HTML+WAI-ARIA文档的独立/离线验证



在w3.org的新HTML5验证页面上测试WAI-ARIA验证是有帮助的,但是我如何在没有互联网连接的情况下进行独立验证?

我想到了CI集成;所以,我怎样才能得到纯文本输出(而不是HTML输出),可以稍后解析或至少由詹金斯存储?

下面是如何使用独立的Nu Html检查器从命令行检查文件:

java -jar ~/vnu.jar FILE.html FILE2.html FILE3.HTML FILE4.html...

默认情况下,结果以纯文本形式发出,每个错误或警告一行,以标准GNU错误格式,带有文件名,行+列号和实际的错误/警告消息;因此,您得到的结果中的每一行都将采用这种格式:

"FILE.HTML":76.1-76.23: info warning: Section lacks heading. Consider using “h2”-“h6” elements to add identifying headings to all sections.

许多现有的工具(例如,gcc和其他编译器,emacs等)都内置了对这种格式的错误输出的支持,所以它应该很容易插入到你的Jenkins或Travis或其他CI设置中,或者插入到你想要使用的任何管道中。

但是如果你想的话,你也可以得到JSON或XML输出;有关如何使用该工具的详细信息请访问https://validator.github.io/validator/#usage。此外,还有一些包采用独立的检查器,并在其周围包装特定的前端,用作常用任务运行器的插件:

  • grunt-html -Grunt插件的HTML检查
  • gulp-html -Gulp插件的HTML检查

更多细节

独立的HTML检查器与W3C验证器的代码完全相同,但是打包成一个可运行的jar;因此,您可以将其集成到CI自动化中,并一次批量检查多个文件,或者遍历整个目录树,并且您可以编写脚本来调用它并对其输出执行操作。

最新的信息可在以下地方获取:

  • https://github.com/validator/validator/releases/latest
  • https://sideshowbarker.net/releases/jar/

全面披露::我是这个独立版本的检查器的开发人员,我是它使用的核心代码的共同开发人员[以及在线W3C HTML检查器(又名验证器)服务的维护者]。所以我非常欢迎bug报告和特性请求

最新更新