Cara Menterjemah EPUB dengan Calibre: Persediaan Plugin, Mod Output, dan Semakan Fail

Calibre tidak menterjemah buku dengan sendirinya. Anda menterjemah EPUB dalam Calibre dengan Ebook Translator, plugin pihak ketiga oleh bookfere yang tersenarai dalam indeks plugin Calibre. Pasangnya dari Preferences → Plug-ins → Get new plugins, pilih enjin terjemahan, pilih sama ada anda mahu terjemahan sahaja atau bersebelahan dengan asal, dan jalankannya pada EPUB tanpa DRM. Anda akan dapat EPUB baharu dalam pustaka Calibre anda.

Menyediakannya adalah bahagian yang pantas. Apa yang kebanyakan panduan terlepas ialah apa yang plugin lakukan pada buku sepanjang proses itu. Kami membaca kod sumber keluaran semasa (v2.4.2) untuk mengetahuinya, dan tiga tetapan lalai lebih penting daripada enjin yang anda pilih:

1. Output lalai adalah dwibahasa. Setiap perenggan terjemahan diletakkan di bawah asal melainkan anda mengubah tetapan kedudukan.
2. Pemformatan sebaris diratakan dalam teks terjemahan. Italik, tebal, dan pautan dalam perenggan tidak dibawa ke dalam terjemahan. Hanya senarai tetap tag, seperti imej, pemisah baris, dan superskrip, dilindungi dan dikembalikan.
3. Setiap jalan adalah penukaran Calibre. Walaupun EPUB ke EPUB, plugin menyerahkan buku itu kepada saluran penukaran Calibre, yang membina semula fail output.

Semua ini tidak menjadikan plugin itu pilihan yang buruk. Ia percuma, sumber terbuka (GPL-3.0), dan sangat boleh dikonfigurasi. Tetapi anda harus tahu apa yang perlu diperiksa sebelum anda membaca hasilnya, atau berkongsinya.

Nota tentang kaedah: panduan ini berdasarkan kod sumber v2.4.2 plugin, dokumentasi rasminya, dan manual Calibre. Kami tidak menjalankan terjemahan bermasa untuk artikel ini, jadi ia tidak membuat sebarang dakwaan tentang kelajuan, kualiti terjemahan, atau enjin mana yang memberikan hasil terbaik.

Apa yang anda perlukan sebelum bermula

Plugin juga menerima format lain yang boleh dibaca Calibre, seperti MOBI atau AZW3. Kerana buku itu melalui penukaran Calibre sama ada cara, bermula dari EPUB yang bersih memberikan anda output yang paling boleh dijangka.

Pasang plugin Ebook Translator

Dokumentasi plugin memberikan dua cara untuk memasangnya:

1. Dari dalam Calibre (disyorkan): buka Preferences → Plug-ins → Get new plugins, cari Ebook Translator, klik Install, kemudian mulakan semula Calibre.
2. Daripada fail: muat turun ZIP daripada laman utama pemalam, kemudian gunakan Keutamaan → Pemalam → Muat pemalam daripada fail dan mulakan semula.

Jika pemalam tidak muncul pada bar alat, tambahkannya di bawah Keutamaan → Bar alat & menu → Bar alat utama.

Calibre menyenaraikan pengarang pemalam sebagai bookfere.com. Pasukan Calibre tidak menyelenggaranya. Laporkan masalah kepada repositori GitHub pemalam, bukan kepada Calibre.

Mod Kelompok atau Mod Lanjutan

Pemalam ini mempunyai dua cara untuk menjalankan terjemahan:

• Mod Kelompok: pilih satu atau lebih buku, tetapkan bahasa sasaran dan format output, kemudian klik Terjemah. Tugasan ini berjalan dalam baris gilir tugasan Calibre. Gunakan ini untuk draf pertama keseluruhan buku yang anda rancang untuk baca sekali sahaja.
• Mod Lanjutan: ekstrak perenggan satu buku ke dalam jadual, terjemah semua atau hanya yang dipilih, edit mana-mana terjemahan secara manual, kemudian klik Output. Gunakan ini apabila buku itu penting, contohnya apabila beberapa bab perlu diterjemah semula atau nama perlu dibetulkan, kerana anda boleh membetulkan perenggan sebelum EPUB ditulis.

Jika anda akan menyemak terjemahan itu juga, Mod Lanjutan membolehkan anda membuat pembetulan dalam pemalam. Dengan Mod Kelompok, anda akan membuatnya kemudian dalam editor Calibre.

Pilih enjin terjemahan

Enjin Google percuma ialah lalai. Versi 2.4.2 menawarkan enjin ini (nama seperti yang muncul dalam pemalam):

Lalai yang mempengaruhi buku panjang:

