#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: 0 | UI/UX: 0
-------------------------------+------------------------------------
Comment (by Dunedan):
I looked a bit into this issue and it seems to be mostly related to the
template in use. So by further customizing the template we should be able
to fix these warnings.
The `djangodocs-epub` theme inherits from `epub` which inherits from
`basic`. Interestingly most of these issues are already present in
upstreams `epub` theme, as it inherits from `basic` which is just an HTML-
theme and doesn't know about epub at all.
Simply extending templates from `basic` and overwriting blocks doesn't
work for all warnings, as some of them are outside of blocks and even if
they are in blocks it means mostly replicating the existing logic of these
blocks, so the cleanest solution seems to be to build an `epub` theme,
which doesn't inherit from any other theme. That would also allow us to
make better use of epub-specific features, but of course is no quick and
easy undertaking.
--
Ticket URL: <https://code.djangoproject.com/ticket/20935#comment:5>
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 post to this group, send email to [email protected].
To view this discussion on the web visit
https://groups.google.com/d/msgid/django-updates/067.9cd6e6ac15a0b0a8af0ab522198859d7%40djangoproject.com.
For more options, visit https://groups.google.com/d/optout.
