- Sep 2018
The toc nav element
This makes it sound like there is an HTML element with a tag name of
<toc nav>rather than
<nav epub:type="toc">(which seems to be what's intended).
landmarksexample farther down is clearer--though the wording there of "the landmark nav element" is equally confusing.
There remains only a
navelement, but of varying types.
In the context of this specification, the default display style of list items within nav elements MUST be equivalent to the list-style: none property [CSSSnapshot].
This line is confusing because the actor (author or reading system) is unclear. The following two lines are much clearer on what actor is being restricted by this specification.
This line feels specific to the Reading System requirements. Consequently, perhaps it's best to integrate it into the sentence just following.
it MUST resolve
resolveto any defined algorithms for resolving resources within an EPUB.
If an a or span element contains instances of HTML embedded content that do not provide intrinsic text alternatives, the element MUST also include a title attribute with an alternate text rendering of the link label.
This requirement is clearer than the one just previous and also seems to obviate the earlier one.
However, this one is confusing limiting the textual expression to just the
titleattribute, and also being vague of which element is associated to the MUST--is it this surrounding
span? or the contained "embedded content" element?
after concatenation of all child content and application of white space normalization rules.
Implied requirement? When is this necessary and what does the concatenation and normalization?
visual display of components
Where is this "visual display" taking place? Is this when the document is viewed as a spine element? or is this when the content is extracted and presented by the Reading System?
while a span element
Rephrase "while a child
spanelement" and perhaps move to it's own sentence parallel to the "A child
current reading position
Link to this, if defined.
when rendered in a non-browser context.
Is "non-browser context" defined? or its inverse?
It's not clear if "browser" here is equivalent to "Reading System" or to a Web browser or something else.
If such formatting and functionality is used
Used by? It's not clear who the actor is here, the author/developer of the EPUB or the Reading System.
a custom control, such as the table of contents
Is the "table of contents" a specific type of custom control? If so, a link would help here.
which has no effect outside of spine rendering
But it does have effect on "spine rendering"? Perhaps add a link for spine rendering.
represents a data island
Is "data island" a specific, defined thing from a previous EPUB spec or another adjacent spec?
Link to a definition of "custom control" if one exists.
Unlike typical XML data islands
Not sure what a "typical XML data island" is either...so some links or even rewording (or removing?) might help others unfamiliar with the phrase.