• Selang antara permintaan bergantung pada enjin. Dalam sumber v2.4.2, ia adalah 20 saat untuk ChatGPT (OpenAI dan Azure), 12 saat untuk Claude, 1 saat untuk Gemini dan DeepL (Percuma), dan 0 untuk kebanyakan yang lain. Dokumentasi mencadangkan supaya dinaikkan jika perkhidmatan mula menolak permintaan.
• Bilangan percubaan ialah 3, dan proses dibatalkan selepas 10 ralat berturut-turut. Tetapkan bilangan pembatalan kepada 0 supaya tidak pernah berhenti secara automatik.
• Masa tamat juga bergantung pada enjin: 60 saat untuk ChatGPT dan DeepSeek, 30 saat untuk Claude dan Gemini, dan 10 saat untuk yang lain.
• Gabung untuk Terjemah dimatikan. Apabila dihidupkan, pemalam menghantar perenggan dalam kelompok sehingga 1,800 aksara. Kelompok memberi LLM lebih konteks sekeliling setiap permintaan, tetapi satu respons yang buruk kemudian menjejaskan beberapa perenggan sekaligus.
• Glosari dimatikan. Apabila dihidupkan, ia membaca fail teks biasa. Istilah dan terjemahannya diletakkan pada dua baris, istilah yang dibiarkan tidak diterjemah diletakkan pada satu baris, dan entri dipisahkan oleh baris kosong.

Pemalam ini percuma, tetapi terjemahannya tidak selalunya percuma. Novel 300 halaman yang dihantar ke API berbayar akan dicaj seperti penggunaan API biasa. Panduan kami untuk ChatGPT, Claude, dan DeepSeek untuk terjemahan menerangkan apa yang cenderung salah pada setiap model dalam teks panjang.

Pilih output sasaran sahaja atau dwibahasa

Tetapan Kedudukan Terjemahan menentukan bentuk buku:

Jika anda mahukan buku yang boleh dibaca terus, tukar kedudukan kepada Tanpa teks asal sebelum anda mula, kerana tetapan lalai menghasilkan buku dwibahasa.

Berhati-hati dengan pilihan kiri dan kanan. Dalam sumber, setiap pasangan dibina semula sebagai baris jadual dengan tiga sel: teks asal, jurang, dan terjemahan. Dengan jurang lalai 10%, lajur teks masing-masing selebar 45%. Pada telefon atau pembaca e-buku 6 inci, ini menjadi dua jalur teks yang sempit. Panduan EPUB dwibahasa kami membandingkan susun atur dwibahasa yang masih kelihatan baik pada skrin kecil.

Apa yang diubah oleh pemalam di dalam EPUB anda

Inilah bahagian yang sering tertinggal dalam tutorial generik. Jadual ini merumuskan apa yang dilakukan oleh v2.4.2 terhadap setiap jenis kandungan, berdasarkan kod sumber (lib/element.py dan lib/conversion.py pada tag v2.4.2).

Dua daripada butiran ini menyebabkan kerosakan yang paling ketara.

Mengapa huruf condong dan pautan hilang. Untuk setiap perenggan, plugin membina teks untuk diterjemah daripada teks biasa perenggan tersebut. Hanya tag dalam senarai terlindungnya digantikan dengan pemegang tempat. <em> atau <a> tidak dilindungi mahupun diabaikan, jadi perkataannya diterjemah dan penandaannya hilang. Dalam mod dwibahasa, perenggan asal mengekalkan pemformatannya, jadi masalah hanya kelihatan pada baris terjemahan. Dalam mod sasaran sahaja, pemformatan itu hilang. Anda boleh menambah pemilih di bawah Reserve Element, tetapi menyimpan elemen bermakna ia kekal tidak diterjemah. Itu berguna untuk frasa asing atau tajuk buku yang anda mahu kekalkan, dan salah untuk penekanan yang anda mahu terjemahkan.

Mengapa nota kaki boleh rosak. Penerbit menandakan rujukan nota kaki dengan cara yang berbeza. Plugin mempunyai kes khas untuk pautan yang hanya membalut superskrip (<a href="#n1"><sup>1</sup></a>) dan mengekalkan pautan itu utuh. Rujukan yang ditulis sebagai <a href="#n1" class="noteref">1</a> tidak mempunyai superskrip, jadi nombornya kekal tetapi pautannya mungkin tidak. Periksa nota sebelum anda mempercayai terjemahan sasaran sahaja bagi buku bukan fiksyen. Untuk buku Jepun dan Cina, lihat cara menterjemah anotasi ruby EPUB sebelum anda memutuskan sama ada kehilangan furigana boleh diterima.

Elemen terjemahan juga mendapat atribut lang untuk bahasa sasaran dan atribut dir, yang membantu pembaca e-buku memilih fon dan susun atur kanan-ke-kiri. Dalam mod dwibahasa, terjemahan tidak menyalin id elemen asal, jadi sauh sedia ada masih menunjuk kepada perenggan asal.

