RE: [Moderator Action] Footnote discussions

+1 We're making progress.

Re: ?  And would it make sense to at least allow for the automatic generation of sequential note identifiers (e.g., 1, 2, 3) like with list items?

Yes, this is really important (though of course it is also critical for publishers to be able to control those identifiers as literal text—I have clients who publish standards for which the numbers on lists and notes etc. _can never change_ so they have to circumvent any system that tries to renumber things). But in general (meaning 99+% of the cases) it is hugely helpful to have the notes renumber. This would have to accommodate the issue that there are multiple notes streams in many publications (especially academic publications) so you'd need to be able to control _which_ stream the numbers/designators pertain to.

From: ahby@aptest.com [mailto:ahby@aptest.com] On Behalf Of Shane McCarron
Sent: Tuesday, February 03, 2015 11:06 AM
To: Charles LaPierre
Cc: David MacDonald; Bill Kasdorf; Dave Cramer; Liam R E Quin; George Kerscher; public-digipub-ig@w3.org; Matt Garrish
Subject: Re: [Moderator Action] Footnote discussions

I could get behind that.  And <note> would be similar to <div> in terms of content model?

How would we reference the note?  And would it make sense to at least allow for the automatic generation of sequential note identifiers (e.g., 1, 2, 3) like with list items?  Also, would it make sense to have a way of referencing the note(s) that would automatically incorporate their identifier in the reference (e.g., <noteref ref="myNote" /> would cause [1] or something to be included in the output)?

I don't relish the idea of trying to maintain the list of note numbers by hand in any complex publication.

Or is this beyond the scope of "HTML"?

On Tue, Feb 3, 2015 at 9:59 AM, Charles LaPierre <charlesl@benetech.org<mailto:charlesl@benetech.org>> wrote:
+1 to having <note> and then defining which type of note it is as an aria-role.

_______________________________

Charles LaPierre
charlesl@benetech.org<mailto:charlesl@benetech.org>



On Feb 2, 2015, at 9:35 PM, David MacDonald <david100@sympatico.ca<mailto:david100@sympatico.ca>> wrote:

Agree that the language should be <note> rather than footnote, which is the proposal to HTML5.
My thinking is that it would be an automatic 2 way link, and  therefore would not have to be embedded in the paragraph. http://davidmacd.com/blog/html51-footnotes.html


  *   Hyperlink to the note from the ref point in document, and a default option to return to the point of reference
  *   If there is more than one point of reference, the returning link would return to the point from where it was accessed.
  *   Hyperlinks back to reference can be turned off with an attribute setting if there are multiple links to it in the doc.
  *   Speculative feature: an attribute that allows the footnote to open in-line like the summary and details element right on the page where the reference to it is found.
  *   WAI-ARIA could provide new region roles for role="footnotes" and role="endnotes".




Cheers,
David MacDonald


CanAdapt Solutions Inc.
Tel:  613.235.4902<tel:613.235.4902>
LinkedIn<http://www.linkedin.com/in/davidmacdonald100>
www.Can-Adapt.com<http://www.can-adapt.com/>


  Adapting the web to all users
            Including those with disabilities

If you are not the intended recipient, please review our privacy policy<http://www.davidmacd.com/disclaimer.html>

On Mon, Feb 2, 2015 at 2:42 PM, Bill Kasdorf <bkasdorf@apexcovantage.com<mailto:bkasdorf@apexcovantage.com>> wrote:
Replying to a post from Dave earlier today.

Re: " This leads to content model problems, as often footnotes may have sectioning or block elements inside them (like blockquote, div, etc.) which are not valid inside paragraphs."

Bingo. I cannot think of a model we've developed for a client that does not have this requirement. Most have to accommodate complex content within footnotes, like <blockquote>s, lists, equations, or just simply multiple paragraphs.

Our typical strategy is to use this markup for the footnote itself:

<aside class="footnote" id="[id]"><span class="footnote-no"><a href="#[id of footnote reference marker]">[marker]</a></span> [content of footnote]</aside>

. . . which is typically placed after the end of the block element that contains the callout (because we can't put it in a <p>),

. . . and embed an expression like this in the text where the "callout" occurs (somewhat bulky, but it works):

<span class="footnote-marker" id="[id]"><a class="fn-ref" epub:type="noteref" href="#[id of footnote]">[marker]</a></span>

That provides the bi-directional linking and the ability to accommodate complex content in the footnote itself. Multiple references to the same note are possible but create difficulties in determining which of them to return to. But this is sufficient for the overwhelming majority of cases in our work where there is a one-to-one relationship between the callout ("marker," "reference") and the note itself. This is probably not robust enough, though, for a true W3C HTML5 solution, where the multiple-callout case would need to be accommodated.

The keys are the need for a "marker" (asterisk, superior number, whatever) and a "note": too often both of those things are referred to as "the footnote," which is Not A Good Idea.

A more streamlined and inherently semantic markup for all that would be welcome!

--Bill Kasdorf


From: Dave Cramer [mailto:dauwhe@gmail.com<mailto:dauwhe@gmail.com>]
Sent: Monday, February 02, 2015 10:32 AM
To: Liam R E Quin
Cc: Bill Kasdorf; George Kerscher; public-digipub-ig@w3.org<mailto:public-digipub-ig@w3.org>
Subject: Re: Footnote discussions

How the markup should look is an interesting question. Lots of "classic" XML/SGML vocabularies have a footnote element that essentially serves as both marker and reference:

<para>Call me Ishmael.<footnote><para>This is a footnote</para></footnote></para>

When rendered, the footnote element is moved somewhere, and a reference left in its place.

The PDF formatters Prince and AntennaHouse can do something similar today with HTML footnotes:

<p>Call me Ishmael.<span class="footnote">This is a footnote</span></p>

They use CSS to move the footnote and generate the references using CSS counters and some non-standard pseudo-elements:

span.footnote { float: footnote }
span.footnote::footnote-call { content: counter(footnote); vertical-align: super; }
span.footnote::footnote-marker { content: counter(footnote) '. '; }

This leads to content model problems, as often footnotes may have sectioning or block elements inside them (like blockquote, div, etc.) which are not valid inside paragraphs.

We've also run into problems with implementing footnotes using CSS regions. It's easy enough to move the footnote element somewhere else, but CSS has not defined ways of leaving markers behind to serve as the callout.

Separating the note and the reference has its own issues, as you have to essentially create all the links yourself, and it seems a bit arbitrary where to put the note content itself.

I'd lean towards having a note element that could be embedded at the point of reference, with a rather expansive content model. A noteref element would be optional, for the case where there are multiple references to the same note. But CSS would need to address the issue of leaving a reference when the note element was moved to somewhere else in the document. Such a pseudo-element (one possible proposal) would be more generally useful, with sidebars, images, and other such content.

Dave








--
Shane McCarron
Managing Director, Applied Testing and Technology, Inc.