Hogyan fordítsunk EPUB-ot Calibre-rel: bővítmény telepítése, kimeneti módok és fájlellenőrzés

A Calibre önmagában nem fordít könyveket. EPUB-ot a Calibre-ben a Ebook Translator segítségével fordíthatsz, amely a bookfere által készített harmadik féltől származó bővítmény, és szerepel a Calibre bővítményindexében. Telepítsd a Beállítások → Bővítmények → Új bővítmények beszerzése menüpontból, válassz fordítómotort, döntsd el, hogy csak a fordítást vagy az eredetivel együtt szeretnéd-e, majd futtasd egy DRM-mentes EPUB-on. Az eredmény egy új EPUB lesz a Calibre könyvtáradban.

A beállítás a gyors rész. Amit a legtöbb útmutató kihagy, az az, hogy mit tesz a bővítmény a könyvvel a folyamat során. Elolvastuk a jelenlegi kiadás (v2.4.2) forráskódját, hogy kiderítsük, és három alapértelmezett beállítás fontosabb, mint a választott motor:

1. Az alapértelmezett kimenet kétnyelvű. Minden lefordított bekezdés az eredeti alá kerül, hacsak nem változtatod meg a pozíció beállítást.
2. A beágyazott formázás ellaposodik a lefordított szövegben. A bekezdésen belüli dőlt, félkövér és hivatkozások nem kerülnek át a fordításba. Csak egy rögzített címkelista, például képek, sortörések és felső indexek, van védve és visszahelyezve.
3. Minden futtatás egy Calibre-konverzió. Még EPUB-ból EPUB-ba is a bővítmény átadja a könyvet a Calibre konverziós folyamatának, amely újraépíti a kimeneti fájlt.

Mindez nem teszi a bővítményt rossz választássá. Ingyenes, nyílt forráskódú (GPL-3.0), és nagyon konfigurálható. De tudnod kell, mit ellenőrizz, mielőtt elolvasod vagy megosztod az eredményt.

Megjegyzés a módszerről: ez az útmutató a bővítmény v2.4.2 forráskódján, hivatalos dokumentációján és a Calibre kézikönyvén alapul. Ehhez a cikkhez nem futtattunk időzített fordítást, így nem teszünk állításokat a sebességről, a fordítás minőségéről vagy arról, hogy melyik motor adja a legjobb eredményt.

Amire szükséged van a kezdés előtt

A bővítmény más, a Calibre által olvasható formátumokat is elfogad, például MOBI-t vagy AZW3-at. Mivel a könyv így is áthalad a Calibre konverzióján, egy tiszta EPUB-ból kiindulva kapod a legkiszámíthatóbb kimenetet.

Telepítsd az Ebook Translator bővítményt

A bővítmény dokumentációja két telepítési módot kínál:

1. A Calibre-ből (ajánlott): nyisd meg a Beállítások → Bővítmények → Új bővítmények beszerzése menüpontot, keress rá az Ebook Translator kifejezésre, kattints a Telepítés gombra, majd indítsd újra a Calibre-t.
2. Fájlból: töltsd le a ZIP-et a bővítmény honlapjáról, majd a Beállítások → Bővítmények → Bővítmény betöltése fájlból menüpontban telepítsd, és indítsd újra a programot.

Ha a bővítmény nem jelenik meg az eszköztáron, add hozzá a Beállítások → Eszköztárak és menük → A fő eszköztár alatt.

A Calibre a bővítmény szerzőjeként a bookfere.com-ot tünteti fel. A Calibre csapata nem tartja karban. A problémákat a bővítmény GitHub-tárolójában jelentsd, ne a Calibre-nél.

Kötegelt mód vagy haladó mód

A bővítmény kétféleképpen futtathat fordítást:

