BookTranslator
BookTranslator

Calibre로 EPUB 번역하는 방법: 플러그인 설정, 출력 모드, 파일 점검

Calibre는 서드파티 Ebook Translator 플러그인을 통해 EPUB를 번역합니다. 설정, 엔진 및 출력 선택, v2.4.2가 마크업에 하는 일, 그리고 결과를 확인하는 방법을 알아봅니다.

BookTranslator

BookTranslator Team

25 min read

Calibre는 자체적으로 책을 번역하지 않습니다. Calibre에서 EPUB를 번역하려면 Ebook Translator를 사용해야 합니다. 이는 bookfere가 만든 서드파티 플러그인으로 Calibre 플러그인 인덱스에 등록되어 있습니다. 환경 설정 → 플러그인 → 새 플러그인 받기에서 설치하고, 번역 엔진을 선택한 뒤, 번역만 원하는지 원본과 함께 원하는지 정하고, DRM이 없는 EPUB에서 실행하세요. 그러면 Calibre 라이브러리에 새 EPUB가 생성됩니다.

설정은 금방 끝나는 부분입니다. 대부분의 가이드가 건너뛰는 것은 플러그인이 책을 처리하는 과정에서 하는 일입니다. 현재 릴리스(v2.4.2)의 소스 코드를 읽어 알아보았는데, 선택한 엔진보다 더 중요한 세 가지 기본값이 있습니다:

  1. 기본 출력은 이중 언어입니다. 위치 설정을 변경하지 않는 한, 번역된 각 문단은 원문 _아래_에 배치됩니다.
  2. 번역된 텍스트에서 인라인 서식이 평준화됩니다. 문단 내의 기울임꼴, 굵게, 링크는 번역에 반영되지 않습니다. 이미지, 줄 바꿈, 위첨자 등 고정된 태그 목록만 보호되어 다시 삽입됩니다.
  3. 모든 실행은 Calibre 변환입니다. EPUB에서 EPUB으로 변환하는 경우에도 플러그인은 책을 Calibre의 변환 파이프라인에 넘기며, 이 파이프라인이 출력 파일을 재구성합니다.

이 때문에 플러그인이 나쁜 선택은 아닙니다. 무료이고 오픈 소스(GPL-3.0)이며 매우 구성 가능합니다. 하지만 결과를 읽거나 공유하기 전에 무엇을 확인해야 하는지 알아두는 것이 좋습니다.

방법에 대한 참고: 이 가이드는 플러그인의 v2.4.2 소스 코드, 공식 문서, Calibre 매뉴얼을 기반으로 합니다. 이 글을 위해 시간을 재는 번역을 실행하지 않았으므로 속도, 번역 품질, 또는 어떤 엔진이 최상의 결과를 주는지에 대해서는 주장하지 않습니다.

시작하기 전에 필요한 것

요구 사항세부 사항
Calibre버전 5.0.0 이상. 이는 Calibre 플러그인 인덱스에 v2.4.2의 최소 요구 사항으로 명시되어 있으며, 릴리스 날짜는 2026년 8월 7일로 표시되어 있습니다.
DRM이 없는 EPUB플러그인은 Calibre 라이브러리의 책 파일에서 작동합니다. DRM으로 잠긴 상점 구매 도서는 번역되지 않습니다. 먼저 파일에 DRM이 있는지 확인하세요.
번역 엔진일부 엔진은 계정 없이 작동합니다(Google, DeepL, Microsoft Edge 무료 엔드포인트). 다른 엔진은 API 키가 필요하며 제공업체가 별도로 요금을 청구합니다.
검토 시간출력을 읽고 확인할 계획을 세우세요. 플러그인은 문단별로 번역합니다. 검토 단계가 아닙니다.

플러그인은 MOBI나 AZW3처럼 Calibre가 읽을 수 있는 다른 형식도 허용합니다. 어느 경우든 책이 Calibre 변환을 거치므로, 깨끗한 EPUB에서 시작하면 가장 예측 가능한 출력을 얻을 수 있습니다.

