Cara Menerjemahkan EPUB dengan Calibre: Penyiapan Plugin, Mode Output, dan Pemeriksaan File

Calibre tidak menerjemahkan buku dengan sendirinya. Anda menerjemahkan EPUB di Calibre dengan Ebook Translator, plugin pihak ketiga dari bookfere yang terdaftar di indeks plugin Calibre. Pasang dari Preferences → Plug-ins → Get new plugins, pilih mesin terjemahan, tentukan apakah Anda ingin terjemahan saja atau di samping aslinya, lalu jalankan pada EPUB tanpa DRM. Anda akan mendapatkan EPUB baru di pustaka Calibre Anda.

Penyiapannya adalah bagian yang cepat. Yang sering dilewatkan panduan lain adalah apa yang dilakukan plugin pada buku selama proses. Kami membaca kode sumber rilis saat ini (v2.4.2) untuk mengetahuinya, dan tiga pengaturan default lebih penting daripada mesin yang Anda pilih:

1. Output default bersifat bilingual. Setiap paragraf terjemahan ditempatkan di bawah aslinya kecuali Anda mengubah pengaturan posisi.
2. Pemformatan inline diratakan dalam teks terjemahan. Miring, tebal, dan tautan di dalam paragraf tidak dibawa ke terjemahan. Hanya daftar tag tetap, seperti gambar, jeda baris, dan superskrip, yang dilindungi dan dikembalikan.
3. Setiap proses adalah konversi Calibre. Bahkan EPUB ke EPUB, plugin menyerahkan buku ke alur konversi Calibre, yang membangun ulang file output.

Semua ini tidak membuat plugin menjadi pilihan buruk. Plugin ini gratis, open source (GPL-3.0), dan sangat dapat dikonfigurasi. Tetapi Anda harus tahu apa yang perlu diperiksa sebelum membaca hasilnya, atau membagikannya.

Catatan tentang metode: panduan ini didasarkan pada kode sumber v2.4.2 plugin, dokumentasi resminya, dan manual Calibre. Kami tidak menjalankan terjemahan berwaktu untuk artikel ini, jadi tidak ada klaim tentang kecepatan, kualitas terjemahan, atau mesin mana yang memberikan hasil terbaik.

Yang Anda butuhkan sebelum memulai

Plugin juga menerima format lain yang dapat dibaca Calibre, seperti MOBI atau AZW3. Karena buku melewati konversi Calibre baik dengan cara apa pun, memulai dari EPUB yang bersih memberi Anda output yang paling dapat diprediksi.

Pasang plugin Ebook Translator

Dokumentasi plugin memberikan dua cara untuk memasangnya:

1. Dari dalam Calibre (disarankan): buka Preferences → Plug-ins → Get new plugins, cari Ebook Translator, klik Install, lalu mulai ulang Calibre.
2. Dari file: unduh ZIP dari halaman plugin, lalu gunakan Preferences → Plug-ins → Load plug-in from file dan mulai ulang.

Jika plugin tidak muncul di toolbar, tambahkan di bawah Preferences → Toolbars & menus → The main toolbar.

Calibre mencantumkan penulis plugin sebagai bookfere.com. Tim Calibre tidak memeliharanya. Laporkan masalah ke repositori GitHub plugin, bukan ke Calibre.

Mode Batch atau Mode Lanjutan

Plugin ini memiliki dua cara untuk menjalankan terjemahan:

• Mode Batch: pilih satu atau beberapa buku, atur bahasa target dan format keluaran, lalu klik Translate. Pekerjaan berjalan di antrean pekerjaan Calibre. Gunakan ini untuk draf pertama seluruh buku yang akan Anda baca sekali.
• Mode Lanjutan: ekstrak paragraf satu buku ke dalam tabel, terjemahkan semuanya atau hanya yang dipilih, edit terjemahan mana pun secara manual, lalu klik Output. Gunakan ini ketika buku itu penting, misalnya ketika beberapa bab perlu diterjemahkan ulang atau nama perlu diperbaiki, karena Anda dapat mengoreksi paragraf sebelum EPUB ditulis.

Jika Anda akan meninjau terjemahan tetap, Mode Lanjutan memungkinkan Anda melakukan perbaikan di plugin. Dengan Mode Batch, Anda akan melakukannya nanti di editor Calibre.

Pilih mesin terjemahan

Mesin Google gratis adalah default. Versi 2.4.2 menawarkan mesin-mesin ini (nama seperti yang muncul di plugin):

Default yang memengaruhi buku panjang:

• Interval antarpermintaan bergantung pada mesinnya. Dalam sumber v2.4.2, intervalnya 20 detik untuk ChatGPT (OpenAI dan Azure), 12 detik untuk Claude, 1 detik untuk Gemini dan DeepL (Free), dan 0 untuk sebagian besar lainnya. Dokumentasi menyarankan untuk menaikkannya jika layanan mulai menolak permintaan.
• Attempt times adalah 3, dan proses dibatalkan setelah 10 error berturut-turut. Setel jumlah pembatalan ke 0 agar tidak pernah berhenti otomatis.
• Timeout juga bergantung pada mesinnya: 60 detik untuk ChatGPT dan DeepSeek, 30 detik untuk Claude dan Gemini, dan 10 detik untuk sisanya.
• Merge to Translate nonaktif. Saat diaktifkan, plugin mengirim paragraf dalam batch hingga 1.800 karakter. Batch memberi LLM lebih banyak konteks di sekitarnya per permintaan, tetapi satu respons buruk kemudian memengaruhi beberapa paragraf sekaligus.
• Glossary nonaktif. Saat diaktifkan, plugin membaca file teks biasa. Istilah dan terjemahannya ditulis pada dua baris, istilah yang dibiarkan tanpa terjemahan ditulis pada satu baris, dan entri dipisahkan oleh baris kosong.

Plugin ini gratis, tetapi terjemahannya tidak selalu gratis. Novel 300 halaman yang dikirim ke API berbayar akan ditagih seperti penggunaan API lainnya. Panduan kami untuk ChatGPT, Claude, dan DeepSeek untuk terjemahan menjelaskan apa yang cenderung salah dilakukan setiap model pada teks panjang.

Pilih output hanya target atau bilingual

Setelan Translation Position menentukan bentuk buku:

Jika Anda ingin buku yang bisa langsung dibaca, ubah posisi ke Tanpa teks asli sebelum memulai, karena pengaturan bawaan menghasilkan buku bilingual.

Hati-hati dengan opsi kiri dan kanan. Di sumbernya, setiap pasangan dibangun ulang sebagai baris tabel dengan tiga sel: teks asli, celah, dan terjemahan. Dengan celah bawaan 10%, kolom teks masing-masing selebar 45%. Di ponsel atau e-reader 6 inci, itu menjadi dua lajur teks yang sempit. Panduan EPUB bilingual kami membandingkan tata letak bilingual yang tetap nyaman di layar kecil.

Apa yang diubah plugin di dalam EPUB Anda

Inilah bagian yang tidak dibahas tutorial umum. Tabel ini merangkum apa yang dilakukan v2.4.2 terhadap setiap jenis konten, berdasarkan kode sumber (lib/element.py dan lib/conversion.py pada tag v2.4.2).

Dua dari detail ini menyebabkan kerusakan yang paling terlihat.

Mengapa huruf miring dan tautan menghilang. Untuk setiap paragraf, plugin menyusun teks yang akan diterjemahkan dari teks biasa paragraf tersebut. Hanya tag yang ada dalam daftar lindungnya yang diganti dengan placeholder. Sebuah <em> atau <a> tidak dilindungi maupun diabaikan, sehingga kata-katanya diterjemahkan dan markup-nya hilang. Dalam mode bilingual, paragraf asli mempertahankan formatnya, jadi masalahnya hanya muncul di baris terjemahan. Dalam mode target-only, formatnya hilang. Anda dapat menambahkan selektor di bawah Reserve Element, tetapi mencadangkan elemen membuatnya tidak diterjemahkan. Itu berguna untuk frasa asing atau judul buku yang ingin Anda pertahankan, dan salah untuk penekanan yang ingin Anda terjemahkan.

Mengapa catatan kaki bisa rusak. Penerbit menandai referensi catatan kaki dengan cara yang berbeda-beda. Plugin memiliki kasus khusus untuk tautan yang hanya membungkus superscript (<a href="#n1"><sup>1</sup></a>) dan menjaga tautan itu tetap utuh. Referensi yang ditulis sebagai <a href="#n1" class="noteref">1</a> tidak memiliki superscript, sehingga angkanya bertahan tetapi tautannya mungkin tidak. Periksa catatan sebelum Anda mempercayai terjemahan target-only dari buku nonfiksi. Untuk buku Jepang dan Tionghoa, lihat cara menerjemahkan anotasi ruby EPUB sebelum Anda memutuskan apakah kehilangan furigana dapat diterima.

Elemen terjemahan juga mendapatkan atribut lang untuk bahasa target dan atribut dir, yang membantu e-reader memilih font dan tata letak kanan-ke-kiri. Dalam mode bilingual, terjemahan tidak menyalin id elemen asli, sehingga anchor yang ada tetap mengarah ke paragraf asli.

