epub-validator

ePub validator for Ridibooks CP site

개발환경 설정

Sublime Text 2, Package Control 활성화하기

1. View > Show Console
2. 콘솔창에 아래 명령 복붙 후 실행.

import urllib2,os; pf='Package Control.sublime-package'; ipp=sublime.installed_packages_path(); os.makedirs(ipp) if not os.path.exists(ipp) else None; urllib2.install_opener(urllib2.build_opener(urllib2.ProxyHandler())); open(os.path.join(ipp,pf),'wb').write(urllib2.urlopen('http://sublime.wbond.net/'+pf.replace(' ','%20')).read()); print('Please restart Sublime Text to finish installation')

1. Sublime Text 2 재시작.
2. cmd + shift + P
3. 입력창에 install 입력.
4. Package Control: Install Package 선택(실행).

Sublime Text 2, JS & NodeJS Snippets Package 설치하기

1. 입력창에 install 입력.
2. Package Control: Install Package 선택(실행).
3. 입력창에 nodejs 입력.
4. 'JavaScript & NodeJS Snippets' 선택(설치).

Sublime Text 2, Javascript Completions Package 설치하기

1. 입력창에 install 입력.
2. Package Control: Install Package 선택(실행).
3. 입력창에 javascript 입력.
4. Javascript Completions 선택(설치).

Sublime Text 2에 NodeJS 빌드 시스템 추가하기

1. Tools > Build System > New Build System 선택.
2. 아래 내용 복붙.

{   
    "cmd": ["/usr/local/bin/node", "$file"],
    "selector": "source.js"
}

1. 아래 경로로 저장.

/Users/{사용자 이름}/Library/Application\ Support/Sublime\ Text\ 2/Packages/User/nodejs.sublime-build

1. 빌드할 main.js를 Sublime Text 2로 열기 또는 선택.
2. Sublime Text 2 > Tools > Build System > nodejs 선택.
3. cmd + B

디버깅 모드

• 디버깅 모드는 프로그램의 흐름을 한눈에 파악하고 각 과정의 실행시간을 출력해주는 것을 의미한다.
• 디버깅 모드로 실행시키기 위해서는 아래 처럼 커맨드를 사용할 때.

$ node epub-validator.js test.epub

• 커맨드 앞에 'DEBUG=keyword'를 붙여주면 된다.

$ DEBUG=* node epub-validator.js test.epub

• keyword에는 app, epub, file, html, css, image가 있으며 전체를 쓰고 싶을 때는 *를 사용한다.
• 예를 들어 app을 keyword로 사용하면 아래와 같이 출력된다.

app init +0ms  
app check args +2ms  
app check exists file +1ms  
app ePub validation +0ms  
app ePub uncompressed +614ms  
app files validation in ePub +0ms  
app finish (0) +13ms  

배포 버전 생성

• epub-validator 루트 디렉토리로 이동 후 다음 커맨드를 실행.

$ make release

jx-cli 설치가 선행되어야 합니다.

업데이트 이력

0.0.3 (2017.11.30)

• Repo 이동에 따른 패키지 정보 업데이트.
• 디버그 버전 오류 수정.

0.0.2 (2015.03.24)

• 윈도우 환경에서 파일명에 공백이 포함된 ePub을 검사할 수 없었던 현상 수정.
• 윈도우 환경에서 일괄로 유효성 검사를 진행할 수 있도록 'epub-validator.bat' 추가.
• 결과 메시지를 좀 더 이해하기 쉽게 수정하고 의미 없는 메시지를 제거.
• ignore_code_list가 정상 동작하지 않는 현상 수정.
• html, body 태그는 자식 수 검사를하지 않도록 수정.
• OPF에서 identifier, ISBN을 찾지 못할 때 검사가 중지되는 현상 수정.

0.0.1 (2015.03.23)

• 테스트 버전 배포.

검사 항목(Ridi)

