Jak przetłumaczyć EPUB w Calibre: konfiguracja wtyczki, tryby wyjściowe i sprawdzanie plików

Calibre samo w sobie nie tłumaczy książek. EPUB w Calibre tłumaczysz za pomocą Ebook Translator — zewnętrznej wtyczki autorstwa bookfere, która znajduje się w indeksie wtyczek Calibre. Zainstaluj ją przez Preferencje → Wtyczki → Pobierz nowe wtyczki, wybierz silnik tłumaczenia, zdecyduj, czy chcesz samo tłumaczenie, czy obok oryginału, i uruchom na EPUB bez DRM. Otrzymasz nowy EPUB w swojej bibliotece Calibre.

Konfiguracja to najszybsza część. To, co pomija większość poradników, to co wtyczka robi z książką po drodze. Przeanalizowaliśmy kod źródłowy bieżącego wydania (v2.4.2), aby się tego dowiedzieć, i trzy domyślne ustawienia mają większe znaczenie niż wybrany silnik:

1. Domyślne wyjście jest dwujęzyczne. Każdy przetłumaczony akapit jest umieszczany pod oryginałem, chyba że zmienisz ustawienie pozycji.
2. Formatowanie w tekście jest spłaszczane w tłumaczeniu. Kursywa, pogrubienie i linki wewnątrz akapitu nie są przenoszone do tłumaczenia. Chroniona i przywracana jest tylko stała lista znaczników, takich jak obrazy, podziały wierszy i indeksy górne.
3. Każde uruchomienie to konwersja Calibre. Nawet EPUB na EPUB — wtyczka przekazuje książkę do potoku konwersji Calibre, który odbudowuje plik wyjściowy.

Nic z tego nie czyni wtyczki złym wyborem. Jest darmowa, open source (GPL-3.0) i bardzo konfigurowalna. Warto jednak wiedzieć, co sprawdzić, zanim przeczytasz wynik lub się nim podzielisz.

Uwaga metodologiczna: ten przewodnik opiera się na kodzie źródłowym wtyczki w wersji 2.4.2, jej oficjalnej dokumentacji i podręczniku Calibre. Nie przeprowadzaliśmy tłumaczenia na czas na potrzeby tego artykułu, więc nie zawiera on twierdzeń o szybkości, jakości tłumaczenia ani o tym, który silnik daje najlepszy wynik.

Co jest potrzebne przed rozpoczęciem

Wtyczka obsługuje także inne formaty, które Calibre potrafi odczytać, takie jak MOBI czy AZW3. Ponieważ książka i tak przechodzi przez konwersję Calibre, rozpoczęcie od czystego EPUB daje najbardziej przewidywalny wynik.

Zainstaluj wtyczkę Ebook Translator

Dokumentacja wtyczki podaje dwa sposoby jej instalacji:

1. Z poziomu Calibre (zalecane): otwórz Preferencje → Wtyczki → Pobierz nowe wtyczki, wyszukaj Ebook Translator, kliknij Zainstaluj, a następnie uruchom ponownie Calibre.
2. Z pliku: pobierz plik ZIP ze strony głównej wtyczki, a następnie użyj Preferencje → Wtyczki → Wczytaj wtyczkę z pliku i uruchom ponownie program.

Jeśli wtyczka nie pojawi się na pasku narzędzi, dodaj ją w Preferencje → Paski narzędzi i menu → Główny pasek narzędzi.

Calibre podaje autora wtyczki jako bookfere.com. Zespół Calibre nie zajmuje się jej utrzymaniem. Problemy zgłaszaj do repozytorium GitHub wtyczki, a nie do Calibre.

Tryb wsadowy lub tryb zaawansowany

Wtyczka oferuje dwa sposoby uruchamiania tłumaczenia:

• Tryb wsadowy: wybierz jedną lub więcej książek, ustaw język docelowy i format wyjściowy, a następnie kliknij Tłumacz. Zadanie zostanie uruchomione w kolejce zadań Calibre. Użyj tego trybu do pierwszego szkicu całej książki, którą planujesz przeczytać raz.
• Tryb zaawansowany: wyodrębnij akapity jednej książki do tabeli, przetłumacz wszystkie lub tylko wybrane, ręcznie edytuj dowolne tłumaczenie, a następnie kliknij Wyjście. Użyj tego trybu, gdy książka ma znaczenie, na przykład gdy kilka rozdziałów wymaga ponownego tłumaczenia lub trzeba poprawić nazwy, ponieważ możesz poprawić akapity przed zapisaniem pliku EPUB.

Jeśli i tak zamierzasz sprawdzić tłumaczenie, tryb zaawansowany pozwala wprowadzić poprawki w wtyczce. W trybie wsadowym zrobiłbyś to później w edytorze Calibre.

Wybierz silnik tłumaczenia

Domyślnie używany jest darmowy silnik Google. Wersja 2.4.2 oferuje następujące silniki (nazwy takie, jak w wtyczce):

Ustawienia domyślne, które mają znaczenie przy długiej książce:

• Interwał między żądaniami zależy od silnika. W kodzie źródłowym wersji 2.4.2 wynosi 20 sekund dla ChatGPT (OpenAI i Azure), 12 sekund dla Claude, 1 sekundę dla Gemini i DeepL (Free) oraz 0 dla większości pozostałych. Dokumentacja sugeruje zwiększenie go, jeśli usługa zacznie odrzucać żądania.
• Liczba prób to 3, a działanie przerywa się po 10 kolejnych błędach. Ustaw liczbę przerwań na 0, aby nigdy nie zatrzymywać się automatycznie.
• Limit czasu również zależy od silnika: 60 sekund dla ChatGPT i DeepSeek, 30 sekund dla Claude i Gemini oraz 10 sekund dla pozostałych.
• Scal do tłumaczenia jest wyłączone. Gdy jest włączone, wtyczka wysyła akapity w partiach do 1800 znaków. Partie dają modelowi LLM więcej kontekstu w jednym żądaniu, ale jedna błędna odpowiedź wpływa wtedy na kilka akapitów naraz.
• Słownik jest wyłączony. Gdy jest włączony, odczytuje plik tekstowy. Termin i jego tłumaczenie znajdują się w dwóch wierszach, termin pozostawiony bez tłumaczenia w jednym wierszu, a wpisy są oddzielone pustymi wierszami.

Wtyczka jest darmowa, ale tłumaczenie nie zawsze jest darmowe. Powieść licząca 300 stron wysłana do płatnego API jest rozliczana jak każde inne użycie API. Nasze przewodniki po ChatGPT, Claude i DeepSeek do tłumaczenia wyjaśniają, co każdy model zwykle myli w długich tekstach.

Wybierz wynik tylko docelowy lub dwujęzyczny

Ustawienie Pozycja tłumaczenia decyduje o kształcie książki:

Jeśli chcesz książkę, którą można po prostu czytać, przed rozpoczęciem zmień ustawienie na Bez oryginału, ponieważ domyślne ustawienie tworzy książkę dwujęzyczną.

Zachowaj ostrożność przy opcjach lewej i prawej. W pliku źródłowym każda para jest odtwarzana jako wiersz tabeli z trzema komórkami: oryginał, odstęp i tłumaczenie. Przy domyślnym 10% odstępie kolumny tekstu mają po 45% szerokości. Na telefonie lub 6-calowym czytniku e-booków stają się one dwoma wąskimi paskami tekstu. Nasz przewodnik po dwujęzycznych plikach EPUB porównuje układy dwujęzyczne, które sprawdzają się na małych ekranach.

Co wtyczka zmienia w Twoim pliku EPUB

To jest część, którą pomijają ogólne poradniki. Tabela podsumowuje, co wersja 2.4.2 robi z każdym rodzajem treści, na podstawie kodu źródłowego (lib/element.py i lib/conversion.py w tagu v2.4.2).

Dwa z tych szczegółów powodują najbardziej widoczne szkody.

Dlaczego kursywa i linki znikają. Dla każdego akapitu wtyczka buduje tekst do tłumaczenia z tekstu zwykłego akapitu. Tylko znaczniki z jej listy chronionych są zastępowane symbolami zastępczymi. <em> lub <a> nie jest ani chroniony, ani ignorowany, więc jego słowa są tłumaczone, a znaczniki formatowania giną. W trybie dwujęzycznym oryginalny akapit zachowuje formatowanie, więc problem widać tylko w przetłumaczonym wierszu. W trybie tylko docelowym formatowanie znika. Możesz dodać selektory w sekcji Reserve Element, ale zarezerwowanie elementu pozostawia go nieprzetłumaczonym. Jest to przydatne w przypadku obcych zwrotów lub tytułów książek, które chcesz zachować, a niewłaściwe w przypadku wyróżnień, które chcesz przetłumaczyć.

Dlaczego przypisy mogą się psuć. Wydawcy oznaczają odsyłacze do przypisów na różne sposoby. Wtyczka ma specjalny przypadek dla linku, który obejmuje tylko indeks górny (<a href="#n1"><sup>1</sup></a>) i zachowuje ten link w nienaruszonym stanie. Odsyłacz zapisany jako <a href="#n1" class="noteref">1</a> nie ma indeksu górnego, więc numer przetrwa, ale link może nie. Sprawdź przypisy, zanim zaufasz tłumaczeniu literatury faktu tylko w trybie docelowym. W przypadku książek japońskich i chińskich zapoznaj się z jak tłumaczyć adnotacje ruby w EPUB, zanim zdecydujesz, czy utrata furigany jest do zaakceptowania.

Przetłumaczony element otrzymuje również atrybut lang dla języka docelowego oraz atrybut dir, co pomaga czytnikom e-booków wybierać czcionki i układ od prawej do lewej. W trybie dwujęzycznym tłumaczenie nie kopiuje atrybutu id oryginalnego elementu, więc istniejące zakotwiczenia nadal wskazują na oryginalny akapit.

