Jak přeložit EPUB v Calibru: nastavení pluginu, výstupní režimy a kontrola souborů

Calibre samo o sobě knihy nepřekládá. EPUB v Calibru přeložíte pomocí Ebook Translator, pluginu třetí strany od bookfere, který je uveden v indexu pluginů Calibru. Nainstalujte jej přes Předvolby → Pluginy → Získat nové pluginy, vyberte překladový engine, zvolte, zda chcete pouze překlad, nebo překlad vedle originálu, a spusťte jej na EPUB bez DRM. Získáte nový EPUB ve své knihovně Calibru.

Nastavení je ta rychlá část. Většina návodů ale pomíjí, co plugin s knihou během zpracování dělá. Prošli jsme zdrojový kód aktuálního vydání (v2.4.2), abychom to zjistili, a tři výchozí hodnoty jsou důležitější než vámi zvolený engine:

1. Výchozí výstup je dvojjazyčný. Každý přeložený odstavec se umístí pod originál, pokud nezměníte nastavení pozice.
2. Vložené formátování se v přeloženém textu zploští. Kurzíva, tučné písmo a odkazy uvnitř odstavce se do překladu nepřenášejí. Chráněn a zpět vložen je pouze pevný seznam značek, jako jsou obrázky, zalomení řádků a horní indexy.
3. Každé spuštění je konverze Calibru. I při převodu EPUB na EPUB předá plugin knihu konverznímu procesu Calibru, který výstupní soubor znovu sestaví.

Nic z toho nedělá z pluginu špatnou volbu. Je zdarma, open source (GPL-3.0) a velmi konfigurovatelný. Měli byste ale vědět, co zkontrolovat, než si výsledek přečtete nebo ho někomu předáte.

Poznámka k metodě: tento návod vychází ze zdrojového kódu pluginu v2.4.2, jeho oficiální dokumentace a příručky Calibru. Pro tento článek jsme nespouštěli žádný měřený překlad, takže neuvádíme žádná tvrzení o rychlosti, kvalitě překladu ani o tom, který engine dává nejlepší výsledek.

Co potřebujete, než začnete

Plugin přijímá i další formáty, které Calibre umí číst, například MOBI nebo AZW3. Protože kniha tak jako tak prochází konverzí Calibru, poskytuje čistý EPUB nejpředvídatelnější výstup.

Nainstalujte plugin Ebook Translator

Dokumentace pluginu uvádí dva způsoby instalace:

1. Přímo v Calibru (doporučeno): otevřete Předvolby → Pluginy → Získat nové pluginy, vyhledejte Ebook Translator, klikněte na Instalovat a poté restartujte Calibre.
2. Ze souboru: stáhněte ZIP z domovské stránky pluginu, poté použijte Předvolby → Zásuvné moduly → Načíst zásuvný modul ze souboru a restartujte.

Pokud se plugin nezobrazí na panelu nástrojů, přidejte jej v Předvolby → Panely nástrojů a nabídky → Hlavní panel nástrojů.

Calibre uvádí jako autora pluginu bookfere.com. Tým Calibre jej nevyvíjí. Problémy hlaste v repozitáři GitHub pluginu, ne Calibre.

Dávkový režim nebo pokročilý režim

Plugin nabízí dva způsoby překladu:

• Dávkový režim: vyberte jednu nebo více knih, nastavte cílový jazyk a výstupní formát a klikněte na Přeložit. Úloha se spustí ve frontě úloh Calibre. Použijte jej pro první návrh celé knihy, kterou plánujete přečíst jednou.
• Pokročilý režim: extrahujte odstavce jedné knihy do tabulky, přeložte všechny nebo jen vybrané, ručně upravte libovolný překlad a klikněte na Výstup. Použijte jej, když na knize záleží, například když je třeba znovu přeložit několik kapitol nebo opravit jména, protože můžete opravit odstavce před vytvořením EPUB.

Pokud budete překlad stejně kontrolovat, pokročilý režim vám umožní provést opravy přímo v pluginu. V dávkovém režimu byste je provedli později v editoru Calibre.

Výběr překladového stroje

Výchozí je bezplatný stroj Google. Verze 2.4.2 nabízí tyto stroje (názvy odpovídají zobrazení v pluginu):

Výchozí hodnoty, které ovlivňují dlouhou knihu:

• Interval mezi požadavky závisí na enginu. Ve zdrojovém kódu v2.4.2 je to 20 sekund pro ChatGPT (OpenAI a Azure), 12 sekund pro Claude, 1 sekunda pro Gemini a DeepL (Free) a 0 pro většinu ostatních. Dokumentace doporučuje interval zvýšit, pokud služba začne požadavky odmítat.
• Počet pokusů je 3 a běh se přeruší po 10 po sobě jdoucích chybách. Nastavte počet přerušení na 0, aby se nikdy automaticky nezastavil.
• Časový limit také závisí na enginu: 60 sekund pro ChatGPT a DeepSeek, 30 sekund pro Claude a Gemini a 10 sekund pro ostatní.
• Sloučit pro překlad je vypnuto. Když je zapnuto, plugin odesílá odstavce v dávkách až do 1 800 znaků. Dávky dávají LLM více okolního kontextu na jeden požadavek, ale jedna špatná odpověď pak ovlivní několik odstavců najednou.
• Glosář je vypnutý. Když je zapnutý, čte soubor prostého textu. Termín a jeho překlad jdou na dva řádky, termín, který se nemá překládat, jde na jeden řádek a položky jsou odděleny prázdnými řádky.

Plugin je zdarma, ale překlad není vždy zdarma. Román o 300 stránkách odeslaný do placeného API se účtuje jako jakékoli jiné použití API. Naše příručky pro ChatGPT, Claude a DeepSeek pro překlad vysvětlují, v čem jednotlivé modely v dlouhém textu obvykle chybují.

Zvolte výstup pouze s překladem, nebo dvojjazyčný

Nastavení Pozice překladu rozhoduje o podobě knihy:

Pokud chcete knihu, kterou si můžete jednoduše přečíst, změňte před spuštěním pozici na Bez originálu, protože výchozí nastavení vytváří dvojjazyčnou knihu.

Buďte opatrní s možnostmi vlevo a vpravo. Ve zdroji se každý pár přestaví jako řádek tabulky se třemi buňkami: originál, mezera a překlad. Při výchozí 10% mezeře jsou textové sloupce široké 45 %. Na telefonu nebo čtečce s 6palcovým displejem se z toho stanou dva úzké pruhy textu. Náš průvodce dvojjazyčným EPUB porovnává dvojjazyčná rozvržení, která na malých obrazovkách obstojí.

Co plugin mění uvnitř vašeho EPUB

Tohle je část, kterou obecné návody vynechávají. Tabulka shrnuje, co verze 2.4.2 dělá s jednotlivými typy obsahu, na základě zdrojového kódu (lib/element.py a lib/conversion.py na tagu v2.4.2).

Dva z těchto detailů způsobují nejviditelnější škody.

Proč mizí kurzíva a odkazy. Pro každý odstavec plugin sestaví text k překladu z prostého textu odstavce. Pouze značky na jeho chráněném seznamu jsou nahrazeny zástupnými symboly. <em> nebo <a> není ani chráněný, ani ignorovaný, takže jeho slova jsou přeložena a jeho značkování se ztratí. V dvojjazyčném režimu si původní odstavec zachová formátování, takže problém se projeví jen v přeloženém řádku. V režimu pouze cílový jazyk je formátování pryč. Můžete přidat selektory pod Reserve Element, ale rezervování prvku jej ponechá nepřeložený. To je užitečné pro cizí fráze nebo názvy knih, které chcete zachovat, a špatné pro zdůraznění, které chcete přeložit.

Proč se mohou poznámky pod čarou rozbít. Vydavatelé označují odkazy na poznámky pod čarou různými způsoby. Plugin má speciální případ pro odkaz, který obaluje pouze horní index (<a href="#n1"><sup>1</sup></a>), a tento odkaz zachová nedotčený. Odkaz zapsaný jako <a href="#n1" class="noteref">1</a> nemá horní index, takže číslo přežije, ale odkaz možná ne. Předtím, než budete důvěřovat překladu literatury faktu pouze do cílového jazyka, zkontrolujte poznámky. U japonských a čínských knih se před rozhodnutím, zda je ztráta furigany přijatelná, podívejte na jak překládat ruby anotace v EPUB.

Přeložený prvek také získá atribut lang pro cílový jazyk a atribut dir, což pomáhá čtečkám e-knih vybrat písma a rozvržení zprava doleva. V dvojjazyčném režimu překlad nekopíruje id původního prvku, takže stávající kotvy stále odkazují na původní odstavec.