분류	심각성	내용	개발현황
EPUB-201~2	경고	ISBN 유효성 검사	완료
EPUB-???	???	ISBN 실존 검사	대기
EPUB-203	경고	ID, 도서 제목, 저자, 출판 등 메타데이터 확인	완료
EPUB-301	오류	목차의 경로가 './'로 시작하는지	완료
EPUB-302	오류	NCX 파일이 존재하는지	완료
EPUB-401	심각	NCX 파일 인코딩이 UTF-8인지	완료
FILE-301	오류	파일명에 UTF-8, UTF-16 인코딩에서 지원하지 않는 문자를 포함하고 있는지	완료
IMG-301	오류	표지 이미지가 가이드라인 최대 크기보다 큰지	완료
IMG-302	오류	본문 이미지가 가이드라인 최대 크기보다 큰지	완료
IMG-303	오류	파일 크기가 가이드라인 최대 크기보다 큰지	완료
IMG-304	오류	이미지 Color model이 CMYK model인지	개발 중
HTML-201	경고	OS 또는 App에서 지원하는 않는 태그를 사용하는지	완료
HTML-301	오류	파일 크기가 가이드라인 최대 크기보다 큰지	완료
HTML-302	오류	특정 태그가 너무 많은 자식 태그를 가지고 있는지	완료
HTML-303	오류	body 태그에 'background-color' 스타일 속성이 들어가 있는지	완료
HTML-304	오류	body 태그가 존재하는지	완료
HTML-???	경고	App에서 부여한 스타일이 CP 스타일과 충돌하는게 있는지	개발 중
HTML-???	경고	풋노트 기능을 사용할 수 없는 링크 알려주기	대기
CSS-201	경고	word-break 스타일 속성값을 break-all로 했을때 각줄의 끝이 균등 정렬되지 못 한다는것 알려주기	완료
CSS-202	경고	OS 또는 App에서 지원하는 않는 속성을 사용하는지	완료
CSS-301	오류	html 또는 body 태그의 너비 또는 높이를 조절하는 속성이 있는지	완료
CSS-302	오류	다단(Column) 스타일 속성을 사용하면 알려주기	완료
CSS-303	오류	이미지 태그 속성으로 'position:relative'를 주고 있는지	완료
CSS-???	???	span 태그의 서체 크기가 일정 크기(약 26pt)를 넘지 않는지	개발 중
CSS-???	???	url 속성으로 존재하지 않는 로컬 파일이나 외부 파일을 불러오려고 하는지	개발 중

검사 항목(epubcheck)

분류	심각성	내용
ACC-004	경고	텍스트가 없어 터치할 수 없는 링크가 있는지
ACC-010	경고	제목(h1~6)에 blockquote, figure 태그가 포함되어 있는지
ACC-012	경고	표에 caption 태그가 누락되어 있는지
ACC-013	경고	인라인 스타일을 포함하고 있는지
ACC-014, 016	경고	font-size 값이 상대값인지
ACC-015, 017	경고	line-height 값이 상대값인지
CSS-001	경고	ePub에서 사용할 수 없는 속성을 사용하는지
CSS-002	경고	속성값이 비어있는지
CSS-003~4	심각	UTF-8, UTF-16 인코딩에서 지원하지 않는 문자를 포함하고 있는지
CSS-005	경고	충돌되서 덮어쓰기 되는 속성이 있는지
CSS-006	오류	'position:fixed' 속성을 사용하는지
CSS-007	경고	비표준 폰트를 사용하고 있는지
CSS-008	오류	CSS 문법 오류
CSS-009	오류	페이징에 영향을 주는 속성을 사용하고 있는지
CSS-010	경고	비표준 스타일 시트를 사용하고 있는지
CSS-013	경고	'!Important' 키워드를 사용하는 속성이 있는지
CSS-016	경고	대체 스타일시트가 기본 스타일 시트보다 우선시 되고 있는지
CSS-019	경고	속성이 없는 font-face가 있는지
CSS-020	경고	유효하지 않는 폰트 크기를 사용하고 있는지
CSS-022	경고	html, body에 여백 속성을 추가 했는지