CSS 검사 서비스 다운로드와 설치

This translation of the installation guide for the CSS validator may be out of date. For a reliable, up-to-date guide, refer to the English or French versions.

CSS 검사 도구 다운로드

소스 코드 다운로드

CSS 검사도구는 CVS를 통하여 다운로드를 제공하고 있습니다. Follow the 사용 안내를 참고하여 W3C 공개 CVS 서버에 접근하여 2002/css-validator를 다운로드하면 됩니다. 보통 온라인 서비스로 제공하는 검사 서비스가 상대적으로 오래된 버전이므로 검사 결과가 다소 다를 수도 있습니다.

Java 패키지로 다운로드 (jar 또는 war 형식)

css-validator.jar

설치 안내

CSS 검사 도구는 자바 서블릿을 기반으로 한 소프트웨어입니다. 범용적으로 사용하는 모든 서블릿 엔진에 설치가 가능하며, 커맨드라인 (명령 프롬프트) 상에서 사용이 가능하기도 합니다. W3C에서 제공하고 있는 공식 CSS 검사 서비스는 권장 사양인 Jigsaw 서버를 이용하여 서비스하고 있습니다. 이 문서에서는 가급적 범용성이 높은 서블릿 엔진인 아파치 톰캣 기반의 설치 안내를 제공합니다.

Jigsaw 서버를 이용하여 서블릿으로 이용하는 방법과 명령 프롬프트 상에서 사용할 수 있는 단독 프로그램으로 설치할 수 있는 방법에 대하여 아래에 기술되어 있습니다.

필요 환경

아래 설명은 다음 환경이 설치되어 동작한다는 가정 하에 설명하고 있습니다.

동작하는 자바 환경
Ant와 같은 자바 빌드 툴
아울러, 온라인 상에서 사용할 수 있는 서비스로 제공할 예정일 경우 Jigsaw, Tomcat 또는 Jetty 등의 자바 웹 서블릿이 동작할 수 있는 환경이 필요합니다. 여기에서는 Tomcat과 Jigsaw에 대해서만 다루고 있습니다.

추가적으로 검사 도구를 설치하기 위해서는 아래 자바 라이브러리가 시스템에 이미 존재하는지 확인하고, 없을 경우 설치해야 합니다.

servlet.jar (Tomcat이 설치되어 있을 경우 [TOMCAT_DIR]에 있으며, [TOMCAT_DIR]/common/lib/)에 servlet-api.jar 이라는 이름으로 저장되어 있을 가능성이 높습니다. 만일 없을 경우, java.sun.com 에서 다운로드가 가능합니다.
jigsaw.jar
xercesImpl.jar 와 xml-apis.jar ( xerces-j-bin과 함께 다운로드가 가능합니다).
tagsoup.jar

Tomcat에 CSS 검사 도구 설치하기

위에설명된 대로 다운로드를 받습니다.
소스 코드를 다운로드 받은 디렉토리 (".../css-validator/")를 Tomcat의webapps 디렉토리로 복사합니다. 이 경로의 기본값은 보통 [TOMCAT_DIR]/webapps/으로 설정되어 있습니다. 소스코드는 이제 [TOMCAT_DIR]/webapps/css-validator에 저장되어 있을 것입니다. 이 디렉토리는 편의상 [VALIDATOR_DIR] 이라 부르겠습니다.
"[VALIDATOR_DIR]" 안에 "WEB-INF"라는 디렉토리를 만들고, "[VALIDATOR_DIR]/WEB-INF" 안에는 "lib" 이라는 디렉토리를 추가적으로 생성합니다.
유닉스 시스템에서는 다음 명령어를 이용하면 됩니다: mkdir -p WEB-INF/lib
위에서 언급도니 jar 파일을 모두 (필요환경에 언급되어 있습니다) "[VALIDATOR_DIR]/WEB-INF/lib"으로 복사합니다.
소스 컴파일을 합니다. 이때 [VALIDATOR_DIR]로 미리 이동할 것을 권장합니다. ant를 이용하여 빌드를 하기 이전에 다운로드 받은 jar 파일이 모두 자바의 CLASSPATH 환경 변수에서 지정된 경로 안에 저장되어 있는지 확인하시기 바랍니다. 보통, 아래의 명령을 이용하면 유닉스 시스템에서는 정상 동작이 됩니다:
CLASSPATH=.:./WEB-INF/lib:$CLASSPATH ant
"[VALIDATOR_DIR]/css-validator.jar"를 "[VALIDATOR_DIR]/WEB-INF/lib/"로 복사하거나 이동합니다.
"[VALIDATOR_DIR]/"에서 "[VALIDATOR_DIR]/WEB-INF/"로. "web.xml"을 복사하거나 이동합니다.
마지막으로, Tomcat 서버를 재시작합니다:
유닉스 시스템 기준 예시: "cd [TOMCAT_DIR]; ./bin/shutdown.sh; ./bin/startup.sh;"

Jigsaw 웹 서버에 설치하기

우선, 위에서 설명한 대로 소스코드 다운로드를 하고 필요환경에 언급된 jar파일을 준비한 다음, 소스코드를 ant를 이용하여 빌드합니다.
이렇게 빌드를 한 다음, 설치가 이루어저리 홈 디렉토리를 설정하여야 서블릿 컨테이너로 정상적으로 사용이 가능하도록 합니다. (일반적인 경우, css-validator를 사용합니다..) 이렇게 하기 위해서는 Jigsaw가 설치되어 있어야 하며, (Jigsaw 페이지에 Jigsaw 서버를 쉽게 설치할 수 있도록 자세히 설명이 되어 있습니다.) 이 조건이 충족될 경우에는 Jigsaw 관리자를 실행합니다. HTTPFrame을 ServletDirectoryFrame으로 변경합니다.
다음 단계는 class가 'ServletWrapper'이며 frame이 'ServletWrapperFrame'인 "validator" 리소스를 만드는 것입니다. class와 frame의 경우, 특이한 환경이 아니라면 보통 자동으로 설정이 될 것입니다. 이 서블릿의 클래스 이름은 org.w3c.css.servlet.CssValidator입니다. 만일 validator라는 파일이 이미 설치가 되어 있다면, 이름을 변경하여야 합니다. 이 'alias'가 항상 'validator'를 가르키도록 설정이 되어 있어야 합니다.
마지막으로, Jigsaw 서버를 실행하고 검사 도구를 실행합니다. 검사 대상 HTML을 이용하여 확인을 하고, 문제가 없는지 확인하면 됩니다. 일반적인 설정으로 검사 도구에 접속할 수 있는 주소는 다음과 같을 것입니다:
http://localhost:8001/css-validator/validator.html

커맨드 라인 사용법

CSS 검사도구는 커맨드 라인상에서도 사용이 가능합니다. 만일 컴퓨터에 자바가 설치되어 있다면, 위에 있는 설명대로 css-validator.jar를 빌드하고 다음 명령으로 실행하면 사용이 가능합니다:
java -jar css-validator.jar http://www.w3.org/