From 1dcb984453a61cb37d091df7a0fba404207327d3 Mon Sep 17 00:00:00 2001 From: John MacFarlane Date: Sun, 30 Nov 2025 13:31:17 +0100 Subject: Clean up `implicit_figure` documentation. Explain how to specify alt text. See #11082. --- MANUAL.txt | 24 ++++++++++++++++-------- 1 file changed, 16 insertions(+), 8 deletions(-) diff --git a/MANUAL.txt b/MANUAL.txt index fe7e19bbf..3dc4f0551 100644 --- a/MANUAL.txt +++ b/MANUAL.txt @@ -5712,29 +5712,37 @@ The link text will be used as the image's alt text: An image with nonempty alt text, occurring by itself in a paragraph, will be rendered as a figure with a caption. The -image's alt text will be used as the caption. +image's description will be used as the caption. - ![This is the caption](/url/of/image.png) + ![This is the caption.](image.png) How this is rendered depends on the output format. Some output formats (e.g. RTF) do not yet support figures. In those formats, you'll just get an image in a paragraph by itself, with -no caption. For LaTeX output, you can specify a [figure's -positioning](https://www.overleaf.com/learn/latex/Positioning_images_and_tables#The_figure_environment) -by adding the `latex-placement` attribute. - - ![This is the caption](/url/of/image.png){latex-placement="ht"} +no caption. If you just want a regular inline image, just make sure it is not the only thing in the paragraph. One way to do this is to insert a nonbreaking space after the image: - ![This image won't be a figure](/url/of/image.png)\ + ![This image won't be a figure](image.png)\ Note that in reveal.js slide shows, an image in a paragraph by itself that has the `r-stretch` class will fill the screen, and the caption and figure tags will be omitted. +To specify an alt text for the image that is different +from the caption, you can use an explicit attribute (assuming the +`link_attributes` extension is set): + + ![The caption.](image.png){alt="description of image"} + +For LaTeX output, you can specify a [figure's +positioning](https://www.overleaf.com/learn/latex/Positioning_images_and_tables#The_figure_environment) +by adding the `latex-placement` attribute. + + ![The caption.](image.png){latex-placement="ht"} + ### Extension: `link_attributes` ### Attributes can be set on links and images: -- cgit v1.2.3