• Kötegelt mód: jelölj ki egy vagy több könyvet, állítsd be a célnyelvet és a kimeneti formátumot, majd kattints a Fordítás gombra. A feladat a Calibre feladatlistájában fut. Ezt akkor használd, ha egy egész könyv első változatát szeretnéd elkészíteni, amelyet egyszer fogsz elolvasni.
• Haladó mód: bontsd ki egy könyv bekezdéseit egy táblázatba, fordítsd le az összeset vagy csak a kijelölteket, szükség esetén kézzel szerkeszd a fordításokat, majd kattints a Kimenet gombra. Ezt akkor használd, ha a könyv fontos, például ha néhány fejezetet újra kell fordítani, vagy a neveket javítani kell, mert így az EPUB írása előtt javíthatod a bekezdéseket.

Ha úgyis átnézed a fordítást, a haladó módban a bővítményen belül javíthatsz. Kötegelt módban ezeket később a Calibre szerkesztőjében tennéd meg.

Válassz fordítómotort

Alapértelmezésben az ingyenes Google-motor van beállítva. A 2.4.2-es verzió a következő motorokat kínálja (a nevük a bővítményben megjelenő formában):

A hosszú könyveket befolyásoló alapértelmezett beállítások:

• A kérések közötti intervallum a motortól függ. A v2.4.2 forráskódjában ez 20 másodperc a ChatGPT (OpenAI és Azure) esetében, 12 másodperc a Claude-nál, 1 másodperc a Gemini és a DeepL (ingyenes) esetében, és 0 a legtöbb másiknál. A dokumentáció azt javasolja, hogy növeljük, ha a szolgáltatás elkezdi elutasítani a kéréseket.
• A próbálkozások száma 3, és a futtatás 10 egymást követő hiba után megszakad. Állítsd a megszakítási számot 0-ra, hogy soha ne álljon le automatikusan.
• A timeout szintén a motortól függ: 60 másodperc a ChatGPT és a DeepSeek esetében, 30 másodperc a Claude és a Gemini esetében, és 10 másodperc a többinél.
• Az Összevonás fordításra ki van kapcsolva. Ha be van kapcsolva, a bővítmény legfeljebb 1800 karakteres kötegekben küldi a bekezdéseket. A kötegek több környező szöveget adnak az LLM-nek kérésenként, de egy rossz válasz így egyszerre több bekezdést érint.
• A Szójegyzék ki van kapcsolva. Ha be van kapcsolva, egy egyszerű szöveges fájlt olvas be. Egy kifejezés és annak fordítása két sorba kerül, egy fordítás nélkül hagyandó kifejezés egy sorba kerül, a bejegyzéseket pedig üres sorok választják el.

A bővítmény ingyenes, de a fordítás nem mindig az. Egy 300 oldalas regény fizetős API-nak elküldve ugyanúgy számlázódik, mint bármely más API-használat. A ChatGPT, a Claude és a DeepSeek fordításra vonatkozó útmutatóink elmagyarázzák, mit szoktak a modellek elrontani hosszú szövegekben.

Válassz csak célnyelvi vagy kétnyelvű kimenetet

A Fordítás pozíciója beállítás határozza meg a könyv formáját:

Ha olyan könyvet szeretnél, amit egyszerűen csak el tudsz olvasni, a kezdés előtt állítsd a pozíciót Eredeti nélkül értékre, mert az alapértelmezett beállítás kétnyelvű könyvet eredményez.

Légy óvatos a bal és jobb oldali beállításokkal. A forrásban minden pár egy három cellából álló táblázatsorként épül újra: eredeti, egy hézag és fordítás. Az alapértelmezett 10%-os hézaggal a szövegoszlopok egyenként 45% szélesek. Egy telefonon vagy egy 6 hüvelykes e-olvasón ez két keskeny szövegcsíkká válik. A kétnyelvű EPUB útmutatónk összehasonlítja azokat a kétnyelvű elrendezéseket, amelyek megállják a helyüket kis képernyőkön.

Mit változtat meg a bővítmény az EPUB fájlodban

Ez az a rész, amit az általános útmutatók kihagynak. A táblázat összefoglalja, hogy a v2.4.2 mit tesz az egyes tartalomtípusokkal, a forráskód (lib/element.py és lib/conversion.py a v2.4.2 címkén) alapján.

