Pesan galat yang ditunjukkan sebuah toko biasanya kabur. Kadang ia tidak berkata lebih dari "ada masalah dengan berkas Anda".
Jadi hal pertama yang harus dilakukan adalah melewatkannya pada alat validasi bernama EPUBCheck. Ia adalah alat resmi yang dibagikan W3C dan gratis. Ada pula layanan yang menjalankannya daring.
Alat itu memberi tahu Anda persis berkas mana, baris mana, dan apa yang salah. Itu membawa Anda ke penyebabnya jauh lebih cepat daripada pesan galat sebuah toko.
Kalau EPUBCheck bersih dan tokonya tetap menolak berkas itu, kemungkinan ini bukan soal spesifikasi EPUB melainkan persyaratan khusus toko tersebut. Lihat bagian di bawah.
Kalau Anda membuat EPUB sendiri, galat yang Anda temui cukup bisa ditebak.
Di dalam sebuah EPUB ada berkas kecil bernama mimetype , dan aturannya adalah ia harus disimpan paling depan dalam ZIP, tanpa kompresi.
Mengompres sebuah folder dengan alat kompresi biasa tidak memenuhi syarat itu. Inilah masalah yang paling umum ketika sebuah EPUB dirakit dengan tangan.
Setiap berkas dalam EPUB harus didaftarkan di <manifest> milik content.opf .
Anda menambahkan gambar dan lupa mendaftarkannya, atau berkas yang terdaftar sudah tidak ada — ketidakcocokan mana pun menghasilkan galat.
EPUB 3 mewajibkan hal berikut.
•dc:title (judulnya)
•dc:language (bahasa; id untuk bahasa Indonesia)
•dc:identifier (pengenal)
•dcterms:modified (terakhir diubah)
Sebuah tautan di daftar isi (nav.xhtml) menunjuk berkas yang tidak ada. Ini terjadi ketika Anda menghapus sebuah bab dan lupa memperbarui daftar isinya.
Badan sebuah EPUB ditulis dalam XHTML, yang lebih ketat daripada HTML biasa. Tag yang tidak ditutup, atau menulis <br> (harusnya <br />), menghasilkan galat.
Ini cenderung terjadi ketika tag HTML diketikkan langsung ke dalam naskah.
Kalau EPUBCheck melaporkan nol galat dan tokonya tetap menolak berkas itu, itu persyaratan toko, bukan spesifikasi.
Persyaratan unggahan tiap toko diperbarui dari waktu ke waktu. Selalu pastikan yang terkini di halaman bantuan toko tersebut.
Ringkasan dari pihak ketiga, termasuk artikel ini, bisa jadi sudah usang. Mencari teks persis pesan galat itu di bantuan tokonya adalah jalan yang paling bisa diandalkan.
Amazon mengubah EPUB yang diterimanya ke formatnya sendiri. Masalah bisa muncul pada tahap konversi itu, jadi memeriksanya di Kindle Previewer sebelum mengunggah mempersempit penyebabnya lebih cepat.
Kalau Previewer bisa membukanya tetapi unggahannya ditolak, masalahnya lebih mungkin ada pada keterangan pendaftaran Anda atau peninjauannya ketimbang pada berkasnya sendiri.
EPUBCheck menulis dalam bahasa Inggris, tetapi begitu Anda tahu bentuknya, itu tidak sulit.
| Label | Arti |
|---|---|
| FATAL | Fatal. Berkasnya sama sekali tidak berdiri utuh |
| ERROR | Melanggar spesifikasi. Harus diperbaiki |
| WARNING | Peringatan. Berfungsi, tetapi tidak dianjurkan |
| INFO | Informasi. Biasanya tidak menuntut apa-apa |
Lihat FATAL dan ERROR lebih dulu. WARNING biasanya bisa diterbitkan apa adanya.
Empat puluh galat beruntun terlihat mustahil, tetapi biasanya semuanya berasal dari satu penyebab.
Satu baris yang salah di manifest, misalnya, membuat setiap berkas yang dirujuk dari sana gagal.Perbaiki hanya yang pertama dari atas lalu validasi lagi — jumlahnya sering runtuh sekaligus.
Kalau Anda menyunting dengan tangan sebuah EPUB hasil alat lalu merusaknya, membangun ulang dari naskah aslinya biasanya lebih cepat. Memperbaiki naskah lalu mengonversi ulang lebih bisa diandalkan daripada menumpas galat satu per satu.
EPUB FACTORY melewatkan setiap berkas yang dibuatnya pada validasi yang patuh standar lalu menunjukkan hasilnya. Tanpa akun, tanpa pemasangan.
Coba EPUB FACTORYDiagnosis EPUB kami menunjukkan titik-titik yang di atas kertas sah tetapi rusak bagi pembaca sungguhan, dalam bahasa Anda sendiri. Ia berjalan sepenuhnya di peramban, jadi berkas Anda tidak dikirim ke mana pun. Gratis, tanpa pendaftaran.