mirror of
https://github.com/larvit/adf-codec.git
synced 2026-11-19 14:45:44 +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:
+8
-8
@@ -314,18 +314,18 @@ the destination, `alt` the description's plain-text content when non-empty — a
|
||||
it contributing its own text, a node spelling its text in the content slot contributing that text,
|
||||
and a break of either kind a space. A non-empty title, ``, adds a `caption`
|
||||
holding the title as one text node, and a link whose entire text is the image,
|
||||
`[](href)`, marks the `media`. `adfToLosslessMarkdown` emits the image form for exactly
|
||||
the shape with neither — those attrs and no others, no marks on either node, no caption, and a
|
||||
`[](href)`, marks the `media`. `adfToLosslessMarkdown` emits the image form only for the
|
||||
bare shape — those attrs and no others, no marks on either node, no caption, and a
|
||||
`media` carrying nothing beyond `alt`, `type` and `url` — and only where CommonMark spells the pair:
|
||||
a destination or a description the image form cannot hold, an empty `alt` included, takes the
|
||||
directive form instead.
|
||||
|
||||
Anywhere else — beside other content, in a heading, a table cell or an `!adf:paragraph` — an image
|
||||
reads as its alt text linked to its destination, the link titled by the image's title, since
|
||||
`mediaInline` carries a media `collection` + `id`, never a URL. An empty alt text reads as the
|
||||
destination, as an empty link text does. Inside a link's text, the alt text is plain text the link
|
||||
marks, and the image's destination and title drop (`docs/decisions.md` §Every CommonMark image and
|
||||
empty link reads).
|
||||
`mediaInline` carries a media `collection` + `id`, never a URL, so anywhere else an image reads as
|
||||
its alt text linked to its destination, the link titled by the image's title: beside other
|
||||
content, in a heading, a table cell or an `!adf:paragraph`, and in the paragraph a portable alert,
|
||||
callout or task marker opens. An empty alt text reads as the destination, as an empty link text
|
||||
does. Inside a link's text, the alt text is plain text the link marks, and the image's destination
|
||||
and title drop (`docs/decisions.md` §An image reads as an image only alone in its paragraph).
|
||||
|
||||
### Tables
|
||||
|
||||
|
||||
Reference in New Issue
Block a user