godotengine / godotengine/godot-docs

Large amount of EPUB errors

Open
#10,879 1 comment 0 reactions 0 assignees View on GitHub
bug content:website
Dominant language
reStructuredText
Stars
5.7k
Forks
3.8k
Avg merge
1d 20h
Merged PRs (30d)
25

Description

This issue is more of a note for myself to look into this further.

In the past we've had users complain about issues reading our EPUBs on certain apps but not others. See #9630 and #9062. Given that some applications have no problem we've never been able to narrow down if it's a problem with how we make the EPUB's, or the EPUB readers (possibly the file being too big for the readers to handle).

The EPUB format is a W3 standard and I found that they provide an EPUB check tool here: https://www.w3.org/publishing/epubcheck/

I ran it on the latest stable EPUB version, it checked against EPUB 3.3 rules, and it returned "887 Fatals, 12412 errors, 41 warnings, 0 infos"

Not sure when but I'll have to look into the specifics of how we're building the EPUB's more to try and fix these errors. If we can fix these and readers like apple books still have issues we can safely say it's an issue on the readers end.

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.