EPUB 제작의 기초/EPUBCheck 오류

메시지 재정의(overrides) 파일 "%1$s"의 사용자 정의 제안(suggestion)에 너무 많은 매개변수(parameter)가 포함되어 있습니다.

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

The custom suggestion contains too many parameters in message overrides file "%1$s".

 

이 오류는 바로 이전 오류(CHK_004)와 거의 동일하지만, 이번에는 '오류 메시지' 본문이 아닌 '수정 제안(suggestion)' 부분의 매개변수(parameter)가 잘못되었다는 점이 다릅니다.


## '메시지'와 '제안'의 차이

EPUBCheck의 일부 경고나 오류는 두 부분으로 구성됩니다.

  • 메시지: 문제가 무엇인지 알려줍니다. (예: "잘못된 미디어 타입을 사용했습니다.")
  • 제안: 그 문제를 어떻게 해결할 수 있는지 힌트를 줍니다. (예: "대신 'application/xhtml+xml'을 사용하세요.")

이 오류는 사용자가 직접 만든 '제안' 문장에 포함된 매개변수(%1$s, %2$s 등)의 개수가, EPUBCheck가 제공하는 원본 '제안'의 매개변수 개수보다 많을 때 발생합니다.


## 해결 방법

해결 방법은 이전과 동일합니다. 사용자 정의 파일(%1$s)을 열고 문제가 되는 **제안(suggestion)**을 찾으세요. 그 다음, 제안에 포함된 매개변수의 개수를 원본 제안의 개수와 같거나 적도록 수정하면 됩니다.


## 수정 예시

  • 오류 ID: OPF_035
  • 원본 메시지: XHTML/OPS 문서에는 "text/html" 미디어 타입을 사용할 수 없습니다. (매개변수 0개)
  • 원본 제안 (OPF_035_SUG): "application/xhtml+xml"을 사용하세요. (매개변수 0개)
  • 오류가 발생하는 사용자 정의 제안:➡️ 이 제안은 원본 제안에는 없는 매개변수 %1$s를 새로 추가했기 때문에 오류가 발생합니다. EPUBCheck는 이 빈칸에 무엇을 넣어야 할지 모릅니다.
  • OPF_035_SUG = "%1$s" 대신 "application/xhtml+xml"을 사용하세요.
    
  • 올바르게 수정한 사용자 정의 제안: ✅➡️ 이 제안은 원본과 마찬가지로 매개변수를 사용하지 않으므로 정상적으로 처리됩니다.
  • OPF_035_SUG = 대신 권장 미디어 타입인 "application/xhtml+xml"을 사용해야 합니다.
    
반응형