Markup 검증 서비스
웹 문서의 마크업(HTML, XHTML, …)을 검사 하십시오
Markup 검증 서비스
웹 문서의 마크업(HTML, XHTML, …)을 검사 하십시오
Markup Validator 의 릴리즈 버전을 설치하기 위하 가장 쉬운 방법은 공헌자들에 의하여 특정 플랫폼을 위해 만들어진 패키지를 이용하는 것입니다: Mac OS X, openSUSE/SUSE Linux, Debian GNU/Linux, Fedora/Red Hat을 위한 패키지는 여기에서 받을 수 있습니다.
우리가 여기서 제공하는 설치 문서는 거의 모든 시스템에서 작업을 할 수 있습니다. 하지만 다음의 리스트들은 특정 플랫폼에 따른 가이드를 제공하며, 흥미를 가질만 합니다:
이 설치 가이드는 Markup Validator 의 소스코드에 대한 설명서입니다.
Markup Validator 에 공헌 또는 수정을 원하는 개발자라면, 이 시스템에 익숙해 질 수 있도록 이 설치 절차를 진행해 보기를 권장합니다.
이 문서는 Nic Talbott 의 슬랙웨어 리눅스 가이드를 참조하였습니다. 고맙습니다. Nick!
설치 가이드는 당신이 운영중인 웹서버를 가지고 있다고 가정을 합니다. 우리는 W3C Validation 서비스를 위해서 대중적인 아파치 웹서버를 사용할 것을 권장합니다. validator 가 apache 보다 다른 서버에서 더 작동을 잘 할지는 모르겠지만, 우리는 다른 웹서버에서 발생할 일에 대해서는 보장을 할 수 없습니다. 또한 (모든 웹서버에 거의 설치가 되어 있겠지만..) Perl 언어 설치 작업이 필요할 수도 있습니다.
웹서버의 설정은 기본이며 Validator 를 위해서는 - 모든 작업을 제대로 하기 위한 - SGML 파서가 필요 합니다. "check" CGI 스크립트를 작동하기 위해서는 펄 (5.8.0 이상) 과 여러가지 펄 모듈들이 필요합니다.
다음의 몇 단계는 validator 설치와 필요한 사전 준비를 도와 줍니다.
SGML 파서는 현재 OpenSP 1.5.2를 사용하고 있으며, OpenJade 홈페이지에서 받을 수 있습니다.
OpenSP 1.5.2 이전 버전으로는 Validator를 작동 하려고 시도하지 마십시오. 작동하지 않습니다.
역주: 오래전 배포본에는 OpenSP 가 openjade 패키지에 포함이 되어 있는 경우가 있습니다.
W3C HTML validator 0.8 부터는 OpenSP 1.5.2가 필요하기 때문에 openjade 패키지에 포함이 되어
있을 경우에는 OpenSP 를 다른 경로에 따로 설치 하시기 바랍니다. RHEL/CentOS 에서는 Fedora의
OpenSP source rpm 을 리빌드하여 설치 하십시오.
소스 설치를 한다면, DTDs 검색을 위해 HTTP를 활성화 하고 문서 생성을 비활성화 합니다.
다음의 명령을 root/administrator 권한 또는 sudo를 이용해서 실행 하십시오.
[unpack opensp] ./configure --enable-http --disable-doc-build make make install
쉬운 방법으로는 - 강력하게 권고하는 방법 - 의존성이 걸린 이 모든 펄 모듈들을 포함하고 있는 Bundle-W3C-Validator 을 CPAN 에서 설치하는 것입니다. 이 번들에 대한 자세한 사항은 여기를 참조 하십시오.
root/administrator 또는 sudo 명령을 이용하여 실행 합니다.
perl -MCPAN -e shell [cpan shell starts, you may need to answer configuration questions] install Bundle::W3C::Validator
위의 번들을 성공적으로 설치했다면 이 과정은 넘어가십시오..
다음은 Markup Validator를 실행하는데 필요한 펄 모듈입니다. CPAN instructions를 사용한다면, 이 리스트들을 개별적으로 설치할 필요가 없습니다.
Accept-Encoding HTTP header with version 5.816
and later, depending on if the modules required for libwww-perl's
compression facilities are installed. If you want your Validator to
support SSL/TLS, see
README.SSL
included in the libwww-perl distribution.
다음의 펄 모듈들은 옵션입니다; validator는 이 모듈들을 사용한 경우, 몇몇 특수 기능에서 사용하게 됩니다.
이 사이트에서 Validator Tar Ball과 DTD library를 다운로드 합니다.
또는, 가장 마지막 개발 버전으로 작업을 하고 싶다면, 우리의 머큐리얼 저장소에서 받을 수 있습니다. 하지만, 제대로 작동하지 않을 수 있으니, 조심하셔야 합니다.
(소스와 관련된 정보는 여기에서 참조 하실 수 있습니다.)
validator 를 설치할 디렉토리를 생성합니다. Unix 기반의 시스템에서의기본값은
/usr/local/validator 입니다. 이 디렉토리는 이 가이드상에서
[validatorpath] 로 업급이 될 것입니다.
validator 와
DTD library 압축 파일을 임시
디렉토리에 풀어 놓은 다음, validator-X.Y 에 있는
htdocs, httpd/cgi-bin, share를
[validatorpath]에 복사 합니다.
# tar zxvf validator.tar.gz # tar zxvf sgml-lib.tar.gz # mkdir /usr/local/validator # cd validator-X.Y # mv htdocs share httpd/cgi-bin /usr/local/validator
[validatorpath] 디렉토리에는 이제 cgi-bin, htdocs,
share 라는 3개의 서브디렉토리가 존재하게 됩니다.
/etc/w3c 디렉토리를 생성한 후, [validatorpath]/htdocs/config/의
모든 파일을 복사 합니다. 설정 파일을 다른 곳에 위치 시켰다면, 설정 파일이 있는 디렉토리를
웹서버 환경 변수를 수정하여 지정해 주도록 합니다. 지겨울 수 있겠지만, 우리는
/etc/w3c를 사용하는 것을 권장 합니다.
설치된 파일들을 반영하고, 원하는 다른 파라미터들을 설정하기 위하여
/etc/w3c/validator.conf를 수정 합니다. 이 파일은
주석이 잘 되어 있으며, 상당히 직관적으로 수정할 수 있습니다.
일반적으로, validator 파일이 풀어져 있는 곳이 Base path에 잘 설정이
있는지 확인할 필요가 있습니다. /usr/local/validator를
사용하고 있다면 따로 변경할 필요는 없습니다.
Base = /usr/local/validator
사설 네트워크에서 문서를 validate할 계획이 있다면 validator.conf 파일의
다음 옵션을 활성화 해야 합니다:
Allow Private IPs = yes
(외부 그리고 실험적인) HTML5 검사기로 문서를 검사하기를 원한다면, validator.nu 엔진을 설치하고, validator.conf 파일에 다음의 설정을 하십시오:
<External> ## Enable checking documents via external services HTML5 = http://localhost:8888/html5/ </External>
웹서버에 추가하기 전에 validator 스크립트를 테스트 할 수 있습니다:
# cd /usr/local/validator/ # cd cgi-bin/ # ./check uri=http://www.w3.org/ …
스크립트는 validation 의 원시 HTML 결과를 출력합니다. 제대로 작동하지 않는다면 상단의 단계들이 정확하게 이루어 졌는지 다시 확인해 보도록 합니다.
validator의 기본 행동을 수정할 계획이 없다면, 이 부분을 건너 뛰기 바랍니다..
다음의 아파치 웹서버의 소개입니다. 만약 다른 서버를 이용할 계획이라면 알아서 하셔야 합니다.
Apache 서버를 사용한다면, mod_perl2를 이용하여 validator를 구동할 수 있습니다. validator나 다른 유사한것으로 부터 배포되는 단편적인 httpd.conf를 사용할 경우, 그리고 mod_perl2가 설치되어 있다면 자동으로 작동을 하게 됩니다. mod_perl2를 사용하면 성능에서 상당한 이득을 볼 수 있습니다. 하지만, 넓게 테스트 되지는 않았습니다. mod_perl을 이용하여 validator를 잘 구동하고 있거나, 또는 문제가 있다면 개발자에게 피드백을 주시기 바랍니다.
또한, Apache의 mod_expire를 사용하면, validator의 정적인 문서, 스타일 시트, 이미지를 캐싱하도록 할 수 있습니다.
validator 를 위한 특정 설정 파일을 언급하기 위하여 웹서버의 설정 파일을
수정 합니다. 역주: 말이 상당히 어렵습니다. 간단히 웹서버 설정을 한다는 의미입니다.
아파치 웹서버의 httpd.conf 에 (validator tarball 을 풀어놓은 곳의)
httpd/conf/httpd.conf 파일에 있는 내용을 추가합니다. 또는 웹서버
설정파일 httpd.conf 의 마지막 라인에 다음의 내용을 추가합니다:
Include /where/you/copied/it/httpd.conf
다음 validator 특정 부분의 편집을 시작 합니다.
서비스를 위해서 "가상 서버"를 설정을 해야 합니다. 이것은 아래과 같이 비슷하게 추가하는 것으로 가능합니다:
<VirtualHost 127.0.0.1> DocumentRoot [validatorpath]/htdocs/ ServerName validator.example.org </VirtualHost>
그리고/또는 웹서버의 특정 위치에 서비스를 지정하고 싶을 경우, 다음과 같이 설정할 수 있습니다:
Alias /validator/ [validatorpath]/htdocs/
Configure environment variables affective validator's outside connectivity
if needed (such as http_proxy), see examples in the supplied httpd.conf
and LWP
and Net::FTP
documentation.
Finish editing this HTTP server configuration file, adapting all the directory references to reflect the paths used in your installation.
아파치 웹서버 재시작은
쉘에서 시스템 관리자 권한으로 다음을 실행합니다:
apachectl graceful (또는 오래된 버전의 아파치에서는
apachectl configtest 후, apachectl restart)
설치된 사이트를 브라우저로 확인한다.
서버 에러가 나오면, 무엇이 잘못 되었는지 확인하기 위하여 웹서버의 에러 로그를 확인한다.
Help us improve this installation guide by sending us your feedback if you install the validator on your local system!
It is not always easy to troubleshoot an incomplete, or failed, installation of the Markup Validator. While the instructions given in this page should help most people install the validator successfully on their system, bad luck, a forgotten step or a broken component can make things go sour.
The first sound thing to do if the installation failed would be to check that you did not forget any step while installing. properly copying and editing the configuration file is among the common mistakes, for example.
The error logs for your Web server should be a good first place to look for hints on what is wrong with your installation.
A common problem with a newly installed validator is a validator that is apparently running but marking anything as "invalid", without giving any error message as output.
This is somewhat typical of a problem with OpenSP. Cross-check that you actually have a version above 1.5, by running onsgmls --version.
If the validator is misbehaving, you can try forcing various debug options by appending to the URL the following string: &debug=1
This can sometimes provide you with error messages that would not have appeared anywhere in non-debug mode, and can be helpful to diagnose the problem
Don't hesitate to contact the public mailing-list www-validator@w3.org with all the details you can provide on what you did, tried, and what went wrong...
if the installation succeeded, you should be able to now use the Markup Validator on your own
system and network. You may want to give the validator a look and feel specific to your Web site.
The easiest way to achieve this is to edit header.html and footer.html
(in the htdocs directory), the header and footer markup snippets used to build all
pages for the validator.
You may also edit the Style Sheets (in the same directory),
especially base.css You may however want to avoid editing the other CSS files too
heavily, there is a risk you could make the output of the validator unusable.
If you edit any *.css or *.js files, make sure that you update the gzipped versions of the edited files as well if they're installed and content negotiation for them is enabled in your setup (both are usually true if the validator was installed following these instructions).
The Validator Team wishes to thank Nick Talbott and Stephen Yoch for their help in creating these installation instructions. Thanks also to all the people who use and review the guide to make it better and better!