Ebook Translator 플러그인 설치

플러그인 문서에서는 두 가지 설치 방법을 제시합니다:

  1. Calibre 내부에서(권장): 환경 설정 → 플러그인 → 새 플러그인 받기를 열고 _Ebook Translator_를 검색한 뒤 설치를 클릭하고 Calibre를 다시 시작하세요.
  2. 파일에서 설치: 플러그인 홈페이지에서 ZIP을 내려받은 뒤 환경 설정 → 플러그인 → 파일에서 플러그인 불러오기를 사용하고 재시작하세요.

플러그인이 도구 모음에 나타나지 않으면 환경 설정 → 도구 모음 및 메뉴 → 기본 도구 모음에서 추가하세요.

Calibre는 플러그인 제작자를 bookfere.com으로 표시합니다. Calibre 팀이 유지 관리하는 플러그인이 아닙니다. 문제는 Calibre가 아니라 플러그인의 GitHub 저장소에 보고하세요.

일괄 모드 또는 고급 모드

이 플러그인은 번역을 실행하는 두 가지 방법을 제공합니다:

  • 일괄 모드: 책을 하나 이상 선택하고 대상 언어와 출력 형식을 설정한 뒤 번역을 클릭하세요. 작업은 Calibre의 작업 대기열에서 실행됩니다. 한 번 읽을 책 전체의 초벌 번역에 사용하세요.
  • 고급 모드: 한 책의 문단을 표로 추출하고, 전체 또는 선택한 문단만 번역하고, 번역을 직접 편집한 뒤 출력을 클릭하세요. 책이 중요할 때, 예를 들어 일부 장을 다시 번역해야 하거나 이름을 수정해야 할 때 사용하세요. EPUB이 작성되기 전에 문단을 고칠 수 있기 때문입니다.

어차피 번역을 검토할 예정이라면 고급 모드에서 플러그인 안에서 수정할 수 있습니다. 일괄 모드에서는 나중에 Calibre의 편집기에서 수정하게 됩니다.

번역 엔진 선택

무료 Google 엔진이 기본값입니다. 버전 2.4.2에서는 다음 엔진을 제공합니다(이름은 플러그인에 표시되는 그대로):

엔진 그룹엔진필요한 것
무료, 키 불필요Google (Free) 세 가지 변형, DeepL (Free), Microsoft Edge (Free)없음; 한도는 서비스에서 정하며 변경될 수 있음
기계 번역 APIGoogle (Basic), Google (Basic) ADC, Google (Advanced) ADC, DeepL, DeepL (Pro), Youdao, Baidu계정과 API 키, 또는 ADC 옵션의 경우 Google Cloud 사용자 인증 정보; 제공업체에서 청구
LLMChatGPT (OpenAI), ChatGPT (Azure), Gemini, Claude (Anthropic), DeepSeek (Chat)API 키; 제공업체에서 토큰당 청구
사용자 지정직접 구성한 모든 HTTP 엔드포인트직접 엔드포인트와 응답 파싱 설정

장편 도서에 영향을 주는 기본값:

  • 요청 간격은 엔진에 따라 다릅니다. v2.4.2 소스 기준으로 ChatGPT(OpenAI 및 Azure)는 20초, Claude는 12초, Gemini와 DeepL(무료)은 1초, 대부분의 다른 엔진은 0초입니다. 서비스가 요청을 거부하기 시작하면 이 값을 늘리라고 문서에 안내되어 있습니다.
  • 시도 횟수는 3회이며, 연속 오류 10회 후 실행이 중단됩니다. 자동 중단을 원하지 않으면 중단 횟수를 0으로 설정하세요.
  • 타임아웃도 엔진에 따라 다릅니다. ChatGPT와 DeepSeek은 60초, Claude와 Gemini는 30초, 나머지는 10초입니다.
  • 번역 시 병합은 꺼져 있습니다. 켜면 플러그인이 최대 1,800자 단위로 문단을 묶어서 보냅니다. 묶음 전송은 요청당 LLM에 더 많은 주변 맥락을 제공하지만, 응답 하나가 잘못되면 여러 문단에 한꺼번에 영향을 줍니다.
  • 용어집은 꺼져 있습니다. 켜면 일반 텍스트 파일을 읽습니다. 용어와 번역을 두 줄에 쓰고, 번역하지 않을 용어는 한 줄에 쓰며, 항목은 빈 줄로 구분합니다.

