EPUBCheck başvuru doğrulayıcısıdır. Satıcıların dosya kabul sistemleri onun üzerine kuruludur. Denetimden geçmek kabul garantisi değildir, çünkü kitap doğrulayıcının hiç bakmadığı nedenlerle de reddedilebilir. Ancak dosyalar çoğu zaman, kimse bakmadan önce bu denetimde takılır.
EPUBCheck'in çıktısı doğrudur ama okunması zordur: bir kod, bir dosya, satır ve sütun numarası ve standardı zaten bilen biri için yazılmış bir cümle. Bu sayfa bu çıktıyı açıklar. Geçerli bir EPUB on beş farklı biçimde bozuldu ve doğrulayıcının yanıtları kaydedildi. Aşağıdaki iletiler sizin de göreceğiniz iletilerdir.
Paketleme hataları
EPUB bir ZIP arşividir ve arşivin nasıl oluşturulacağına dair kuralları vardır. Bu kurallar ilk denetlenen ve en sık bozulan kurallardır, çünkü bir klasörü Finder'da ya da Dosya Gezgini'nde sıkıştırmak bu kuralları bozar.
PKG-007 mimetype dosyası sıkıştırılmış
İlk dosyanın adı mimetype olmalı, sonunda satır sonu olmadan
yalnız bu dizeyi içermeli ve sıkıştırılmadan saklanmalıdır. Sıradan
bir ZIP aracı her şeyi sıkıştırdığı için açılmış bir EPUB'u elle yeniden
sıkıştırmak neredeyse her zaman bu hataya yol açar.
PKG-006 mimetype dosyası ilk sırada değil
ZIP içindeki dosyaların sırası alfabetik değildir ve dosya yöneticileri bu sırayı belirlemenize izin vermez. Okuma cihazının biçimi ilk baytlardan tanıyabilmesi için mimetype kaydı ilk sırada olmalıdır.
Kodlar çoğu kişinin sandığının tersidir: Sıkıştırma PKG-007, sıra PKG-006'dır. Numaraya değil, iletiye bakın.
Başvuru hataları
Bu hataların hepsi aynı sorundan kaynaklanır: Bir öğe, var olmayan bir şeyi gösterir. Bu genellikle yeniden adlandırılmış, taşınmış ya da arşive hiç konmamış bir dosyadır. Bu hatalar sık görülür.
RSC-001 Manifestte adı geçen bir dosya arşivde yok
Paket belgesi arşivde bulunmayan bir dosyayı bildiriyor. Bu genellikle metne diskten yerleştirilmiş ama e-kitaba hiç kopyalanmamış bir görseldir.
RSC-007 Bir bağlantı ya da stil dosyası eksik bir dosyayı gösteriyor
Aynı hatanın öteki yüzüdür: Bir bölüm, arşivde olmayan bir sayfaya bağlantı
verir. Yazı tipi dosyası geride kalmış bir @font-face kuralını da
yakalar. Bu durum, tema bir projeden ötekine kopyalandığında sık görülür.
RSC-012 Bir bağlantı var olmayan bir çapayı gösteriyor
Dosya doğrudur, ardından gelen #çapa yanlıştır. Bu çoğu zaman bir
düzeltmede notu silinen ama gönderme işareti kalan bir dipnot ya da
sonnottur.
RSC-011 İçindekiler, okuma sırasının dışındaki bir öğeyi gösteriyor
İçindekiler listesi, var olan ama okurun izlediği sırada bulunmayan bir bölüme bağlantı veriyor. Bu hatayı ciddiye alın. Nedeni sayfanın son bölümünde anlatılır.
OPF-049 Okuma sırası, manifestte olmayan bir kaydı gösteriyor
Bu hata, aynı şeyi standardın diliyle söyleyen bir RSC-005 ile birlikte gelir: bir sorun, iki ileti. EPUBCheck'in hata sayısı, sorun sayısı değildir.
RSC-006 ve OPF-014 Bir görsel internetten yükleniyor
The property "remote-resources" should be declared in the OPF file.
E-kitap gösterdiği her şeyi kendi içinde taşımalıdır. Kaynağı
https:// ile başlayan bir <img>, okur
çevrimdışıyken
görünmez. Bu yüzden kabul edilmez.
Belge hataları
RSC-016 (ölümcül) XHTML düzgün biçimlenmemiş
XHTML bir XML biçimidir ve XML hata kabul etmez: Kapatılmamış tek bir etiket okumayı durdurur. Hata iki kez, FATAL RSC-016 ve ERROR RSC-005 olarak bildirilir ve bozuk etiketten sonraki hiçbir şey denetlenmez. Raporun geri kalanını okumadan önce bu hatayı düzeltip doğrulamayı yeniden çalıştırın.
Tarayıcılar bozuk HTML'i sessizce onarır. Bu yüzden bir dosya tarayıcıda kusursuz görünüp burada ölümcül hata verebilir.
RSC-005 Zorunlu bir öğe eksik ya da yanlış yerde
Error while parsing file: Exactly one "toc" nav element must be present
RSC-005, “dosya şemaya uymuyor” anlamına gelen genel iletidir. Asıl bilgi iki noktadan sonraki cümlededir. Yukarıdaki iki örnek sık görülür: başlığı olmayan bir paket belgesi ve içindekiler listesi içindekiler olarak işaretlenmemiş bir gezinme belgesi.
OPF-003 (uyarı) Bir dosya arşivde var ama bildirilmemiş
Genellikle zararsızdır: artık bir dosya, bir .DS_Store ya da bir
düzenleyicinin yedek dosyası. Yine de silin, çünkü okurlar bu gereksiz yükü
indirmek zorunda kalır.
Denetimden geçen ama güven vermemesi gereken iki durum
İkisi de 0 hata verdi, ama iki dosya da doğru değil.
-
Eski bir DOCTYPE.
<!DOCTYPE html>yerine eski XHTML 1.1 doctype kullanılan dosya sorunsuz geçti. Bunu hata sayan öneriler güncel değildir. -
Dil etiketi olmayan bir dil etiketi.
enyerine yazılanenglishhiçbir uyarı almadan geçti. Okuma cihazları bu alanı heceleme ve sesli okuma için kullanır. Yanlış değer kitabı fark edilmeden bozar.
EPUBCheck'in yakalayamadığı hata
Bir bölüm hem okuma sırasından hem de içindekiler listesinden çıkarıldı, dosyası ise arşivde bırakıldı. Sonuç:
Messages: 0 fatals / 0 errors / 0 warnings / 0 infos
Geçerli ama bir bölümü eksik bir e-kitap. Standart yalnız EPUB'un bildirdiği parçaların birbiriyle tutmasını ister. Bu dosyada da tutuyorlardı. Bölümü bu iki yerden yalnız birinden çıkarırsanız RSC-011 alırsınız. İkisinden de çıkarırsanız kitap kısalır.
Temiz bir EPUBCheck raporu, dosyanın doğru biçimlendiğini gösterir. Dosyanın sizin kitabınız olduğunu göstermez. Eksik bir bölümü ancak kitabı açıp bölümleri saymak ortaya çıkarır.
Rapor nasıl okunur?
- Önce bütün FATAL hataları düzeltin. Okuma orada durduğu için raporun geri kalanı eksik bir dosyaya göre yazılmıştır.
- Tek bir sorun birkaç ileti üretebilir. Listeyi sırayla düzeltmek yerine nedenleri düzeltip doğrulamayı yeniden çalıştırın.
- RSC-005'te kodu değil, cümleyi okuyun.
- Uyarıları düzeltmek zorunlu değildir ama kolaydır. Temizleyin. Böylece yeni bir uyarı göze çarpar.
Torcul doğrulamayı EPUBCheck ile yapar. Bu sayfa iletileri özgün hâliyle aktarır, çünkü yorumlanan bir ileti ne yapılacağını söyleyen kısmı kaybeder.