EPUB 제작의 기초/EPUBCheck 오류

메시지 재정의(overrides) 파일 "%1$s"에 있는 사용자 정의 형식 매개변수(format parameter)를 파싱할 수 없습니다.

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

Unable to parse the custom format parameter in message overrides file "%1$s".

 

이 오류는 사용자 정의 메시지 파일(%1$s)에 포함된 매개변수(parameter) 자체의 형식에 오타나 문법 오류가 있을 때 발생합니다.

쉽게 말해, '빈칸 채우기'를 위한 %1$s와 같은 특별한 코드를 작성했는데, 그 코드의 형식이 잘못되어 컴퓨터가 이해하지 못하는 상황입니다. 💻


## '파싱(Parsing) 오류'란?

'파싱할 수 없다'는 것은 컴퓨터가 코드의 구조를 문법에 따라 분석하고 이해할 수 없다는 뜻입니다. 매개변수는 %, 숫자, $, s 등이 정해진 규칙에 따라 조합되어야 하는데, 이 규칙이 깨져 잘못된 명령으로 인식된 것입니다.

가장 흔한 원인은 매개변수를 입력할 때 발생한 단순 오타입니다.


## 해결 방법

  1. 오류가 발생한 사용자 정의 메시지 파일(%1$s)을 엽니다.
  2. 파일 안에 사용된 모든 매개변수(%... 형태의 코드)를 주의 깊게 살펴봅니다.
  3. 아래의 올바른 형식과 비교하여 잘못된 부분을 수정합니다.

### 매개변수의 올바른 형식과 흔한 실수

  • 올바른 형식: % 기호로 시작하고, 이어서 숫자, $ 기호, 그리고 마지막으로 s가 순서대로 와야 합니다.
    • 예시: %1$s, %2$s
  • 흔한 실수:
    • % 1$s (중간에 공백이 들어간 경우)
    • %1s ($ 기호가 빠진 경우)
    • %$s (숫자가 빠진 경우)
    • %s1$ (순서가 잘못된 경우)

## 수정 예시

  • 오류가 발생하는 사용자 정의 메시지:➡️ 매개변수에서 $ 기호가 빠졌기 때문에 '파싱 오류'가 발생합니다.
  • RSC_001 = "%1s" 파일이 누락되었습니다.
    
  • 올바르게 수정한 사용자 정의 메시지: ✅➡️ 올바른 형식인 %1$s로 수정하면 문제가 해결됩니다.
  • RSC_001 = "%1$s" 파일이 누락되었습니다.
    
반응형