On 9/22/23 09:40, David W. Farmer wrote:
> Am I correct that we are using "details" for everything that
> currently is a knowl? Including when I have a knowl for
> [Theorem 3.14] in the middle of the sentence? And so the case
> of footnotes is not necessarily special?
Very short answer: no.
Content may electively be "born hidden", such as a Theorem. Or it is always
born hidden, like a footnote or a hint to an exercise. These had their content
"on the page" but was not visible until you click. This is "orginal" content.
Where born. Mostly blocks (but definitely footnotes are not blocks). Footnotes
will become whatever, born-hidden knowls are trialing as "details".
You can cross-reference many things from amny places, like a theorem. An indewx
entry is a specialized cross-reference (think about that one). The revealed
content lives in a file, partly since it may be referenced repeatedly, but also
so that it does not recursively pile-up more cross-reference content. This file
is *duplicate* content, not original, so must be sanitized (mostly no repeat
HTML id).
Short answer: born hidden knowls create their own problems when they have
interior born-hidden knowls (think exercise with hints). Moving to "details"
really helps reduce complexity. Cross-reference knowls are not changing.
> I have become accustomed to the "open after the current paragraph"
> behavior, and that is what (I assume) knowls will continue to do.
Really not changing, except for footnotes (see Anderw's demos).
> That requires JavaScript, right? Maybe not when an Example is
> hidden, because it just opens where it is. But in the middle of
> a paragraph, something has to tell the contents where to go.
>
> Whatever the markup, I think the reader will expect the same behavior
> in both cases. And I think people are pretty happy with the
> "after the current enclosing block" behavior.
I think these concerns are moot. Two regressions right now that I can see:
1. MathJax will render math in born-hidden knowls before it is revealed.
Andrew suggests lazy loading.
2. "hint", "answer", and other "appendages" are currently laid-out inline, and
opening one does not disturb that. See current beta where layout is
line-by-line, which perhaps we can "fix" with CSS. But I think doing a reveal
will split that linear arrangment.