플러그인은 무료지만, 번역이 항상 무료인 것은 아닙니다. 300페이지 분량의 소설을 유료 API로 보내면 다른 API 사용과 마찬가지로 요금이 부과됩니다. ChatGPT, Claude, DeepSeek for translation 가이드에서 각 모델이 긴 텍스트에서 흔히 틀리는 부분을 설명합니다.

번역문만 또는 대역으로 출력 선택

번역 위치 설정이 책의 형태를 결정합니다:

설정결과추천 대상
원문 아래 (기본값)원문 문단 다음에 번역문언어 학습자 및 부분 확인용
원문 위번역문 먼저, 그다음 원문원문을 가까이 두고 모국어로 읽기
원문 왼쪽/오른쪽 (베타 표시)각 쌍이 간격 열을 둔 표 행이 됨와이드 스크린 전용
원문 없음번역문이 원문을 대체함번역서 읽기

단순히 읽을 목적으로 책을 원한다면 시작하기 전에 위치를 원문 없음으로 바꾸세요. 기본 설정은 대역서를 만들기 때문입니다.

좌우 옵션은 주의해서 사용하세요. 원문에서 각 쌍은 원문, 간격, 번역의 세 칸으로 이루어진 표 행으로 재구성됩니다. 기본 간격 10%에서는 텍스트 열이 각각 45% 너비가 됩니다. 휴대폰이나 6인치 전자책 리더기에서는 두 개의 좁은 텍스트 띠가 됩니다. 저희 대역 EPUB 가이드에서 작은 화면에서도 견디는 대역 레이아웃을 비교해 두었습니다.

플러그인이 EPUB 내부에서 바꾸는 것

일반적인 튜토리얼이 빠뜨리는 부분입니다. 다음 표는 v2.4.2가 각 콘텐츠 유형에 무엇을 하는지 소스 코드(lib/element.py와 lib/conversion.py, 태그 v2.4.2 기준)를 바탕으로 정리한 것입니다.

EPUB의 콘텐츠v2.4.2의 동작확인할 점
문단, 제목, 인용문단위별로 추출 및 번역됨장 시작과 끝에서 누락된 부분이 없는지
<pre> 및 <code> 블록번역되지 않음(기본적으로 무시됨)코드 샘플은 원문 언어로 유지되며, 대개 이것이 올바름
문단 내 기울임, 굵게, <span>, 링크텍스트는 번역되지만 번역문에서 태그가 제거됨번역된 문단의 강조, 기울임 제목, 본문 내 상호 참조
이미지, <br>, <hr>, <sub>, <sup>, <abbr>, <math>, <svg> 및 기타 몇 가지번역 전에 {{id_00000}} 같은 자리표시자로 바꾸었다가 다시 복원함엔진이 자리표시자를 변경한 경우 남은 {{id_…}} 텍스트나 누락된 이미지
위첨자를 감싸는 링크로 작성된 각주 표시하나의 보호된 단위로 함께 유지됨주석 링크가 여전히 주석으로 이동하는지
위첨자 없이 링크로 작성된 각주 표시링크는 다른 인라인 링크와 마찬가지로 평탄화됩니다.더 이상 링크되지 않는 각주 번호
루비 주석(<rt>, <rp>)번역을 위해 전송되는 텍스트에서 제거됨일본어 또는 중국어 원문의 후리가나 또는 병음
숫자와 구두점만으로 이루어진 단락건너뜀페이지 번호와 구분 기호는 그대로 유지됩니다.
목차 항목번역됨리더의 탐색 메뉴에 있는 장 제목
제목, 저자 및 기타 메타데이터메타데이터 번역을 활성화한 경우에만 번역됩니다.라이브러리 항목 및 책의 표시 제목