Ezek közül két részlet okozza a legszembetűnőbb károkat.

Miért tűnnek el a dőlt betűk és a hivatkozások. A bővítmény minden bekezdésnél a bekezdés nyers szövegéből építi fel a fordítandó szöveget. Csak a védett listáján szereplő címkék cserélődnek helyőrzőkre. Az <em> vagy <a> sem nem védett, sem nem figyelmen kívül hagyott, így a szavai lefordulnak, a jelölés pedig elveszik. Kétnyelvű módban az eredeti bekezdés megőrzi a formázását, így a probléma csak a fordított sorban látszik. Célnyelvi módban a formázás teljesen eltűnik. Hozzáadhat szelektorokat a Reserve Element alatt, de egy elem fenntartása azt jelenti, hogy fordítatlan marad. Ez hasznos olyan idegen nyelvű kifejezéseknél vagy könyvcímeknél, amelyeket meg akar tartani, viszont helytelen olyan kiemeléseknél, amelyeket le szeretne fordítani.

Miért törhetnek el a lábjegyzetek. A kiadók különböző módokon jelölik a lábjegyzet-hivatkozásokat. A bővítménynek van egy speciális esete arra a hivatkozásra, amely csak egy felső indexet zár közre (<a href="#n1"><sup>1</sup></a>), és érintetlenül hagyja azt. A <a href="#n1" class="noteref">1</a> formában írt hivatkozásnak nincs felső indexe, így a szám megmarad, de a hivatkozás elveszhet. Ismeretterjesztő művek célnyelvi fordítása előtt ellenőrizze a jegyzeteket. Japán és kínai könyvek esetében nézze meg, hogyan kell fordítani az EPUB ruby annotációkat, mielőtt eldönti, elfogadható-e a furigana elvesztése.

A lefordított elem emellett megkapja a célnyelvhez tartozó lang attribútumot és egy dir attribútumot, ami segít az e-olvasóknak a betűtípusok és a jobbról balra író nyelvek elrendezésének kiválasztásában. Kétnyelvű módban a fordítás nem másolja át az eredeti elem id attribútumát, így a meglévő horgonyok továbbra is az eredeti bekezdésre mutatnak.

Végül a Calibre konverziós kézikönyve leírja, hogyan működik a konvertálás: a bemenet XHTML-lé alakul, átalakításokon esik át, majd egy kimeneti bővítmény írja ki. Eközben a Calibre átalakításai újragenerálhatják a metaadatokat és a tartalomjegyzéket. A bővítmény ezen átalakítások után fordít, közvetlenül azelőtt, hogy a kimeneti bővítmény kiírná a fájlt. A lefordított EPUB tehát egy újraépített könyv, nem pedig az eredeti fájl új szöveggel. A Calibre kézikönyve megjegyzi, hogy a konverziós rendszere „nem helyettesíti a teljes értékű e-könyv-szerkesztőt”.

Ellenőrizze a lefordított EPUB-ot öt perc alatt

Ne az első fejezet alapján ítélje meg az eredményt. Végezzen szerkezeti összehasonlítást az eredeti és a lefordított fájl között. Az EPUB egy ZIP-archívum, így a szabványos parancssori eszközökkel megszámolhatja a jelöléseket mindkét oldalon:

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

Hogyan értelmezze az eredményt:

• A célnyelvi kimenetben lényegesen kevesebb <em>, <i> vagy <a címke van, mint a forrásban: ez ellaposodott kiemeléseket vagy hivatkozásokat jelent. Ez a fenti viselkedésből következik. Döntse el, hogy a könyv meg tud-e lenni nélkülük.
• A célnyelvi kimenetben kevesebb <img címke azt jelenti, hogy elveszett egy képi helyőrző. Kétnyelvű kimenetben a képek kétszer is megjelenhetnek, ezért inkább a helyőrzők keresésére támaszkodjon. Keresse meg a fejezetet, és javítsa ki a Speciális módban vagy a Calibre szerkesztőjében.
• Bármilyen {{id_…}} szöveg azt jelenti, hogy egy motor megváltoztatta a helyőrzőt, így a védett elem nem állt vissza.
• A kétnyelvű kimenet legalább annyi taggel kell rendelkezzen, mint a forrás, mivel az eredeti bekezdések megmaradnak.

