내맘대로의 EPUB 제작 가이드

Error encountered while processing custom message file "%1$s": "%2$s".

이 오류는 EPUBCheck가 사용자 정의 메시지 파일(%1$s)을 읽는 도중에 예상치 못한 문제가 발생했을 때 나타나는 포괄적인 메시지입니다. ⚙️

오류의 정확한 원인은 메시지의 두 번째 부분(%2$s)에 자세히 설명되어 있습니다. 이 부분을 확인하는 것이 문제 해결의 가장 중요한 첫걸음입니다.

## 발생할 수 있는 일반적인 원인

%2$s에 표시될 수 있는 구체적인 원인은 다양하지만, 주로 다음과 같은 문제들로 인해 발생합니다.

• 파일 인코딩 문제 📄: 사용자 정의 파일이 UTF-8 형식이 아닌 다른 방식(예: ANSI)으로 저장된 경우, 프로그램이 파일을 제대로 읽지 못할 수 있습니다.
• 파일 접근 권한 문제 🚫: EPUBCheck 프로그램이 해당 파일을 읽을 수 있는 운영체제 권한이 없습니다. 파일이 '읽기 전용'으로 설정되어 있거나 보호된 폴더에 있을 수 있습니다.
• 파일 손상 또는 잠금 🔒: 파일 자체가 손상되었거나, 다른 프로그램이 파일을 사용하고 있어 접근할 수 없는 경우입니다.

## 해결 방법

