EPUB 제작의 기초/EPUBCheck 오류

사용자 정의 메시지 재정의(overrides) 파일을 찾을 수 없습니다.

내.맘.대.로 2025. 9. 23. 09:32

The custom message overrides file was not found.

 

이 오류는 EPUBCheck의 고급 기능과 관련된 메시지입니다.

간단히 말해, EPUBCheck의 기본 오류 메시지나 심각도(경고, 오류 등)를 사용자가 직접 변경할 수 있는 **'사용자 정의 설정 파일'**을 사용하도록 명령했지만, 프로그램이 그 파일을 지정된 위치에서 찾지 못했다는 의미입니다. ⚙️


## 오류가 발생하는 이유

이 오류는 주로 두 가지 상황 중 하나일 때 발생합니다.

  1. 의도적으로 사용했지만 파일 경로가 틀린 경우: 고급 사용자가 --customMessages (또는 단축 명령어 -c) 옵션을 사용하여 직접 만든 메시지 설정 파일을 적용하려고 했으나, 파일 이름에 오타가 있거나 파일 경로를 잘못 지정한 경우입니다.
  2. 의도치 않게 명령어를 잘못 입력한 경우 (가장 흔한 원인): EPUBCheck를 실행하는 명령어를 입력하다가 실수로 -c 같은 옵션을 포함시킨 경우입니다. 프로그램은 이를 '사용자 정의 메시지 파일을 사용하라'는 명령으로 오해하고 파일을 찾으려 하지만, 실제 파일이 없으므로 오류가 발생합니다. 대부분의 사용자는 이 경우에 해당합니다.

## 해결 방법

  • 만약 이 기능을 사용할 의도가 없었다면, EPUBCheck를 실행한 명령어를 다시 확인해 보세요. 명령어에 불필요한 -c 또는 --customMessages 옵션이 포함되어 있다면, 그 부분을 삭제하고 다시 실행하면 됩니다.
    • 잘못된 명령어 예시: epubcheck mybook.epub -c somefile.txt
    • 올바른 명령어 예시: ✅ epubcheck mybook.epub
  • 만약 사용자 정의 메시지 파일을 의도적으로 사용했다면, 지정한 파일의 이름과 경로가 정확한지 다시 한번 꼼꼼히 확인해 주십시오.

요약: 이 기능은 특정 목적을 위해 EPUBCheck의 동작을 미세하게 조정하는 고급 기능입니다. 대부분의 경우, 실행 명령어에 포함된 오타가 원인이므로 명령어를 수정하는 것만으로 간단히 해결할 수 있습니다.

반응형