我们在这里提供的安装指南是一套相当通用的说明,这应该在大多数系统上都有效。据我们所知,以下平台特定还提供了指南,可能感兴趣:
相关文件
本安装指南假定您了解源可用性对于标记验证程序。
我们建议开发人员希望对加价验证程序进行贡献或修改完成此安装过程一次,以熟悉系统。
在打包系统上安装
安装Markup Validator发布版本的最简单方法是使用创建的包对于贡献者提供的一些平台:Mac OS X、openSUSE/SUSE Linux、Debian GNU/Linux和Fedora/Red Hat软件包可获得的.
从源安装(通用情况)
这些说明受到Nick Talbott的Slackware Linux指南的强烈启发。谢谢Nick!
安装指南假定您有一个工作正常的Web服务器。我们建议流行的Apache服务器,用于W3C标记验证服务。验证器可以与流行的Apache以外的其他Web服务器一起工作,但我们不能保证它会这样。您还需要一个有效的安装Perl语言(大多数Web服务器上的标准)。
步骤0:先决条件
除了正确配置的Web服务器外,Validator还需要一个SGML解析器——它完成了所有的繁重工作——Perl(5.8.0版或更新版本)和“检查”CGI脚本使用的几个Perl模块。
以下几个步骤将指导您安装这些先决条件,然后是验证器本身
步骤1:安装OpenSP,SGML(和XML)解析器
我们当前使用的SGML解析器是OpenSP 1.5.2
,可以在上找到OpenJade主页.请注意,验证器不能与1.5.2之前的任何OpenSP版本一起使用。
如果从源代码安装opensp,请确保启用DTD的HTTP检索。禁用文档的生成
以root/administrator身份或在sudo下运行以下命令
[解压缩opensp]./configure--启用-http--禁用文档构建制作进行安装
步骤2:安装所需的Perl模块
快速简便:安装CPAN捆绑包
一种简单且强烈推荐的方法来解决所有这些问题Perl模块依赖项是安装捆绑式W3C-Validator来自CPAN。请参阅包含的文档了解更多详细信息。
以root/administrator身份或在sudo下运行以下命令
perl-MCPAN-e外壳[cpan shell启动,您可能需要回答配置问题]安装捆绑包::W3C::Validator
供参考:所需的Perl模块发行版列表
如果您已成功安装上述捆绑包,则可以跳过此步骤.
下面是运行Markup Validator所需的Perl模块。此列表提供了信息,如果遵循CPAN说明以上。
- CGI.pm公司>= 3.40
- 全唱全舞,一切-和-kitchen-sink,Perl CGI库。这个为我们处理所有这些琐碎的CGI,并使选项解析和文件上传轻而易举。
- 配置-概述>= 2.32
- 配置文件处理。
- 编码和编码-HanExtra
- 支持多字符编码。
- HTML处理器>= 3.60
- 用于预分析和查找元数据的最小HTML解析器。
- HTML编码
- 确定HTML/XML/XHTML文档的编码。
- HTML模板>= 2.6
- 模板系统,允许我们将Validator的逻辑和演示。
- JSON格式>= 2.00
- JSON输出支持。
- libwww-perl>= 5.802
- Gisle Aas最优秀的Perl WWW库。这是我们的对从网上下载页面的支持来自。5.802版需要或更新,但我们强烈建议使用(更)更新的版本。宣布验证程序支持压缩响应使用
接受编码
版本5.816的HTTP标头以及更高版本,这取决于libwww-perl是否需要模块安装了压缩设备。如果您希望验证程序支持SSL协议/TLS公司,请参阅自述。SSL协议包含在libwww-perl发行版中。
- 网络IP
- IP地址操作。
- SGML-处理器-开放SP>= 0.991
- 与的接口OpenSP解析器.
- URI(URI)>= 1.53
- 库来处理URI并转义其中的特殊字符。
- XML-LibXML>= 1.73
- 的Perl绑定libxml2语言,已使用检查基于XML的文档类型的语法。除了版本要求,XML-LibXML需要在构建时支持libxml2结构化错误,即libxml2>=2.6.21。
供参考:可选Perl模块发行版列表
下面列出的Perl模块是可选的;验证器将使用如果可用,它们将提供一些额外的功能。
- 编码-JIS2K
- 支持其他日语字符编码。
- HTML时尚
- HTML-Tidy用于生成提交的标记。
步骤3:下载验证器和DTD
下载Validator代码、配置和DTD库来自github储存库主分支。
步骤4:打开验证器的包装
为验证器的安装创建一个目录。在基于Unix的系统上,我们建议使用默认文件夹/usr/local/markup-validator
.这个目录将被称为[验证程序路径]
贯穿本指南。
-
cd/usr/local;git克隆https://github.com/w3c/markup-validator.git(网址:https://github.com/w3c/markup-validator.git)
.
这个[验证程序路径]
目录现在应该有命名的子目录cgi-bin数据库
,htdocs公司
,和和分享
.
-
创建目录/等/w3c
并复制所有文件从[validatorpath]/htdocs/config/
你可以继续配置文件,但必须修改Web指向配置目录的服务器环境变量。由于这可能很繁琐,我们建议使用/etc/w3c等
.
-
编辑/etc/w3c/validator.conf
以反映文件的位置并将其他参数配置为你希望如此。此文件注释良好,修改时应相对简单。
一般来说,您只需要检查基本路径设置为您解压缩验证器的位置文件夹。如果您使用过/usr/local/validator
你不需要改变一切
Base=/usr/local/validator
如果计划在专用网络上验证文档,则需要启用中的以下选项验证器.conf
文件:
允许私有IP=是
如果您想检查文档是否符合(外部和实验性)HTML5检查员,你可能想安装验证器.nu引擎并在validator.conf文件中使用以下命令启用它:
<外部>##启用通过外部服务检查文档HTML5=http://localhost:8888/html5/ </外部>
现在,您可以在将验证程序脚本插入Web服务器之前对其进行测试:
#cd/usr/local/validator/#cd cgi-bin光盘/# ./检查uri=网址:http://www.w3.org/…
脚本应该输出原始的HTML验证结果。如果这不起作用,请仔细检查到目前为止,您已经正确地完成了所有步骤。
参考:配置文件列表
除非您计划修改验证器的默认行为,否则可以跳过此操作。.
- 验证器.conf
- 验证器的主配置文件。这将通常是您需要编辑的唯一文件。它设置各种参数,例如:维护者的地址、各种文件路径和位置,是否美国石油学会已启用等。
- 字符集.cfg
- 将字符集映射到验证器的转换参数内部UTF-8转换。
- 类型.conf
- 将MIME/HTTP内容类型映射到内部“文档类型”用于以不同的方式处理HTML、XML和XHTML。
以下说明适用于Apache Web服务器,应该进行调整如果您计划使用另一台服务器。
-
如果您使用的是Apache服务器,则可以使用mod_perl2下的验证器。如果您正在使用随验证器一起分发的httpd.conf片段或类似内容,并且您的Apache服务器已安装并启用mod_perl2,那么这应该会自动发生。使用mod_perl2将带来重要的性能优势,但尚未进行广泛测试。如果您在mod_perl下成功运行了验证器,或者在这样做时遇到了问题,联系我们.
同样值得在Apache中启用的是mod_expires,它将允许缓存验证器的静态文档、样式表和图像。
-
编辑Web服务器的配置以引用验证器的特定配置文件。
可以通过插入httpd/conf/httpd.conf(httpd.conf)
在您的httpd.conf网址
,或通过将文件复制到某个位置并包括如下内容:
包括/where/you/copted/it/httpd.conf
然后,开始编辑验证器特定的部分。
您可能希望为服务设置“虚拟服务器”。这是可以做到的通过添加类似以下内容:
<VirtualHost 127.0.0.1>文档根[validatorpath]/htdocs/服务器名称验证器.example.org</VirtualHost>
和/或您可能希望在特定位置提供服务在Web服务器上,可以按如下方式进行配置:
别名/validator/[validatorpath]/htdocs/
配置环境变量情感验证器的外部连接如果需要(例如http_代理
),请参阅提供的示例httpd.conf网址
和LWP公司和净值::FTP文档。
完成编辑此HTTP服务器配置文件,调整反映安装中使用的路径的所有目录引用。
现在重新启动Web服务器以激活更新的配置。
对于Apache这是通过以系统管理员身份在shell中键入以下内容来完成的:阿帕赫特尔·格雷斯
(或者,对于Apache的旧版本电容器配置测试
然后apachectl重启
)
步骤7:检查安装
将浏览器指向新站点。
检查Web服务器的错误日志以获取可能出错的线索如果出现任何服务器错误。
帮助我们通过向我们发送您的反馈来改进此安装指南如果您在本地系统上安装验证器!
对新安装进行故障排除
对安装不完整或失败的标记验证器。虽然本页中给出的说明应该有助于大多数人在他们的系统上成功安装验证器,运气不好,忘记了一步或者一个损坏的组件会让事情变酸。
仔细检查安装步骤
如果安装失败,首先要做的是检查您是否没有忘记安装时的任何步骤。正确复制和编辑配置文件是常见的例如,错误。
检查日志
Web服务器的错误日志应该是查找有关以下内容的提示的好地方您的安装有误。
检查依赖项
新安装的验证器的一个常见问题是验证器显然正在运行但将任何内容标记为“无效”,而不将任何错误消息作为输出。
这是OpenSP的典型问题。交叉勾选你实际上有一个版本1.5以上,通过运行onsgmls—版本.
奇迹调试选项
如果验证器行为不正常,可以尝试通过附加到以下字符串的URL:&调试=1
这有时会向您提供在中任何位置都不会出现的错误消息非调试模式,有助于诊断问题
如果全部失败。。。
请随时联系公共邮件列表www-validator@w3.org所有的细节你可以提供你做了什么,尝试了什么,出了什么问题。。。
安装后选项
如果安装成功,您现在应该可以自己使用标记验证程序系统和网络。您可能希望为验证器提供特定于您的网站的外观。实现这一点的最简单方法是编辑页眉.html
和页脚.html
(位于htdocs公司
目录),用于构建所有验证程序的页面。
您还可以编辑样式表(在同一目录中),尤其地基本.css
然而,您可能也希望避免编辑其他CSS文件严重的是,存在使验证器输出不可用的风险。
如果编辑任何*.css或*.js文件,请确保更新gzipped编辑文件的版本以及安装的版本和内容在您的设置中启用了对它们的协商(如果验证程序是按照这些说明安装的)。