이 세부 사항 중 두 가지가 가장 눈에 띄는 손상을 일으킵니다.

기울임꼴과 링크가 사라지는 이유. 플러그인은 각 단락에 대해 단락의 일반 텍스트에서 번역할 텍스트를 구성합니다. 보호 목록에 있는 태그만 자리 표시자로 대체됩니다. <em> 또는 <a>는 보호되지도 무시되지도 않으므로 해당 단어가 번역되고 마크업이 손실됩니다. 이중 언어 모드에서는 원본 단락이 서식을 유지하므로 문제는 번역된 줄에서만 나타납니다. 대상 언어 전용 모드에서는 서식이 사라집니다. 요소 예약에서 선택기를 추가할 수 있지만, 요소를 예약하면 해당 요소가 번역되지 않은 상태로 유지됩니다. 이는 유지하려는 외국어 구문이나 책 제목에 유용하며, 번역하려는 강조에는 적합하지 않습니다.

각주가 깨질 수 있는 이유. 출판사는 각주 참조를 다양한 방식으로 표시합니다. 플러그인은 위첨자만 감싸는 링크(<a href="#n1"><sup>1</sup></a>)에 대한 특별한 경우를 처리하여 해당 링크를 그대로 유지합니다. <a href="#n1" class="noteref">1</a>로 작성된 참조에는 위첨자가 없으므로 숫자는 유지되지만 링크는 유지되지 않을 수 있습니다. 논픽션의 대상 언어 전용 번역을 신뢰하기 전에 각주를 확인하세요. 일본어 및 중국어 책의 경우, 후리가나 손실이 허용 가능한지 결정하기 전에 EPUB 루비 주석 번역 방법을 참조하세요.

번역된 요소에는 대상 언어에 대한 lang 속성과 dir 속성도 추가되어 전자책 리더가 글꼴과 오른쪽에서 왼쪽 레이아웃을 선택하는 데 도움이 됩니다. 이중 언어 모드에서는 번역이 원본 요소의 id를 복사하지 않으므로 기존 앵커가 여전히 원본 단락을 가리킵니다.

마지막으로, Calibre의 변환 매뉴얼은 변환 작동 방식을 설명합니다. 입력이 XHTML로 변환되고, 변형된 다음, 출력 플러그인에 의해 작성됩니다. 그 과정에서 Calibre의 변환은 메타데이터와 목차를 재생성할 수 있습니다. 플러그인은 이러한 변환 후, 출력 플러그인이 파일을 작성하기 직전에 번역합니다. 따라서 번역된 EPUB은 원본 파일에 새 텍스트를 추가한 것이 아니라 재구성된 책입니다. Calibre 매뉴얼은 변환 시스템이 "완전한 전자책 편집기를 대체하지 않는다"고 명시합니다.

5분 만에 번역된 EPUB 확인하기

첫 장만 보고 결과를 판단하지 마세요. 원본과 번역된 파일 간의 구조적 비교를 실행하세요. EPUB은 ZIP 아카이브이므로 표준 명령줄 도구로 각 측의 마크업을 셀 수 있습니다:

mkdir src out
unzip -q original.epub -d src
unzip -q translated.epub -d out
for tag in '<em' '<i[ >]' '<strong' '<a ' '<sup' '<img' '<rt'; do
  s=$(grep -rhoE "$tag" src --include='*htm*' | wc -l)
  o=$(grep -rhoE "$tag" out --include='*htm*' | wc -l)
  printf '%-10s source=%-6s output=%s\n' "$tag" "$s" "$o"
done
grep -rho '{{id_[0-9]*}}' out | head

