Support for Drupal 7 is ending on 5 January 2025—it’s time to migrate to Drupal 10! Learn about the many benefits of Drupal 10 and find migration tools in our resource center.Document that Image alt text must be in quotes
Because:
It seems that during conversion from source to html the image alt text gets truncated when the image alt text contains a comma.
Example: menu-link-from-context contains this image + alt text:
image:images/menu-link-from-content-.png[Granting users with the
Vendor role the rights to create, delete and edit Recipes]
This is the resulting HTML:
<p><span class="inlinemediaobject"><img src="images/menu-link-from-content-.png" alt="Granting users with the Vendor role the rights to create" /></span></p>
| Comment | File | Size | Author |
|---|---|---|---|
| #4 | formatting-alt-text-2528834-4.patch | 1.16 KB | batigolix |
Comments
Comment #1
batigolixehhh, well .... It works fine when the caption text is in quotes. So this needs to be documented (if it isnt already)
Comment #2
batigolixComment #3
batigolixComment #4
batigolixPatch for the formatting.txt guideline
Comment #5
eojthebraveNice catch. I agree that defaulting to just using quotations is the best way to go here. It'll help avoid confusion for others in the future. Thanks @batigolix. I've added your updates and committed the changes.
Comment #6
jhodgdonThanks! Yeah, the way macros work in AsciiDoc (and the "include an image" thing is a macro), commas are special because they indicate separation between parameters for the macro. So that's an explanation for why what you already figured out works that way. :)