3
0
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:
2026-10-09 03:58:35 +02:00
committed by Lillem4n
parent 446efded6c
commit ee3086ad1e
12 changed files with 58 additions and 58 deletions
+12 -11
View File
@@ -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