EPUBCheck

EPUB 파일 유효성 검사

EPUBCheck은 EPUB 2 및 EPUB 3 파일을 대상으로 구조, 메타데이터, 리소스 무결성 등을 검사하여 국제 표준 준수 여부를 판단합니다. 최신 버전 v5.3.0은 EPUB 3.3 사양에 따라 검사를 수행합니다.

다양한 출력 형식 지원

검사 결과를 콘솔에 출력하거나, --json output.json 옵션을 사용하여 JSON 형식의 보고서로 생성할 수 있습니다. 이는 자동화된 워크플로우에서의 후속 처리에 유용합니다.

다운로드·설치 방법

공식 저장소의 releases 페이지에서 최신 버전인 EPUBCheck v5.3.0을 ZIP 형식으로 다운로드할 수 있습니다. 다운로드 후 압축을 해제하면 epubcheck.jar 파일을 확인할 수 있습니다.

기본 사용법/명령어

명령줄에서 다음 형식으로 EPUBCheck을 실행할 수 있습니다:

• 기본 검사: java -jar epubcheck.jar sample.epub
• JSON 보고서 생성: java -jar epubcheck.jar sample.epub --json output.json
• 도움말 보기: java -jar epubcheck.jar --help

Docker를 사용하는 경우, 다음 명령으로 컨테이너 내에서 실행할 수 있습니다:

• docker run -it --rm -v .:/data epubcheck sample.epub (현재 디렉터리의 sample.epub 검사)
• docker run -it --rm -v /home/username:/data epubcheck sample.epub --json output.json (JSON 보고서 생성 및 호스트 디렉터리에 저장)

이런 경우에 유용합니다

출판사나 콘텐츠 제작자가 EPUB 파일을 배포하기 전에 국제 표준 준수 여부를 자동으로 검증해야 할 때 유용합니다. 특히 전자책 유통 플랫폼에 제출하기 전 오류를 사전에 발견하여 거부 위험을 줄이는 데 도움이 됩니다.

지원 환경·시스템 요구사항

Java Development Kit (JDK) 1.7 이상이 설치된 시스템에서 실행할 수 있습니다. Windows, macOS, Linux 등 Java 가상 머신이 지원되는 모든 운영 체제에서 동일하게 작동합니다. 별도의 시스템 라이브러리나 네트워크 연결은 필요하지 않습니다.

최신 버전·업데이트

현재 최신 버전은 v5.3.0이며, 공식 GitHub 저장소의 릴리스 페이지에서 확인할 수 있습니다. 이 버전은 EPUB 3.3 사양에 기반한 검사를 지원하며, 지속적인 유지 관리가 이루어지고 있습니다.