#COULD NOT START THE EPUB CHECKER UPDATE#
#COULD NOT START THE EPUB CHECKER DOWNLOAD#

I wonder if section content pages are possible. (The TOC is not super helpful as presented in Apple Books at least. If someone is prepared to have a look, I think it's would be nice to have.

If we could clear them up, I'd guess it would improve presentation. The errors are leading to a lack of cross links (at least). Yes, I kind of see that: the EPUB does work.

#COULD NOT START THE EPUB CHECKER DOWNLOAD#

(It has a good README in the download but, $ java -jar epubcheck.jar django.epub was the essence of it.) It may take some detective work to pin down exactly the issue for the fragment identifiers (Is it something we can fix or is it a bug in Sphinx?) but I think it would be a good first issue if someone is willing to pick it up.įor me, downloading EPUBCheck to run locally was very helpful: If we can solve that, then the vast majority of the output is eliminated.įrom there, I suspect the remaining errors won't look so intimidating. (A fix there may just be finding an error in sphinx and reporting it.) It looks like a different rule is just being applied to generate the url anchor fragments. There std-setting-TEST_SERIALIZE is not std:setting-TEST_SERIALIZE.

Same with testing/topics/advanced.html:639 pointing to ref/settings.xhtml:553. Std:templatefilter-addslashes is not std-templatefilter-addslashes. errors, I think those should be (cough) straight-forward enough to fix.īut the destination is ref/templates/builtins.xhtml:1220, which has: Re the two-thousand-odd Fragment identifier is not defined. (In Apple Books, the background gradient on the unit test classes diagram is not rendered entirely perfectly, but it is so in Firefox and Safari, so I suspect that is Apple Books.) In the meantime, the images look to view without problem.

#COULD NOT START THE EPUB CHECKER UPDATE#

I've filed a bug report with them, which I'd guess they'd address, so we can update the files as-and-when. Latest versions still generate the invalid SVG.

The SVG diagrams were generated using OmniGraffle. The good news is that these fall into only a dozen or so categories:ġ) 1 times ERROR: value of attribute 'href' is invalid must be a URIĢ) 1 times ERROR: attribute 'id' not allowed here expected attribute 'charset', 'defer', 'src' or 'xml:space'ģ) 2 times ERROR: element 'form' not allowed anywhere expected the element end-tag, text or element 'a', 'abbr', 'acronym', 'address', 'applet', 'b', 'bdo', 'big', 'blockquote', 'br', 'cite', 'code', 'del', 'dfn', 'div', 'dl', 'em', 'h1', 'h2', 'h3', 'h4', 'h5', 'h6', 'hr', 'i', 'iframe', 'img', 'ins', 'kbd', 'map', 'noscript', 'ns:svg', 'object', 'ol', 'p', 'pre', 'q', 'samp', 'script', 'small', 'span', 'strong', 'sub', 'sup', 'table', 'tt', 'ul' or 'var' (with xmlns:ns='')Ĥ) 2 times ERROR: attribute 'start' not allowed here expected attribute 'dir', 'id', 'lang', 'style', 'title' or 'xml:lang'ĥ) 3 times ERROR: hyperlink to non-standard resource of type Ħ) 3 times ERROR: element 'dc:date' not allowed anywhere expected the element end-tag or textħ) 7 times ERROR: : referenced resource missing in the package.Ĩ) 678 times ERROR: value of attribute 'id' is invalid must be an XML name without colonsĩ) 2400 times ERROR: : fragment identifier is not defined in ġ0) 5 times HINT: Link attribute with no valueġ1) 1 times WARNING: use of non-registered URI scheme type in href: irc:///django-devġ2) 4 times WARNING: hyperlink to resource outside spine ġ3) 8 times WARNING: use of non-registered URI scheme type in href: irc:///django There are 3000+ validation warnings/errors generated by epubcheck.

Could not start the epub checker