1. 오류 메시지(%2$s) 확인: 가장 먼저, %2$s에 표시된 구체적인 오류 내용을 읽고 원인을 파악합니다.
2. 인코딩 확인 및 변환: 파일을 텍스트 편집기(예: Notepad++, Visual Studio Code)에서 열어 'UTF-8' 형식으로 다시 저장해 보세요. 많은 경우 이 방법으로 문제가 해결됩니다.
3. 파일 권한 및 위치 확인: 파일의 속성을 확인하여 '읽기 전용'이 아닌지 보고, 접근이 쉬운 폴더(예: 바탕화면)로 파일을 옮겨서 다시 시도해 보세요.

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" 파일이 누락되었습니다.
  

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"을 사용해야 합니다.
  

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. 오류가 발생한 사용자 정의 메시지 파일(%1$s)을 엽니다.
2. 문제가 되는 메시지를 찾습니다.
3. 사용자가 만든 메시지에 포함된 매개변수( %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" 파일이 누락되었습니다.
  

Unrecognized custom message severity "" encountered in message overrides file "".

이 오류는 사용자가 지정한 '사용자 정의 메시지 파일'(%2$s)의 내용에 문제가 있다는 의미입니다.

파일 안에서 특정 메시지의 **'심각도'**를 변경하려고 했는데, 지정한 심각도 이름(%1$s)이 EPUBCheck에서 사용할 수 없는 잘못된 값이라는 뜻입니다.

## '심각도'란?

EPUBCheck는 발견된 각 문제에 대해 심각성에 따라 등급을 부여합니다. 예를 들어, 사소한 문제는 **'경고(WARNING)'**로, EPUB 규격 위반은 **'오류(ERROR)'**로 표시합니다. 💯

사용자 정의 파일을 사용하면 이 기본 등급을 강제로 변경할 수 있습니다. 예를 들어, 특정 '경고'를 우리 팀에서는 반드시 수정해야 하는 '오류'로 취급하도록 규칙을 바꿀 수 있습니다. 이 오류는 바로 그 등급을 지정하는 과정에서 오타를 냈거나 유효하지 않은 등급 이름을 사용했을 때 발생합니다.

## 해결 방법

1. 오류 메시지에 언급된 사용자 정의 파일(%2$s)을 엽니다.
2. 파일 내용 중에서 잘못된 심각도 이름(%1$s)을 찾습니다.
3. 아래 유효한 심각도 목록에 있는 공식 이름 중 하나로 정확하게 수정합니다.

### 유효한 심각도 목록

아래 5가지 키워드만 심각도 값으로 사용할 수 있습니다.

• FATAL: 검사를 즉시 중단시키는 가장 심각한 오류
• ERROR: 표준 위반으로, 반드시 수정해야 하는 오류
• WARNING: 표준 위반은 아니지만 잠재적 문제가 될 수 있어 수정이 권장되는 경고
• INFO: 단순 정보 제공 메시지
• USAGE: 더 나은 EPUB 제작을 위한 사용법 제안

## 수정 예시

만약 파일에 심각도를 Important라고 잘못 지정했다면,

• 오류 예시 (수정 전):

• ACC_012, Important, "표에는 caption 요소가 있어야 함"
  

• 수정 예시 (수정 후): ✅Important는 유효하지 않은 값이므로, 공식 명칭인 WARNING으로 수정해야 합니다.

• ACC_012, WARNING, "표에는 caption 요소가 있어야 함"
  

Ollama에서 cloud 모델을 제공해서 사이즈가 큰 모델을 사용해 봤습니다.

요즘 제일 성능이 좋다고 생각하는 건 google의 gemma인데, 다른 분들은 어떤지 궁금하네요.

모델 별 번역 실력으로 AI 모델의 번역 실력을 평가해 보세요.

​

번역 원문

He says that we are losing the old ideals of earnest endeavour and true scholarship; and particularly is this falling-off noticeable in our disrespectful attitude towards organized authority.

​

1. deepseek-v3.1:671b-cloud

그는 우리가 진지한 노력과 진정한 학문이라는 옛 이상을 잃어가고 있다고 말합니다. 특히 조직화된 권위에 대한 무례한 태도에서 이러한 쇠퇴가 두드러지게 나타납니다.

​

2. qwen3-coder:480b-cloud

그는 우리가 진지한 노력과 진정한 학문이라는 옛 이상을 잃고 있다고 말한다. 특히나 이 퇴보는 우리가 조직화된 권위에 대해 무례하게 대하는 태도에서 두드러지게 나타난다고 한다.

​

3. gpt-oss:120b-cloud

그는 우리가 진지한 노력과 진정한 학문의 오래된 이상을 잃어가고 있다고 말한다. 특히 이러한 몰락은 조직된 권위에 대한 우리의 무례한 태도에서 두드러지게 나타난다.

​

4. gpt-oss:20b-cloud

그는 우리가 성실한 노력과 진정한 학문이라는 옛 이상을 잃어가고 있다고 말하며, 특히 이러한 쇠퇴가 조직화된 권위에 대한 우리의 무례한 태도에서 눈에 띈다고 지적한다.

​

5. gemma3:12b

그는 우리 사회가 진지한 노력과 진정한 학문적 가치를 잃어가고 있다고 말합니다. 특히 조직된 권위에 대한 경솔한 태도에서 이러한 쇠퇴가 두드러지게 나타납니다.

​

6. gemma3n:e4b

그는 우리가 진실한 노력과 진정한 학문이라는 옛 이상들을 잃어가고 있다고 말합니다. 특히 이러한 퇴보는 조직된 권위에 대한 우리의 무례한 태도에서 두드러지게 나타납니다.

번역 실력에는 개인의 선호가 들어 갈 수 있습니다. 그런데 LLM의 성능은 번역을 잘 하느냐도 중요하지만, 모델의 크기도 중요합니다. 671b와 12b의 번역 실력을 비교하려면 번역 결과물 뿐 아니라 모델의 크기도 함께 봐야 합니다.

제 선호는 gemma지만, 이건 gemma에 우호적인 감정이 있기 때문일 수 있어요. gemma보다 deepseek가 더 좋다고 느끼는 분도 있을거예요. 만약 deepseek가 gemma3보다 번역이 좋다고 생각하는 사람이 있다면, 이 두 모델의 크기가 얼마나 큰지도 봐야 합니다.