A konečně, Calibre manuál pro konverzi popisuje, jak konverze probíhá: vstup je převeden na XHTML, transformován a poté zapsán výstupním pluginem. Během toho mohou transformace Calibre znovu vygenerovat metadata a obsah. Plugin překládá po těchto transformacích, těsně předtím, než výstupní plugin zapíše soubor. Váš přeložený EPUB je tedy přestavěná kniha, nikoli váš původní soubor s novým textem. Manuál Calibre poznamenává, že jeho konverzní systém „není náhradou za plnohodnotný editor e-knih“.

Zkontrolujte přeložený EPUB za pět minut

Nesuďte výsledek podle první kapitoly. Proveďte strukturální srovnání mezi původním a přeloženým souborem. EPUB je archiv ZIP, takže standardní nástroje příkazového řádku mohou spočítat značkování na každé straně:

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

Jak číst výsledek:

• Výstup pouze v cílovém jazyce s výrazně menším počtem značek <em>, <i> nebo <a než zdroj znamená zploštělé zdůraznění nebo odkazy. To se očekává od výše popsaného chování. Rozhodněte, zda kniha může žít bez nich.
• Méně značek <img ve výstupu pouze v cílovém jazyce znamená, že zástupný symbol obrázku byl ztracen. V dvojjazyčném výstupu se obrázky mohou objevit dvakrát, takže se raději spolehněte na hledání zástupných symbolů. Najděte kapitolu a opravte ji v pokročilém režimu nebo v editoru Calibre.
• Jakýkoli text {{id_…}} znamená, že engine změnil zástupný symbol, takže chráněný prvek nebyl obnoven.
• Dvojjazyčný výstup by měl mít alespoň tolik značek jako zdroj, protože původní odstavce jsou zachovány.

Vzor <em také odpovídá <embed, což je v knihách vzácné, ale je dobré to vědět, pokud se počet zdá být podivný.

Poté spusťte na přeložený soubor EPUBCheck od W3C. Otevřete jej v čtečce, kterou skutečně používáte, a zkontrolujte kontrolní seznam pro QA překladu EPUB: navigaci, poznámky, obrázky a poslední odstavec každé kapitoly. Pokud je kniha pro ostatní, otestujte ji na Kindle, Kobo a Apple Books.

Pokud se překlad zastaví v polovině

Plugin ve výchozím nastavení ukládá přeložené odstavce do mezipaměti. Pokud vypadne síť nebo engine začne odmítat požadavky, spusťte stejnou knihu znovu se stejným nastavením. Odstavce, které jsou již v mezipaměti, se znovu nepřekládají. V praxi:

1. Otevřete protokol úlohy v části Úlohy a hledejte opakující se chyby, které obvykle ukazují na omezování nebo vypršelý API klíč.
2. Zvyšte Interval nebo snižte Limit souběžnosti pro daný engine.
3. Spusťte knihu znovu. Mezipaměť naváže tam, kde se zastavila.
4. Pomocí Správce mezipaměti vymažte mezipaměť knihy pouze tehdy, když chcete čerstvý překlad, například po úpravě slovníku. Přepnutí enginu nebo cílového jazyka již spouští samostatnou mezipaměť.

Kdy je Calibre správným nástrojem a kdy ne

Použijte plugin Calibre, když:

• kniha je bez DRM a již je ve vaší knihovně Calibre;
• chcete si engine vybrat a zaplatit sami;
• jste ochotni kontrolovat odstavce v pokročilém režimu; a
• kniha je převážně prostý text, takže ztráta vloženého formátování příliš nevadí.

Hledejte jiný postup, když:

• kniha závisí na vloženém formátování, křížových odkazech nebo propojených poznámkách, jako mnoho učebnic a akademických knih;
• názvy a termíny musí zůstat konzistentní na stovkách stránek a nechcete sami spravovat soubor se slovníkem;
• raději byste sami neprováděli kontroly a opravy značek; nebo
• nejste si jisti s API klíči, limity požadavků a protokoly úloh.

Pokud váš případ popisuje druhý seznam, jednou z možností je nahrát EPUB do BookTranslatoru a před platbou zjistit cenu. Dokončené úlohy nabízejí ke stažení jak cílový, tak dvojjazyčný soubor a názvy a klíčové termíny jsou udržovány konzistentní pomocí vestavěného slovníku místo souboru, který byste psali sami. Je to placená služba. Ať už použijete jakýkoli nástroj, proveďte na výstupu stejnou kontrolu značek jako výše a před spoléháním se na překlad zkontrolujte jakýkoli dlouhý překlad. Srovnání nástrojů pro překlad EPUB staví plugin Calibre, nástroje prohlížeče a souborové služby vedle sebe, pokud chcete před výběrem porovnávat.