EPUB 제작의 기초/EPUBCheck 오류
메시지 재정의(overrides) 파일 "%2$s"에서 인식할 수 없는 사용자 정의 메시지 ID '%1$s'를(을) 발견했습니다.
내.맘.대.로
2025. 9. 23. 09:33
이 오류는 사용자가 지정한 '사용자 정의 메시지 파일'(%2$s)을 성공적으로 열었지만, 그 파일의 내용에 문제가 있음을 의미합니다.
구체적으로, EPUBCheck의 기본 메시지를 변경하기 위해 파일에 적어둔 메시지 ID(%1$s)가 존재하지 않는, 잘못된 ID라는 뜻입니다.
## 원인: 잘못된 메시지 ID
EPUBCheck의 모든 오류나 경고 메시지에는 고유한 ID(예: ACC_004, RSC_001)가 있습니다. 이 ID는 각 메시지의 '식별 번호'와 같습니다.
사용자 정의 파일에서 특정 메시지를 바꾸려면 이 '식별 번호'를 정확하게 사용해야 하는데, 파일에 적힌 ID(%1$s)에 오타가 있거나 존재하지 않는 ID를 사용하여 프로그램이 어떤 메시지를 바꿔야 할지 인식하지 못하는 상황입니다.
## 해결 방법
- 오류 메시지에 언급된 사용자 정의 메시지 파일(%2$s)을 텍스트 편집기에서 엽니다.
- 파일 안에서 잘못된 메시지 ID(%1$s)를 찾습니다.
- ID에 오타가 있는지 확인하고, 올바른 ID로 수정합니다. (예: 하이픈 - 과 밑줄 _ 을 혼동하는 경우가 많습니다.)
### 올바른 메시지 ID 목록 확인하기
EPUBCheck에서 사용 가능한 모든 공식 메시지 ID 목록은 터미널이나 명령 프롬프트에서 다음 명령어를 실행하여 확인할 수 있습니다. 이 목록을 참고하여 ID를 정확하게 수정하세요.
Bash
epubcheck --listChecks
또는 단축 명령어로,
Bash
epubcheck -l
반응형