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$s)을 엽니다.
- 파일 안에 사용된 모든 매개변수(%... 형태의 코드)를 주의 깊게 살펴봅니다.
- 아래의 올바른 형식과 비교하여 잘못된 부분을 수정합니다.
### 매개변수의 올바른 형식과 흔한 실수
- 올바른 형식: % 기호로 시작하고, 이어서 숫자, $ 기호, 그리고 마지막으로 s가 순서대로 와야 합니다.
- 예시: %1$s, %2$s
- 흔한 실수:
- % 1$s (중간에 공백이 들어간 경우)
- %1s ($ 기호가 빠진 경우)
- %$s (숫자가 빠진 경우)
- %s1$ (순서가 잘못된 경우)
## 수정 예시
- 오류가 발생하는 사용자 정의 메시지:➡️ 매개변수에서 $ 기호가 빠졌기 때문에 '파싱 오류'가 발생합니다.
-
RSC_001 = "%1s" 파일이 누락되었습니다.
- 올바르게 수정한 사용자 정의 메시지: ✅➡️ 올바른 형식인 %1$s로 수정하면 문제가 해결됩니다.
-
RSC_001 = "%1$s" 파일이 누락되었습니다.
반응형