Thông báo lỗi mà một cửa hàng hiện ra thường mơ hồ. Đôi khi nó chẳng nói gì hơn "tệp của bạn có vấn đề".
Nên việc đầu tiên cần làm là cho nó chạy qua một công cụ kiểm tra tên là EPUBCheck. Đó là công cụ chính thức do W3C phát hành và miễn phí. Cũng có những dịch vụ chạy nó trực tuyến.
Công cụ này cho bạn biết chính xác tệp nào, dòng nào, và cái gì sai. Điều đó đưa bạn tới nguyên nhân nhanh hơn nhiều so với thông báo lỗi của một cửa hàng.
Nếu EPUBCheck sạch mà cửa hàng vẫn từ chối tệp, nhiều khả năng đây không phải chuyện đặc tả EPUB mà là một yêu cầu riêng của cửa hàng đó. Xem phần bên dưới.
Nếu bạn tự làm EPUB một mình, những lỗi bạn vấp phải khá dễ đoán.
Bên trong một tệp EPUB có một tệp nhỏ tên là mimetype , và quy tắc là nó phải được lưu đầu tiên trong tệp ZIP, không nén.
Nén một thư mục bằng công cụ nén thông thường không thỏa mãn điều kiện đó. Đây là vấn đề phổ biến nhất khi một tệp EPUB được lắp ráp bằng tay.
Mọi tệp trong EPUB đều phải được khai báo trong <manifest> của content.opf .
Bạn thêm một tấm ảnh rồi quên khai báo, hoặc một tệp đã khai báo nay không còn — bất kỳ sự vênh nào trong hai cái đó cũng sinh ra lỗi.
EPUB 3 đòi hỏi những mục sau.
•dc:title (tên sách)
•dc:language (ngôn ngữ; vi cho tiếng Việt)
•dc:identifier (định danh)
•dcterms:modified (lần sửa cuối)
Một liên kết trong mục lục (nav.xhtml) trỏ tới một tệp không có ở đó. Chuyện này xảy ra khi bạn xóa một chương mà quên cập nhật mục lục.
Phần thân của một tệp EPUB được viết bằng XHTML, thứ khắt khe hơn HTML thông thường. Một thẻ chưa đóng, hoặc viết <br> (phải là <br />), đều sinh ra lỗi.
Chuyện này hay xảy ra khi các thẻ HTML được gõ thẳng vào bản thảo.
Nếu EPUBCheck báo không lỗi nào mà cửa hàng vẫn từ chối tệp, thì đó là yêu cầu của cửa hàng chứ không phải của đặc tả.
Yêu cầu nộp bài của từng cửa hàng thỉnh thoảng lại được cập nhật. Luôn xác nhận yêu cầu hiện hành trong trang trợ giúp của chính cửa hàng đó.
Những bản tóm lược của bên thứ ba, kể cả bài này, có thể đã lỗi thời. Tìm đúng nguyên văn thông báo lỗi trong phần trợ giúp của cửa hàng là con đường đáng tin cậy nhất.
Amazon chuyển tệp EPUB nhận được sang định dạng riêng của họ. Vấn đề có thể lộ ra ở bước chuyển đổi ấy, nên kiểm tra trong Kindle Previewer trước khi nộp sẽ thu hẹp nguyên nhân nhanh hơn.
Nếu Previewer mở được mà bài nộp vẫn bị từ chối thì nhiều khả năng vấn đề nằm ở thông tin đăng ký hoặc khâu xét duyệt của bạn hơn là ở chính tệp.
EPUBCheck viết bằng tiếng Anh, nhưng khi đã nắm được cấu trúc thì không khó.
| Nhãn | Ý nghĩa |
|---|---|
| FATAL | Nghiêm trọng. Tệp hoàn toàn không đứng vững |
| ERROR | Vi phạm đặc tả. Phải sửa |
| WARNING | Cảnh báo. Vẫn chạy, nhưng không được khuyến khích |
| INFO | Thông tin. Thường thì không phải làm gì |
Hãy xem FATAL và ERROR trước. WARNING thường có thể phát hành nguyên như vậy.
Bốn mươi lỗi liên tiếp trông thật vô vọng, nhưng thường thì tất cả đều đến từ một nguyên nhân duy nhất.
Chẳng hạn một dòng hỏng trong manifest sẽ làm mọi tệp được tham chiếu từ đó cùng thất bại.Chỉ sửa cái đầu tiên từ trên xuống rồi kiểm tra lại — con số thường sụp xuống ngay một lúc.
Nếu bạn sửa tay một tệp EPUB do công cụ tạo ra rồi làm hỏng nó, dựng lại từ bản thảo gốc thường nhanh hơn. Sửa bản thảo rồi chuyển đổi lại đáng tin cậy hơn là dập từng lỗi một.
EPUB FACTORY cho mọi tệp nó tạo ra chạy qua một lượt kiểm tra tuân thủ chuẩn rồi hiện kết quả cho bạn. Không cần tài khoản, không cần cài đặt.
Dùng thử EPUB FACTORYCông cụ chẩn đoán EPUB của chúng tôi chỉ ra những chỗ trên giấy tờ thì hợp lệ nhưng lại hỏng với người đọc thật, bằng chính ngôn ngữ của bạn. Nó chạy hoàn toàn trong trình duyệt, nên tệp của bạn không được gửi đi đâu cả. Miễn phí, không cần đăng ký.