EPUB 제작의 기초/EPUBCheck 오류
메시지 재정의(overrides) 파일 "%1$s"의 사용자 정의 메시지에 너무 많은 매개변수(parameter)가 포함되어 있습니다.
내.맘.대.로
2025. 9. 24. 09:31
The custom message contains too many parameters in message overrides file "%1$s".
이 오류는 사용자가 직접 만든 '사용자 정의 오류 메시지'의 내용에 문제가 있다는 뜻입니다. 구체적으로는, 메시지에 사용된 '매개변수(parameter)'의 개수가 원본 메시지보다 많다는 의미입니다.
## 매개변수(Parameter)란?
매개변수는 %1$s, %2$s 와 같이 표시되며, EPUBCheck가 오류를 보고할 때 그 자리에 구체적인 정보(예: 파일명, 잘못된 속성 값)를 채워 넣는 **'빈칸'**과 같습니다. 📝
예를 들어, 원본 오류 메시지가 "%1$s" 파일을 찾을 수 없습니다. 라면, EPUBCheck는 %1$s라는 빈칸에 실제 파일명(images/cover.jpg)을 채워 넣어 최종 메시지를 보여줍니다.
이 오류는 원본 메시지가 제공하는 '빈칸'은 하나인데, 사용자가 만든 새로운 메시지에는 '빈칸'을 두 개 이상 만들어 달라고 요청한 상황입니다. EPUBCheck는 추가된 빈칸에 무엇을 채워 넣어야 할지 모르기 때문에 오류를 보고합니다.
## 해결 방법
- 오류가 발생한 사용자 정의 메시지 파일(%1$s)을 엽니다.
- 문제가 되는 메시지를 찾습니다.
- 사용자가 만든 메시지에 포함된 매개변수( %1$s, %2$s 등)의 개수가 원본 오류 메시지가 사용하는 매개변수의 개수와 같거나 적도록 수정해야 합니다.
Tip: 특정 오류 ID의 원본 메시지에 매개변수가 몇 개 있는지 확인하는 가장 좋은 방법은, 해당 오류가 발생하는 샘플 EPUB을 EPUBCheck로 검사하여 기본적으로 출력되는 메시지를 직접 확인하는 것입니다.
## 수정 예시
- 오류 ID: RSC_001
- 원본 메시지: "%1$s" 파일을 찾을 수 없습니다. (매개변수 1개: 파일명)
- 오류가 발생하는 사용자 정의 메시지:➡️ 이 메시지는 원본에 없는 두 번째 매개변수 %2$s를 사용하려고 하므로 오류가 발생합니다.
-
RSC_001 = "%1$s" 파일을 "%2$s" 위치에서 찾지 못했습니다.
- 올바르게 수정한 사용자 정의 메시지: ✅➡️ 이 메시지는 원본과 동일하게 매개변수를 하나만 사용하므로 정상적으로 처리됩니다.
-
RSC_001 = 중요: EPUB 패키지 안에 "%1$s" 파일이 누락되었습니다.
반응형