#20935: ePub documentation not valid
-------------------------------+------------------------------------
Reporter: mabdullah | Owner: nobody
Type: Bug | Status: new
Component: Documentation | Version: master
Severity: Normal | Resolution:
Keywords: | Triage Stage: Accepted
Has patch: 0 | Needs documentation: 0
Needs tests: 0 | Patch needs improvement: 0
Easy pickings: 1 | UI/UX: 0
-------------------------------+------------------------------------
Comment (by Carlton Gibson):
OK, so progress. After https://github.com/sphinx-doc/sphinx/pull/6734
(testing on Sphinx's 2.0 branch until it's released) we're down from
nearly 3000 errors to ≈825.
{{{
Check finished with errors
Messages: 0 fatals / 814 errors / 5 warnings / 5 infos
}}}
There were a few Sphinx errors on `make epub`:
{{{
WARNING: duplicated ToC entry found: howto/error-reporting.xhtml
WARNING: duplicated ToC entry found: howto/error-reporting.xhtml#email-
reports
WARNING: duplicated ToC entry found: howto/error-reporting.xhtml#server-
errors
WARNING: duplicated ToC entry found: howto/error-reporting.xhtml#errors
WARNING: duplicated ToC entry found: howto/error-reporting.xhtml
#filtering-error-reports
WARNING: duplicated ToC entry found: howto/error-reporting.xhtml
#filtering-sensitive-information
WARNING: duplicated ToC entry found: howto/error-reporting.xhtml#custom-
error-reports
WARNING: duplicated ToC entry found: howto/static-files/deployment.xhtml
WARNING: duplicated ToC entry found: howto/static-files/deployment.xhtml
#serving-static-files-in-production
WARNING: duplicated ToC entry found: howto/static-files/deployment.xhtml
#serving-the-site-and-your-static-files-from-the-same-server
WARNING: duplicated ToC entry found: howto/static-files/deployment.xhtml
#serving-static-files-from-a-dedicated-server
WARNING: duplicated ToC entry found: howto/static-files/deployment.xhtml
#serving-static-files-from-a-cloud-service-or-cdn
WARNING: duplicated ToC entry found: howto/static-files/deployment.xhtml
#learn-more
}}}
I'm sure if they were cleared up it would grab a bunch.
Then the remaining errors look to fall into a few buckets.
One in particular:
{{{
ERROR(RSC-005):
../django/docs/_build/epub/Django.epub/_modules/django/contrib/auth.xhtml(76,47):
Error while parsing file: element "div" not allowed here; expected the
element end-tag, text, element "a", "abbr", "area", "audio", "b", "bdi",
"bdo", "br", "button", "canvas", "cite", "code", "data", "datalist",
"del", "dfn", "em", "embed", "epub:switch", "i", "iframe", "img", "input",
"ins", "kbd", "label", "link", "map", "mark", "meta", "meter", "ns1:math",
"ns2:svg", "object", "output", "picture", "progress", "q", "ruby", "s",
"samp", "script", "select", "small", "span", "strong", "sub", "sup",
"template", "textarea", "time", "u", "var", "video" or "wbr" (with
xmlns:ns1="http://www.w3.org/1998/Math/MathML";
xmlns:ns2="http://www.w3.org/2000/svg";) or an element from another
namespace
}}}
If we could pin that down, it would be several hundred resolved.
(I still think this is a good ticket first ticket for someone wanting to
get involved.)
--
Ticket URL: <https://code.djangoproject.com/ticket/20935#comment:12>
Django <https://code.djangoproject.com/>
The Web framework for perfectionists with deadlines.
--
You received this message because you are subscribed to the Google Groups
"Django updates" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To view this discussion on the web visit
https://groups.google.com/d/msgid/django-updates/067.0a8a0caed7fa5c74c080ccdd91b1a1b2%40djangoproject.com.