A <em minta a <embed-re is illeszkedik, ami ritka a könyvekben, de érdemes tudni róla, ha furcsának tűnik egy darabszám.

Ezután futtasd a W3C EPUBCheck eszközét a lefordított fájlon. Nyisd meg abban az olvasóban, amelyet ténylegesen használni fogsz, és ellenőrizd az EPUB fordítás QA ellenőrzőlistát: a navigációt, a jegyzeteket, a képeket és minden fejezet utolsó bekezdését. Ha a könyv másoknak készül, teszteld Kindle-en, Kobón és Apple Books-on.

Ha a fordítás félúton megáll

A bővítmény alapértelmezés szerint gyorsítótárazza a lefordított bekezdéseket. Ha megszakad a hálózat, vagy a motor elkezdi elutasítani a kéréseket, futtasd újra ugyanazt a könyvet ugyanazokkal a beállításokkal. A már gyorsítótárazott bekezdéseket nem fordítja le újra. A gyakorlatban:

1. Nyisd meg a feladatnaplót a Jobs alatt, és keresd az ismétlődő hibákat, amelyek általában a sávszélesség-korlátozásra vagy egy lejárt API-kulcsra utalnak.
2. Növeld az Interval értékét, vagy csökkentsd a Concurrency limit értékét annál a motornál.
3. Futtasd újra a könyvet. A gyorsítótár onnan folytatja, ahol abbamaradt.
4. A Cache Manager segítségével csak akkor töröld egy könyv gyorsítótárát, ha friss fordítást szeretnél, például a szószedet szerkesztése után. A motor vagy a célnyelv váltása már külön gyorsítótárat indít.

Mikor a megfelelő eszköz a Calibre, és mikor nem

Akkor használd a Calibre bővítményt, ha:

• a könyv DRM-mentes, és már a Calibre könyvtáradban van;
• magad szeretnéd kiválasztani és kifizetni a motort;
• szívesen átnézed a bekezdéseket Haladó módban; és
• a könyv többnyire egyszerű próza, így a beágyazott formázás elvesztése kevésbe kerül.

Keress más munkafolyamatot, ha:

• a könyv beágyazott formázástól, kereszthivatkozásoktól vagy hivatkozott jegyzetektől függ, ahogy sok tankönyv és tudományos könyv teszi;
• a neveknek és kifejezéseknek több száz oldalon át konzisztensnek kell maradniuk, és nem szeretnél magad karbantartani egy szószedetfájlt;
• inkább nem szeretnéd magad elvégezni a jelölésellenőrzéseket és -javításokat; vagy
• nem érzed magad kényelmesen az API-kulcsokkal, a sebességkorlátokkal és a feladatnaplókkal.

Ha a második lista írja le a könyvedet, az egyik lehetőség, hogy feltöltöd az EPUB-ot a BookTranslatorba, és megnézed az árat, mielőtt fizetsz. A befejezett feladatoknál mind a célnyelvi, mind a kétnyelvű letöltés elérhető, a nevek és kulcskifejezések pedig egy beépített szószedettel maradnak konzisztensek ahelyett, hogy neked kellene fájlt írnod. Ez egy fizetős szolgáltatás. Bármelyik eszközt használod is, futtasd le a fenti jelölésellenőrzést a kimeneten, és nézd át a hosszú fordítást, mielőtt támaszkodnál rá. Az EPUB fordítóeszközök összehasonlítása egymás mellé állítja a Calibre bővítményt, a böngészős eszközöket és a fájlszolgáltatásokat, ha szeretnél összehasonlítani, mielőtt választasz.