내맘대로의 EPUB 제작 가이드

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보다 번역이 좋다고 생각하는 사람이 있다면, 이 두 모델의 크기가 얼마나 큰지도 봐야 합니다.

이 오류는 사용자가 지정한 '사용자 정의 메시지 파일'(%2$s)을 성공적으로 열었지만, 그 파일의 내용에 문제가 있음을 의미합니다.

구체적으로, EPUBCheck의 기본 메시지를 변경하기 위해 파일에 적어둔 메시지 ID(%1$s)가 존재하지 않는, 잘못된 ID라는 뜻입니다.

## 원인: 잘못된 메시지 ID

EPUBCheck의 모든 오류나 경고 메시지에는 고유한 ID(예: ACC_004, RSC_001)가 있습니다. 이 ID는 각 메시지의 '식별 번호'와 같습니다.

사용자 정의 파일에서 특정 메시지를 바꾸려면 이 '식별 번호'를 정확하게 사용해야 하는데, 파일에 적힌 ID(%1$s)에 오타가 있거나 존재하지 않는 ID를 사용하여 프로그램이 어떤 메시지를 바꿔야 할지 인식하지 못하는 상황입니다.

## 해결 방법

1. 오류 메시지에 언급된 사용자 정의 메시지 파일(%2$s)을 텍스트 편집기에서 엽니다.
2. 파일 안에서 잘못된 메시지 ID(%1$s)를 찾습니다.
3. ID에 오타가 있는지 확인하고, 올바른 ID로 수정합니다. (예: 하이픈 - 과 밑줄 _ 을 혼동하는 경우가 많습니다.)

### 올바른 메시지 ID 목록 확인하기

EPUBCheck에서 사용 가능한 모든 공식 메시지 ID 목록은 터미널이나 명령 프롬프트에서 다음 명령어를 실행하여 확인할 수 있습니다. 이 목록을 참고하여 ID를 정확하게 수정하세요.

epubcheck --listChecks

또는 단축 명령어로,

epubcheck -l