summaryrefslogtreecommitdiff
path: root/MANUAL.txt
diff options
context:
space:
mode:
authorJohn MacFarlane <jgm@berkeley.edu>2017-06-27 15:25:37 +0200
committerJohn MacFarlane <jgm@berkeley.edu>2017-06-27 15:25:37 +0200
commit7d9d77ca44afa0c69abfefe07d7b027f81c8f1a0 (patch)
tree05c7d829467e7d3831fb2876e204f494f3f9f9a2 /MANUAL.txt
parent33a29fbf8720c0d7eec40b7014e3f819b05474ef (diff)
Require nonempty alt text for `implicit_figures`.
A figure with an empty caption doesn't make sense. Closes #2844.
Diffstat (limited to 'MANUAL.txt')
-rw-r--r--MANUAL.txt15
1 files changed, 7 insertions, 8 deletions
diff --git a/MANUAL.txt b/MANUAL.txt
index b5cea779e..a5121dc2f 100644
--- a/MANUAL.txt
+++ b/MANUAL.txt
@@ -3227,17 +3227,16 @@ The link text will be used as the image's alt text:
#### Extension: `implicit_figures` ####
-An image occurring by itself in a paragraph will be rendered as
-a figure with a caption.[^5] (In LaTeX, a figure environment will be
-used; in HTML, the image will be placed in a `div` with class
-`figure`, together with a caption in a `p` with class `caption`.)
-The image's alt text will be used as the caption.
+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.
![This is the caption](/url/of/image.png)
-[^5]: This feature is not yet implemented for RTF, OpenDocument, or
- ODT. In those formats, you'll just get an image in a paragraph by
- itself, with no caption.
+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.
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