EPUB 제작의 기초/EPUBCheck 오류
메시지 재정의(overrides) 파일 "%2$s"에서 인식할 수 없는 사용자 정의 메시지 심각도 "%1$s"를(을) 발견했습니다.
내.맘.대.로
2025. 9. 24. 09:30
Unrecognized custom message severity "" encountered in message overrides file "".
이 오류는 사용자가 지정한 '사용자 정의 메시지 파일'(%2$s)의 내용에 문제가 있다는 의미입니다.
파일 안에서 특정 메시지의 **'심각도'**를 변경하려고 했는데, 지정한 심각도 이름(%1$s)이 EPUBCheck에서 사용할 수 없는 잘못된 값이라는 뜻입니다.
## '심각도'란?
EPUBCheck는 발견된 각 문제에 대해 심각성에 따라 등급을 부여합니다. 예를 들어, 사소한 문제는 **'경고(WARNING)'**로, EPUB 규격 위반은 **'오류(ERROR)'**로 표시합니다. 💯
사용자 정의 파일을 사용하면 이 기본 등급을 강제로 변경할 수 있습니다. 예를 들어, 특정 '경고'를 우리 팀에서는 반드시 수정해야 하는 '오류'로 취급하도록 규칙을 바꿀 수 있습니다. 이 오류는 바로 그 등급을 지정하는 과정에서 오타를 냈거나 유효하지 않은 등급 이름을 사용했을 때 발생합니다.
## 해결 방법
- 오류 메시지에 언급된 사용자 정의 파일(%2$s)을 엽니다.
- 파일 내용 중에서 잘못된 심각도 이름(%1$s)을 찾습니다.
- 아래 유효한 심각도 목록에 있는 공식 이름 중 하나로 정확하게 수정합니다.
### 유효한 심각도 목록
아래 5가지 키워드만 심각도 값으로 사용할 수 있습니다.
- FATAL: 검사를 즉시 중단시키는 가장 심각한 오류
- ERROR: 표준 위반으로, 반드시 수정해야 하는 오류
- WARNING: 표준 위반은 아니지만 잠재적 문제가 될 수 있어 수정이 권장되는 경고
- INFO: 단순 정보 제공 메시지
- USAGE: 더 나은 EPUB 제작을 위한 사용법 제안
## 수정 예시
만약 파일에 심각도를 Important라고 잘못 지정했다면,
- 오류 예시 (수정 전):
-
ACC_012, Important, "표에는 caption 요소가 있어야 함"
- 수정 예시 (수정 후): ✅Important는 유효하지 않은 값이므로, 공식 명칭인 WARNING으로 수정해야 합니다.
-
ACC_012, WARNING, "표에는 caption 요소가 있어야 함"
반응형