search

rfc-format / draft-iab-xml2rfc-v3-bis

-bis document for the RFC format xml2rfc v3 draft
6 stars 10 forks source link

artwork and artset for text fallback #160

Closed miekg closed 3 years ago

miekg commented 4 years ago

I'm finally coming around of implementing svg images in mmark and just having an svg and creating an HTML doc works beautiful. But how is the text fallback supposed to work? Is that mandatory to create an RFC or will the HTML be canonical?

miekg commented 4 years ago

ok, according https://www.rfc-editor.org/rse/format-faq/ it is advised(?) to include both

rjsparks commented 3 years ago

Right - xml2rfc will process alternatives in an artset as per https://xml2rfc.tools.ietf.org/xml2rfc-doc.html#section-2.5. If there's nothing available for a format (like txt) where SVG can't be rendered, and SVG is the only alternative, a string like " (Artwork only available as SVG: see .html)" will be rendered.

The RFC Editor (or the appropriate stream manager) may push hard for there to be a reasonable alternative for txt formats, but it is not a requirement that the software should enforce.