Here's an example with a fair number of sidenotes:
- Dorian's expandable parentheticals (click on the gray phrases): https://doriantaylor.com/person/dorian-taylor#me
- Gwern's list of sidenote implementations: https://gwern.net/sidenote
- The ellipsis -> bottom modal pattern, found on buttondown articles like this one: https://buttondown.com/hillelwayne/archive/you-can-cheat-a-t...
These days, I try to remove tangents from my writing, publishing any good tangents as microblog content instead.
I'm also considering unhyperlinked footnotes, and letting the reader scroll to the bottom if they want, the low-tech way. It's less distracting that way, and there's no accessibility issues either.
I've been thinking about adding popups, koreader style, for mobile, but haven't yet. Partially because I haven't figured out some of the deeper UX concerns, but mostly because I'm lazy
Anyway, here's an article with a decent amount of footnotes (side notes?):
But the actual Javascript isn't all that complex. It basically just checks that the site satisfies a min-width media query, then calculates the top position of the superscript links, and sets a css custom property to store that value. The CSS then uses a mix of media queries, js-controlled data- properties, and absolute positioning to move the body of the footnotes out of the footer and into the sidebar. If JS doesn't load, then nothing happens, and they remain at the bottom of the site.
The JS involved is at https://github.com/paradox460/pdx.su/blob/main/assets/js/sid...
The CSS that affects them is https://github.com/paradox460/pdx.su/blob/main/assets/css/ge... (there's also a small query that makes the parent paragraph of a superscript flash when you return to it, using has queries)
I hate that every e-book format I've encountered seems to only do endnotes, too.
> [The superscript number] indicates to you that I, the writer, have something more to say on this topic.
Not really, though? Notes range from citations to parentheticals. “Having more to say” would be included in the main text I’d think. The point of notes is that you don’t “have more to say” on the main topic, but you have this other information that some readers might find useful.
I do agree that there is no need to get hung up on solutions used in print (footnotes and endnotes) for online material.
The simpler solutions presented do not have these issues.
> If the footnote markers are links, then the user can use the back button/gesture to return to the main content. But, even though this restores the previous scroll position, the user is still left with the challenge of finding their previous place in a wall of text^6.
and didn't read footnote 6, which mentions the technique I'm describing. But I still don't seem to see the UX issues, other than the mention of a teeny-weeny hit target, which I admit is perfectly legitimate. But I am an academic, so it is probably no surprise that imitating academia appeals to me.
(i guess what is worse are pages which re-invent the wheel and re-implement text-searching, like [gitlab i think], where the browser search is broken as its only displaying a sub-section of text at any given moment and browser search fails unless you scroll a page down and find again)
personally, i blame javascript
Regarding the popover:
> We could try to solve that problem by dynamically pulling the content from the footnotes and displaying it in a popover. In some browsers (including yours) that will display like a tooltip, pointing directly back to the footnote marker. Thanks to modern web features, this can be done entirely without JavaScript.
> But this is still shit! I see good, smart people, who'd always avoid using "click here" as link text, littering their articles with link texts such as 1, 7, and sometimes even 12. Not only is this as contextless as "click here", it also provides the extra frustration of a tiny-weeny hit target.
The claim that footnotes are "contextless" is not sound. One cannot attribute the "contextlessness" of "click here" hyperlinks to footnotes because footnotes and hyperlinks fundamentally differ: footnotes are simply placeholders for additional text and do not call the user to action.
Perhaps the author meant that a footnotes's form, i.e. a number or symbol, doesn't provide context for the note itself. While this claim is sound, it is irrelevant because a footnote link shouldn't need context; the sentence provides it.
While the claim about a "tiny-weeny hit target" is sound, the author fails to consider alternatives. Increasing font size or wrapping the link in brackets would help the problem.
Regarding popovers vs. the three proposed alternatives: i) parentheses; ii) `note`; and iii) `<details>`:
1) All three options are more distracting because they occupy more space. And (ii) and (iii) add color. And I'd guess that readers are more likely to unintentionally skim (ii) or open (iii) because they're primed by other websites. All these modes of distraction run contrary to the purpose of the footnote. In fact, a footnote occupies the minimum space possible.
2) Option (ii) adds lots of unseemly vertical space to the webpage.
3) Option (iii) moves the webpage text below the note up and down. This interferes more with the reading experience than does the static popover.
4) Options (ii) and (iii) are not portable over copy paste. If you copy a webpage with these elements into another file, you'll have to manually rearrange them to appear as actual footnotes.
5) All options, as implemented by the author, eliminate the key-value nature of footnotes. One cannot refer to a particular parenthetical, `note`, or `<details>` because they aren't numbered. While (ii) and (iii) could be numbered with no problem, numbered parentheticals start to look weird.
6) All three options give footnotes more visual presence than they should have. Particularly (ii) will make the footnote seem like the most important quote of the article. Footnotes should be out of eyesight most of the time, just like feet.
Yes. I was referring to the uselessness of the linking text being a superscript number, which is as bad, if not worse, than "click here".
> While this claim is sound, it is irrelevant because a footnote link shouldn't need context; the sentence provides it.
It doesn't. The sentence gives you information about the general topic, but not about the content of the footnote, and if it's worth visiting. Whereas the note & details examples have a heading that describes the topic of the supplementary content.
> 1) All three options are more distracting because they occupy more space. And (ii) and (iii) add color. And I'd guess that readers are more likely to unintentionally skim
Are they too distracting or too easy to ignore? Make your mind up!
> In fact, a footnote occupies the minimum space possible.
Using smaller text is a bug, not a feature.
> 2) Option (ii) adds lots of unseemly vertical space to the webpage.
Vertical space is cheap. And in the example it's hardly lots.
> 3) Option (iii) moves the webpage text below the note up and down. This interferes more with the reading experience than does the static popover.
It only moves it down, and then you can read the content in flow.
> 4) Options (ii) and (iii) are not portable over copy paste. If you copy a webpage with these elements into another file, you'll have to manually rearrange them to appear as actual footnotes.
That's a feature, not a bug. Content is in the correct order.
> 5) All options, as implemented by the author, eliminate the key-value nature of footnotes. One cannot refer to a particular parenthetical, `note`, or `<details>` because they aren't numbered.
So? They have headings instead.