Как да преведете EPUB с Calibre: настройка на приставката, режими на изход и проверка на файловете

Calibre не превежда книги сам по себе си. Превеждате EPUB в Calibre с Ebook Translator — приставка на трета страна от bookfere, включена в индекса с приставки на Calibre. Инсталирайте я от Preferences → Plug-ins → Get new plugins, изберете двигател за превод, решете дали искате само превода или до оригинала и я стартирайте върху EPUB без DRM. Получавате нов EPUB в библиотеката си с Calibre.

Настройката е бързата част. Това, което повечето ръководства пропускат, е какво прави приставката с книгата по време на процеса. Прочетохме изходния код на текущата версия (v2.4.2), за да разберем, и три настройки по подразбиране са по-важни от избрания двигател:

1. Изходът по подразбиране е двуезичен. Всеки преведен абзац се поставя под оригинала, освен ако не промените настройката за позиция.
2. Вграденото форматиране се изравнява в преведения текст. Курсивът, получерът и връзките в абзаца не се пренасят в превода. Защитен и възстановен е само фиксиран списък от тагове, като изображения, нови редове и горни индекси.
3. Всяко стартиране е преобразуване с Calibre. Дори от EPUB към EPUB, приставката предава книгата на конвейера за преобразуване на Calibre, който пресъздава изходния файл.

Нищо от това не прави приставката лош избор. Тя е безплатна, с отворен код (GPL-3.0) и много конфигурируема. Но трябва да знаете какво да проверите, преди да прочетете резултата или да го споделите.

Бележка за метода: това ръководство се основава на изходния код на приставката v2.4.2, официалната ѝ документация и ръководството на Calibre. Не сме пускали превод с измерване на времето за тази статия, така че не правим твърдения за скорост, качество на превода или кой двигател дава най-добър резултат.

Какво ви е необходимо преди да започнете

Приставката приема и други формати, които Calibre може да чете, като MOBI или AZW3. Тъй като книгата така или иначе минава през преобразуване с Calibre, започването от чист EPUB ви дава най-предвидим изход.

Инсталиране на приставката Ebook Translator

Документацията на приставката дава два начина за инсталиране:

1. От вътрешността на Calibre (препоръчително): отворете Preferences → Plug-ins → Get new plugins, потърсете Ebook Translator, щракнете върху Install и след това рестартирайте Calibre.
2. От файл: изтеглете ZIP архива от началната страница на приставката, след което използвайте Preferences → Plug-ins → Load plug-in from file и рестартирайте.

Ако приставката не се появи на лентата с инструменти, добавете я от Preferences → Toolbars & menus → The main toolbar.

Calibre посочва автора на приставката като bookfere.com. Екипът на Calibre не я поддържа. Съобщавайте за проблеми в GitHub хранилището на приставката, а не на Calibre.

Пакетен режим или Разширен режим

Приставката предлага два начина за стартиране на превод:

• Пакетен режим: изберете една или повече книги, задайте целевия език и изходния формат и щракнете върху Translate. Задачата се изпълнява в опашката от задачи на Calibre. Използвайте този режим за първоначален превод на цяла книга, която планирате да прочетете веднъж.
• Разширен режим: извлечете абзаците на една книга в таблица, преведете всички или само избраните, редактирайте ръчно всеки превод, след което щракнете върху Output. Използвайте този режим, когато книгата е важна, например когато няколко глави трябва да се преведат отново или имената трябва да се коригират, защото можете да поправите абзаците, преди EPUB файлът да бъде създаден.

Ако все пак ще прегледате превода, Разширеният режим ви позволява да правите корекции в приставката. При Пакетния режим ще ги направите по-късно в редактора на Calibre.

Избор на машина за превод

По подразбиране се използва безплатната машина на Google. Версия 2.4.2 предлага следните машини (имената са както се показват в приставката):

Настройки по подразбиране, които влияят на дълга книга:

• Интервалът между заявките зависи от машината. В изходния код на v2.4.2 той е 20 секунди за ChatGPT (OpenAI и Azure), 12 секунди за Claude, 1 секунда за Gemini и DeepL (Free) и 0 за повечето други. Документацията предлага да го увеличите, ако услугата започне да отказва заявки.
• Броят опити е 3, а изпълнението се прекъсва след 10 последователни грешки. Задайте броя на прекъсванията на 0, за да не спира автоматично никога.
• Таймаутът също зависи от машината: 60 секунди за ChatGPT и DeepSeek, 30 секунди за Claude и Gemini и 10 секунди за останалите.
• Обединяване за превод е изключено. Когато е включено, плъгинът изпраща абзаците на партиди от до 1800 знака. Партидите дават на LLM повече контекст за всяка заявка, но един лош отговор тогава засяга няколко абзаца наведнъж.
• Речникът е изключен. Когато е включен, той чете обикновен текстов файл. Термин и неговият превод се поставят на два реда, термин, който да остане непреведен, се поставя на един ред, а записите се разделят с празни редове.

Плъгинът е безплатен, но преводът не винаги е безплатен. Роман от 300 страници, изпратен до платен API, се таксува като всяка друга употреба на API. Нашите ръководства за ChatGPT, Claude и DeepSeek за превод обясняват какво всеки модел е склонен да обърка в дълъг текст.

Изберете изход само на целевия език или двуезичен изход

Настройката Позиция на превода определя формата на книгата:

Ако искате книга, която просто да четете, променете позицията на Без оригинал, преди да започнете, защото настройката по подразбиране създава двуезична книга.

Внимавайте с опциите за ляво и дясно. В изходния файл всяка двойка се пресъздава като ред в таблица с три клетки: оригинал, празнина и превод. При празнина от 10% по подразбиране текстовите колони са с ширина 45% всяка. На телефон или е-четец с 6-инчов екран това се превръща в две тесни ивици текст. Нашият наръчник за двуезичен EPUB сравнява двуезичните оформления, които издържат на малки екрани.