Akhir sekali, manual penukaran Calibre menerangkan cara penukaran berfungsi: input ditukar menjadi XHTML, diubah suai, dan kemudian ditulis oleh plugin output. Sepanjang proses itu, transformasi Calibre boleh menjana semula metadata dan jadual kandungan. Plugin menterjemah selepas transformasi tersebut, tepat sebelum plugin output menulis fail. EPUB terjemahan anda oleh itu ialah buku yang dibina semula, bukan fail asal anda dengan teks baharu. Manual Calibre menyatakan bahawa sistem penukarannya "bukan pengganti penyunting e-buku yang lengkap."

Periksa EPUB terjemahan dalam lima minit

Jangan nilai hasilnya daripada bab pertama. Jalankan perbandingan struktur antara fail asal dan fail terjemahan. EPUB ialah arkib ZIP, jadi alat baris arahan standard boleh mengira penandaan pada 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 sasaran sahaja dengan jauh lebih sedikit tag <em>, <i>, atau <a berbanding sumber bermakna penekanan atau pautan diratakan. Itu dijangka daripada tingkah laku di atas. Tentukan sama ada buku itu boleh hidup tanpanya.
• Lebih sedikit tag <img dalam output sasaran sahaja bermakna pemegang tempat imej telah hilang. Dalam output dwibahasa, imej boleh muncul dua kali, jadi bergantung pada carian pemegang tempat sebaliknya. Cari bab tersebut dan betulkannya dalam Mod Lanjutan atau penyunting Calibre.
• Sebarang teks {{id_…}} bermaksud enjin telah mengubah pemegang tempat, jadi elemen yang dilindungi tidak dipulihkan.
• Output dwibahasa sepatutnya mempunyai sekurang-kurangnya bilangan tag yang sama dengan sumber, kerana perenggan asal dikekalkan.

Corak <em juga sepadan dengan <embed, yang jarang berlaku dalam buku tetapi berguna untuk diketahui jika kiraan kelihatan pelik.

Kemudian jalankan EPUBCheck W3C pada fail terjemahan. Buka dalam pembaca yang akan anda gunakan sebenarnya, dan semak senarai semak QA terjemahan EPUB: navigasi, nota, imej, dan perenggan terakhir setiap bab. Jika buku itu untuk orang lain, ujinya pada Kindle, Kobo, dan Apple Books.

Jika terjemahan berhenti separuh jalan

Pemalam menyimpan perenggan terjemahan secara lalai. Jika rangkaian terputus atau enjin mula menolak permintaan, jalankan semula buku yang sama dengan tetapan yang sama. Perenggan yang sudah disimpan tidak diterjemah semula. Secara praktikal:

1. Buka log kerja di bawah Jobs dan cari ralat berulang, yang biasanya menunjukkan penyekatan atau kunci API yang telah tamat tempoh.
2. Naikkan Interval atau turunkan Had serentak untuk enjin tersebut.
3. Jalankan semula buku. Cache menyambung dari tempat ia berhenti.
4. Gunakan Pengurus Cache untuk mengosongkan cache buku hanya apabila anda mahukan terjemahan baharu, contohnya selepas mengedit glosari anda. Menukar enjin atau bahasa sasaran sudah memulakan cache yang berasingan.

Bila Calibre ialah alat yang tepat, dan bila ia tidak

Gunakan pemalam Calibre apabila:

• buku itu bebas DRM dan sudah ada dalam pustaka Calibre anda;
• anda mahu memilih dan membayar enjin sendiri;
• anda selesa menyemak perenggan dalam Mod Lanjutan; dan
• buku itu kebanyakannya prosa biasa, jadi kehilangan pemformatan dalam baris kosnya sedikit.

Cari aliran kerja lain apabila:

• buku itu bergantung pada pemformatan dalam baris, rujukan silang, atau nota berpaut, seperti kebanyakan buku teks dan buku akademik;
• nama dan istilah mesti kekal konsisten merentas ratusan halaman dan anda tidak mahu menyelenggara fail glosari sendiri;
• anda lebih suka tidak menjalankan pemeriksaan dan pembaikan markup sendiri; atau
• anda tidak selesa dengan kunci API, had kadar, dan log kerja.

Jika senarai kedua itu menggambarkan buku anda, satu pilihan ialah muat naik EPUB ke BookTranslator dan lihat harga sebelum anda membayar. Tugasan yang selesai menawarkan muat turun sasaran sahaja dan dwibahasa, dan nama serta istilah utama dikekalkan konsisten dengan glosari terbina dalam dan bukan fail yang anda tulis. Ia perkhidmatan berbayar. Apa sahaja alat yang anda gunakan, jalankan pemeriksaan markup yang sama di atas pada output, dan semak sebarang terjemahan panjang sebelum anda bergantung padanya. Perbandingan alat terjemahan EPUB meletakkan pemalam Calibre, alat pelayar, dan perkhidmatan fail bersebelahan, jika anda mahu membandingkan sebelum memilih.