결과를 읽는 방법:

  • 대상 언어 전용 출력에서 원본보다 <em>, <i> 또는 <a 태그가 훨씬 적다면 강조나 링크가 평탄화된 것입니다. 이는 위에서 설명한 동작에서 예상되는 결과입니다. 해당 요소 없이 책이 괜찮은지 결정하세요.
  • 대상 언어 전용 출력에서 <img 태그가 더 적다면 이미지 자리 표시자가 손실된 것입니다. 이중 언어 출력에서는 이미지가 두 번 나타날 수 있으므로 대신 자리 표시자 검색에 의존하세요. 해당 장을 찾아 고급 모드나 Calibre 편집기에서 수정하세요.
  • {{id_…}} 텍스트가 보이면 엔진이 자리 표시자를 변경한 것이므로 보호된 요소가 복원되지 않은 것입니다.
  • 이중 언어 출력은 원본 단락을 유지하므로 최소한 원본만큼의 태그가 있어야 합니다.

<em 패턴은 <embed와도 일치합니다. 책에서는 드물지만 개수가 이상해 보일 때 알아두면 좋습니다.

그런 다음 번역된 파일에 W3C의 EPUBCheck를 실행하세요. 실제로 사용할 리더에서 열고 EPUB 번역 QA 체크리스트를 확인하세요: 탐색, 주석, 이미지, 그리고 각 장의 마지막 단락까지요. 다른 사람을 위한 책이라면 Kindle, Kobo, Apple Books에서 테스트하세요.

번역이 중간에 멈추면

플러그인은 기본적으로 번역된 단락을 캐시합니다. 네트워크가 끊기거나 엔진이 요청을 거부하기 시작하면 동일한 설정으로 같은 책을 다시 실행하세요. 이미 캐시된 단락은 다시 번역되지 않습니다. 실제로는:

  1. Jobs에서 작업 로그를 열고 반복되는 오류를 찾으세요. 보통 속도 제한이나 만료된 API 키를 가리킵니다.
  2. 해당 엔진의 Interval을 높이거나 Concurrency limit을 낮추세요.
  3. 책을 다시 실행하세요. 캐시가 멈춘 지점부터 이어집니다.
  4. Cache Manager를 사용하여 책의 캐시를 지우는 것은 새 번역을 원할 때만, 예를 들어 용어집을 편집한 후에만 하세요. 엔진이나 대상 언어를 바꾸면 이미 별도의 캐시가 시작됩니다.

Calibre가 적합한 도구일 때와 그렇지 않을 때

Calibre 플러그인을 사용하세요:

  • 책이 DRM-free이고 이미 Calibre 라이브러리에 있을 때;
  • 엔진을 직접 선택하고 비용을 지불하고 싶을 때;
  • Advanced Mode에서 단락을 검토해도 괜찮을 때; 그리고
  • 책이 대부분 일반 산문이라 인라인 서식 손실이 거의 없을 때.

다른 워크플로를 찾으세요:

  • 책이 인라인 서식, 상호 참조 또는 링크된 주석에 의존할 때, 많은 교과서와 학술서처럼;
  • 이름과 용어가 수백 페이지에 걸쳐 일관되어야 하고 용어집 파일을 직접 유지하고 싶지 않을 때;
  • 마크업 검사와 수리를 직접 하고 싶지 않을 때; 또는
  • API 키, 속도 제한, 작업 로그에 익숙하지 않을 때.

두 번째 목록이 당신의 책을 설명한다면, 한 가지 옵션은 EPUB을 BookTranslator에 업로드하고 비용을 지불하기 전에 가격을 확인하는 것입니다. 완료된 작업은 대상 언어만 있는 다운로드와 이중 언어 다운로드를 모두 제공하며, 이름과 주요 용어는 직접 작성하는 파일 대신 내장 용어집으로 일관되게 유지됩니다. 유료 서비스입니다. 어떤 도구를 사용하든 출력에 위와 동일한 마크업 검사를 실행하고, 긴 번역을 신뢰하기 전에 검토하세요. 선택하기 전에 비교하고 싶다면 EPUB 번역 도구 비교에서 Calibre 플러그인, 브라우저 도구, 파일 서비스를 나란히 볼 수 있습니다.

관련 글