Terakhir, panduan konversi Calibre menjelaskan cara kerja konversi: input diubah menjadi XHTML, ditransformasi, lalu ditulis oleh plugin output. Sepanjang proses, transformasi Calibre dapat meregenerasi metadata dan daftar isi. Plugin menerjemahkan setelah transformasi tersebut, tepat sebelum plugin output menulis file. EPUB terjemahan Anda karenanya adalah buku yang dibangun ulang, bukan file asli Anda dengan teks baru. Panduan Calibre mencatat bahwa sistem konversinya "bukan pengganti editor e-book lengkap."

Periksa EPUB terjemahan dalam lima menit

Jangan menilai hasilnya dari bab pertama. Lakukan perbandingan struktural antara file asli dan file terjemahan. EPUB adalah arsip ZIP, jadi alat baris perintah standar dapat menghitung markup di setiap sisi:

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

Cara membaca hasilnya:

• Output target-only dengan jauh lebih sedikit tag <em>, <i>, atau <a daripada sumber berarti penekanan atau tautan diratakan. Itu sudah diduga dari perilaku di atas. Putuskan apakah buku tersebut bisa hidup tanpanya.
• Lebih sedikit tag <img di output target-only berarti placeholder gambar hilang. Di output bilingual, gambar bisa muncul dua kali, jadi andalkan pencarian placeholder saja. Temukan babnya dan perbaiki di Mode Lanjutan atau editor Calibre.
• Teks {{id_…}} apa pun berarti mesin mengubah placeholder, sehingga elemen yang dilindungi tidak dipulihkan.
• Output bilingual harus memiliki setidaknya sebanyak tag sumber, karena paragraf asli dipertahankan.

Pola <em juga cocok dengan <embed, yang jarang ada di buku tetapi perlu diketahui jika jumlahnya terlihat aneh.

Lalu jalankan EPUBCheck dari W3C pada file terjemahan. Buka di pembaca yang benar-benar akan Anda gunakan, dan periksa daftar periksa QA terjemahan EPUB: navigasi, catatan, gambar, dan paragraf terakhir setiap bab. Jika buku itu untuk orang lain, uji di Kindle, Kobo, dan Apple Books.

Jika terjemahan berhenti di tengah jalan

Plugin ini menyimpan cache paragraf terjemahan secara default. Jika jaringan terputus atau mesin mulai menolak permintaan, jalankan buku yang sama lagi dengan pengaturan yang sama. Paragraf yang sudah di-cache tidak diterjemahkan lagi. Dalam praktiknya:

1. Buka log pekerjaan di bawah Jobs dan cari kesalahan berulang, yang biasanya menunjukkan pembatasan laju atau kunci API yang kedaluwarsa.
2. Naikkan Interval atau turunkan Batas konkurensi untuk mesin tersebut.
3. Jalankan ulang buku. Cache melanjutkan dari tempat berhenti.
4. Gunakan Cache Manager untuk menghapus cache buku hanya ketika Anda ingin terjemahan baru, misalnya setelah mengedit glosarium. Mengganti mesin atau bahasa target sudah memulai cache terpisah.

Kapan Calibre adalah alat yang tepat, dan kapan tidak

Gunakan plugin Calibre ketika:

• buku bebas DRM dan sudah ada di pustaka Calibre Anda;
• Anda ingin memilih dan membayar mesin sendiri;
• Anda senang meninjau paragraf di Mode Lanjutan; dan
• buku sebagian besar berupa prosa biasa, sehingga kehilangan format inline tidak banyak merugikan.

Cari alur kerja lain ketika:

• buku bergantung pada format inline, referensi silang, atau catatan tertaut, seperti banyak buku teks dan buku akademik;
• nama dan istilah harus konsisten di ratusan halaman dan Anda tidak ingin memelihara file glosarium sendiri;
• Anda lebih suka tidak menjalankan pemeriksaan dan perbaikan markup sendiri; atau
• Anda tidak nyaman dengan kunci API, batas laju, dan log pekerjaan.

Jika daftar kedua menggambarkan buku Anda, salah satu opsi adalah unggah EPUB ke BookTranslator dan lihat harganya sebelum membayar. Tugas yang selesai menawarkan unduhan khusus target dan bilingual, serta nama dan istilah kunci dijaga konsisten dengan glosarium bawaan alih-alih file yang Anda tulis. Ini layanan berbayar. Apa pun alat yang Anda gunakan, jalankan pemeriksaan markup yang sama di atas pada output, dan tinjau terjemahan panjang sebelum Anda mengandalkannya. Perbandingan alat terjemahan EPUB menempatkan plugin Calibre, alat browser, dan layanan file berdampingan, jika Anda ingin membandingkan sebelum memilih.