mirror of
https://github.com/larvit/adf-codec.git
synced 2026-11-13 12:18:28 +01:00
Answer prose round 1: one sentence per idea for the image readings, a decision title that states the rule, item 86 names its shapes
This commit is contained in:
+12
-11
@@ -202,19 +202,20 @@ link reference definition — and a directive link CommonMark could spell is ref
|
||||
link — the bracket form goes literal, the directive form refused — which is CommonMark's prose
|
||||
where its reference implementation nests one `<a>` in another.
|
||||
|
||||
## Every CommonMark image and empty link reads: the image where it stands alone, else a link, `[]()` as nothing
|
||||
## An image reads as an image only alone in its paragraph, else as its alt text linked; an empty link text reads as its destination
|
||||
|
||||
2026-10-04, the maintainer and a writer panel, 3 of 3; `[]()` 2026-10-09, settled by Goals 4 and 7
|
||||
as the maintainer's plan item directed. Goals 4, 5, 6 and 7. Valid while `mediaInline` carries no
|
||||
URL and ADF holds no empty text node.
|
||||
2026-10-04, the maintainer and a writer panel, 3 of 3; `[]()` 2026-10-09, by Goals 4 and 7, as the
|
||||
maintainer's plan item asked. Goals 4, 5, 6 and 7. Valid while `mediaInline` carries no URL and ADF
|
||||
holds no empty text node.
|
||||
|
||||
Every reader reads every CommonMark image and empty link. An image anywhere but alone in a plain
|
||||
paragraph reads as its alt text linked to its URL, titled by its title; an empty alt text reads as
|
||||
the URL, and an empty link text as its destination. `[]()` reads as nothing: it renders nothing, so
|
||||
Goal 7 loses no content. A titled image alone in a plain paragraph reads as the image captioned with
|
||||
its title. A link alone in a plain paragraph whose whole text is an image reads as the image with
|
||||
the link marking its `media`. Inside a link otherwise, the alt text is plain text the link marks and
|
||||
the image's URL and title drop: the panel chose this by Goal 6, which outranks Goal 7.
|
||||
Every reader reads every CommonMark image and empty link, as `spec/flavour.md` §The CommonMark
|
||||
image and §Marks spell out. An image alone in its paragraph reads as the image, its title as the caption.
|
||||
Anywhere else it reads as its alt text linked to its URL, titled by its title. An empty alt text
|
||||
reads as the URL, and an empty link text as its destination. `[]()` reads as nothing: it renders
|
||||
nothing, so Goal 7 loses no content. A link alone in its paragraph whose whole text is one image
|
||||
reads as that image, with the link marking its `media`. Inside any other link, the alt text is plain
|
||||
text the link marks, and the image's URL and title drop: the panel chose this by Goal 6, which
|
||||
outranks Goal 7.
|
||||
|
||||
## Ids stay site-local
|
||||
|
||||
|
||||
Reference in New Issue
Block a user