mirror of
https://github.com/larvit/adf-codec.git
synced 2026-11-20 23:25:43 +01:00
Answer prose round 1: 0 🔴, 4 🟡; say what the readers do with a title, and point the link case at its entry
This commit is contained in:
+5
-4
@@ -259,7 +259,7 @@ Their CommonMark suite exceptions are `node-model` (§The CommonMark suite check
|
|||||||
A reader panel on 2026-10-18 read the title again: seven readers across the bot, the LLM pipeline,
|
A reader panel on 2026-10-18 read the title again: seven readers across the bot, the LLM pipeline,
|
||||||
a support agent and a product manager. Two picked a caption, two the picture alone, and three neither,
|
a support agent and a product manager. Two picked a caption, two the picture alone, and three neither,
|
||||||
each describing hover text, which ADF holds no node for. No output reached five of seven, so the
|
each describing hover text, which ADF holds no node for. No output reached five of seven, so the
|
||||||
caption reading stands until `todo.md` item 121 is answered.
|
title still reads as the image's caption until `todo.md` item 121 is answered.
|
||||||
|
|
||||||
## A mark skips a node that cannot hold it, and a directive mark wrapping only such nodes is refused, as is a `[text](url)` link unless its text is hard breaks alone
|
## A mark skips a node that cannot hold it, and a directive mark wrapping only such nodes is refused, as is a `[text](url)` link unless its text is hard breaks alone
|
||||||
|
|
||||||
@@ -285,9 +285,10 @@ Goal 6. Valid while the audience reads a title as hover text.
|
|||||||
|
|
||||||
`adfToLosslessMarkdown` writes a `media` whose only mark is a link as `[](href)`, which
|
`adfToLosslessMarkdown` writes a `media` whose only mark is a link as `[](href)`, which
|
||||||
each reader expected before seeing the options. A captioned image keeps the `!adf:caption`
|
each reader expected before seeing the options. A captioned image keeps the `!adf:caption`
|
||||||
directive: each reader read `` as hover text, not a caption. The caption reading
|
directive: each reader read `` as hover text, not a caption. The library's readers
|
||||||
stands; a reader panel on 2026-10-18 did not settle it (§An image reads as an image only alone in its
|
still build a title as the image's caption; a reader panel on 2026-10-18 did not settle whether they
|
||||||
paragraph), and `todo.md` item 121 asks the maintainer for the answer.
|
should (§An image reads as an image only alone in its paragraph), and `todo.md` item 121 asks the
|
||||||
|
maintainer for the answer.
|
||||||
|
|
||||||
## A linked image standing inline in portable markdown, its link to another target, is written `[alt](href) ([image](url))`
|
## A linked image standing inline in portable markdown, its link to another target, is written `[alt](href) ([image](url))`
|
||||||
|
|
||||||
|
|||||||
@@ -68,14 +68,15 @@ of seven.
|
|||||||
|
|
||||||
ADF holds no node for hover text, so the caption is the only ADF place for the title's words. Goal 7
|
ADF holds no node for hover text, so the caption is the only ADF place for the title's words. Goal 7
|
||||||
says lossy conversion drops form, never content. The README's portable section defines content as
|
says lossy conversion drops form, never content. The README's portable section defines content as
|
||||||
what a reader sees or follows, which a hover title is not at rest. The goals do not say whether a
|
what a reader sees or follows. A hover title is seen only when the pointer rests on the picture.
|
||||||
title is content. Earlier entries of this class: §An image reads as an image only alone in its paragraph (the
|
The goals do not say whether a
|
||||||
|
title is content. Earlier entries on what an image's title reads as: §An image reads as an image only alone in its paragraph (the
|
||||||
caption, 2026-10-09, 3 of 3); §A linked image is written `[](href)`, a captioned image as
|
caption, 2026-10-09, 3 of 3); §A linked image is written `[](href)`, a captioned image as
|
||||||
its directive (2026-10-11, 3 of 3, reading a title as hover text); and the title that drops inside
|
its directive (2026-10-11, 3 of 3, reading a title as hover text); and, inside another link, a title drops,
|
||||||
another link, chosen by Goal 6 over Goal 7.
|
chosen by Goal 6 over Goal 7 (§An image reads as an image only alone in its paragraph).
|
||||||
|
|
||||||
Candidate entry: an image's title stays the caption of an image that stays an image, because ADF
|
Candidate entry: an image's title becomes its caption when the image stands alone in its paragraph,
|
||||||
holds no hover text and the caption keeps the title's words. This image keeps "The moon, at night"
|
because ADF holds no hover text and the caption keeps the title's words. This image keeps "The moon, at night"
|
||||||
as visible text under the picture.
|
as visible text under the picture.
|
||||||
|
|
||||||
Blocks 73: the announcement waits for this answer, since the answer may change what the package
|
Blocks 73: the announcement waits for this answer, since the answer may change what the package
|
||||||
|
|||||||
Reference in New Issue
Block a user