Na koniec podręcznik konwersji Calibre opisuje, jak działa konwersja: dane wejściowe są przekształcane w XHTML, przetwarzane, a następnie zapisywane przez wtyczkę wyjściową. Po drodze przekształcenia Calibre mogą odtworzyć metadane i spis treści. Wtyczka tłumaczy po tych przekształceniach, tuż przed zapisaniem pliku przez wtyczkę wyjściową. Twój przetłumaczony EPUB jest zatem przebudowaną książką, a nie oryginalnym plikiem z nowym tekstem. Podręcznik Calibre zauważa, że jego system konwersji „nie zastępuje pełnoprawnego edytora e-booków”.

Sprawdź przetłumaczony EPUB w pięć minut

Nie oceniaj wyniku na podstawie pierwszego rozdziału. Przeprowadź porównanie strukturalne między oryginalnym a przetłumaczonym plikiem. EPUB to archiwum ZIP, więc standardowe narzędzia wiersza poleceń mogą policzyć znaczniki po każdej stronie:

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 odczytać wynik:

• Wynik tylko docelowy ze znacznie mniejszą liczbą tagów <em>, <i> lub <a niż źródło oznacza spłaszczone wyróżnienia lub linki. Jest to oczekiwane na podstawie powyższego zachowania. Zdecyduj, czy książka może obejść się bez nich.
• Mniejsza liczba tagów <img w wyniku tylko docelowym oznacza, że symbol zastępczy obrazu został utracony. W wyniku dwujęzycznym obrazy mogą pojawić się dwukrotnie, więc zamiast tego polegaj na wyszukiwaniu symboli zastępczych. Znajdź rozdział i napraw go w trybie zaawansowanym lub edytorze Calibre.
• Dowolny tekst {{id_…}} oznacza, że silnik zmienił symbol zastępczy, więc chroniony element nie został przywrócony.
• Wynik dwujęzyczny powinien mieć co najmniej tyle samo znaczników co źródło, ponieważ oryginalne akapity są zachowywane.

Wzorzec <em pasuje również do <embed, co jest rzadkie w książkach, ale warto o tym wiedzieć, jeśli liczba wydaje się dziwna.

Następnie uruchom EPUBCheck W3C na przetłumaczonym pliku. Otwórz go w czytniku, którego faktycznie będziesz używać, i sprawdź listę kontrolną QA tłumaczenia EPUB: nawigację, przypisy, obrazy i ostatni akapit każdego rozdziału. Jeśli książka jest dla innych osób, przetestuj ją na Kindle, Kobo i Apple Books.

Jeśli tłumaczenie zatrzyma się w połowie

Wtyczka domyślnie buforuje przetłumaczone akapity. Jeśli sieć padnie lub silnik zacznie odrzucać żądania, uruchom tę samą książkę ponownie z tymi samymi ustawieniami. Akapity, które są już w pamięci podręcznej, nie są tłumaczone ponownie. W praktyce:

1. Otwórz dziennik zadania w sekcji Jobs i poszukaj powtarzających się błędów, które zwykle wskazują na ograniczenie szybkości lub wygasły klucz API.
2. Zwiększ Interval lub zmniejsz Concurrency limit dla tego silnika.
3. Uruchom książkę ponownie. Pamięć podręczna wznowi od miejsca, w którym się zatrzymała.
4. Użyj Cache Manager, aby wyczyścić pamięć podręczną książki tylko wtedy, gdy chcesz uzyskać świeże tłumaczenie, na przykład po edycji glosariusza. Zmiana silnika lub języka docelowego już rozpoczyna osobną pamięć podręczną.

Kiedy Calibre jest właściwym narzędziem, a kiedy nie

Użyj wtyczki Calibre, gdy:

• książka nie ma DRM i jest już w Twojej bibliotece Calibre;
• chcesz samodzielnie wybrać silnik i za niego zapłacić;
• chcesz przeglądać akapity w trybie zaawansowanym; oraz
• książka to głównie zwykła proza, więc utrata formatowania w tekście niewiele kosztuje.

Poszukaj innego sposobu pracy, gdy:

• książka opiera się na formatowaniu w tekście, odsyłaczach lub powiązanych przypisach, jak wiele podręczników i książek akademickich;
• nazwy i terminy muszą być spójne na setkach stron, a nie chcesz samodzielnie prowadzić pliku glosariusza;
• wolisz nie przeprowadzać samodzielnie kontroli i napraw znaczników; lub
• nie czujesz się komfortowo z kluczami API, limitami szybkości i dziennikami zadań.

Jeśli druga lista opisuje Twoją książkę, jedną z opcji jest przesłanie pliku EPUB do BookTranslator i sprawdzenie ceny przed zapłatą. Ukończone zadania oferują zarówno pobieranie tylko w języku docelowym, jak i dwujęzyczne, a nazwy i kluczowe terminy są zachowywane spójnie dzięki wbudowanemu glosariuszowi, a nie plikowi, który sam piszesz. To usługa płatna. Niezależnie od użytego narzędzia, uruchom tę samą kontrolę znaczników na wyniku i przejrzyj każde długie tłumaczenie, zanim na nim polegasz. Porównanie narzędzi do tłumaczenia EPUB zestawia wtyczkę Calibre, narzędzia przeglądarkowe i usługi plikowe obok siebie, jeśli chcesz porównać przed wyborem.