Какво променя плъгинът във вашия EPUB

Това е частта, която общите уроци пропускат. Таблицата обобщава какво прави v2.4.2 с всеки вид съдържание въз основа на изходния код (lib/element.py и lib/conversion.py при таг v2.4.2).

Две от тези подробности причиняват най-видими щети.

Защо курсивът и връзките изчезват. За всеки абзац плъгинът съставя текста за превод от обикновения текст на абзаца. Само тагове от защитения му списък се заменят с заместители. Един <em> или <a> не е нито защитен, нито игнориран, така че думите му се превеждат и маркировката му се губи. В двуезичен режим оригиналният абзац запазва форматирането си, така че проблемът се вижда само в преведения ред. В режим само на целевия език форматирането е изчезнало. Можете да добавите селектори под Reserve Element, но запазването на елемент го оставя непреведен. Това е полезно за чужди фрази или заглавия на книги, които искате да запазите, и е грешно за акценти, които искате да бъдат преведени.

Защо бележките под линия могат да се счупят. Издателите маркират препратките към бележки под линия по различни начини. Плъгинът има специален случай за връзка, която обгражда само горен индекс (<a href="#n1"><sup>1</sup></a>) и запазва тази връзка непокътната. Препратка, написана като <a href="#n1" class="noteref">1</a>, няма горен индекс, така че номерът оцелява, но връзката може и да не оцелее. Проверете бележките, преди да се доверите на превод само на целевия език на нехудожествена литература. За японски и китайски книги вижте как да превеждате EPUB руби анотации, преди да решите дали загубата на фуригана е приемлива.

Преведеният елемент също получава атрибут lang за целевия език и атрибут dir, което помага на е-четците да избират шрифтове и оформление от дясно на ляво. В двуезичен режим преводът не копира id на оригиналния елемент, така че съществуващите котви все още сочат към оригиналния абзац.

Накрая, ръководството за конвертиране на Calibre описва как работи конвертирането: входът се превръща в XHTML, трансформира се и след това се записва от плъгин за изход. По пътя трансформациите на Calibre могат да регенерират метаданните и съдържанието. Плъгинът превежда след тези трансформации, точно преди плъгинът за изход да запише файла. Следователно преведеният ви EPUB е преизградена книга, а не оригиналният ви файл с нов текст. Ръководството на Calibre отбелязва, че системата му за конвертиране „не е заместител на пълноценен редактор за е-книги“.

Проверете преведения 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 в изхода само на целевия език означава, че заместител на изображение е загубен. В двуезичен изход изображенията могат да се появят два пъти, така че разчитайте на търсенето на заместители вместо това. Намерете главата и я поправете в Advanced Mode или в редактора на Calibre.
• Всеки текст {{id_…}} означава, че даден двигател е променил заместител, така че защитеният елемент не е възстановен.
• Двуезичният изход трябва да има поне толкова тагове, колкото източникът, защото оригиналните абзаци се запазват.

Шаблонът <em също съвпада с <embed, което е рядко срещано в книги, но е добре да се знае, ако броят изглежда странен.

След това стартирайте EPUBCheck на W3C върху преведения файл. Отворете го в четеца, който действително ще използвате, и проверете контролния списък за качество на EPUB превод: навигация, бележки, изображения и последния абзац на всяка глава. Ако книгата е за други хора, тествайте я на Kindle, Kobo и Apple Books.

Ако преводът спре по средата

По подразбиране плъгинът кешира преведените абзаци. Ако мрежата прекъсне или двигателят започне да отказва заявки, стартирайте същата книга отново със същите настройки. Абзаците, които вече са в кеша, не се превеждат повторно. На практика:

1. Отворете дневника на задачата под Jobs и потърсете повтарящи се грешки, които обикновено сочат към ограничаване на честотата или изтекъл API ключ.
2. Увеличете Interval или намалете Concurrency limit за този двигател.
3. Стартирайте книгата отново. Кешът продължава от мястото, където е спрял.
4. Използвайте Cache Manager, за да изчистите кеша на книга само когато искате нов превод, например след редактиране на речника. Смяната на двигателя или целевия език вече стартира отделен кеш.

Кога Calibre е подходящият инструмент и кога не е

Използвайте плъгина за Calibre, когато:

• книгата е без DRM и вече е в библиотеката ви с Calibre;
• искате сами да изберете и платите за двигателя;
• готови сте да преглеждате абзаци в Advanced Mode; и
• книгата е предимно обикновена проза, така че загубата на вградено форматиране струва малко.

Потърсете друг работен процес, когато:

• книгата зависи от вградено форматиране, кръстосани препратки или свързани бележки, както правят много учебници и академични книги;
• имената и терминините трябва да останат последователни в стотици страници и не искате сами да поддържате файл с речник;
• предпочитате сами да не извършвате проверки и поправки на маркирането; или
• не се чувствате удобно с API ключове, ограничения на честотата и дневници на задачи.

Ако вторият списък описва вашата книга, една възможност е да качите EPUB в BookTranslator и да видите цената, преди да платите. Завършените задачи предлагат както изтегляне само на целевия език, така и двуезично, а имената и ключовите термини се поддържат последователни чрез вграден речник, вместо чрез файл, който пишете сами. Това е платена услуга. Какъвто и инструмент да използвате, извършете същата проверка на маркирането по-горе върху изхода и прегледайте всеки дълъг превод, преди да разчитате на него. Сравнението на инструменти за превод на EPUB поставя плъгина за Calibre, браузърните инструменти и файловите услуги едно до друго, ако искате да сравните, преди да изберете.