使用 knitr::include_graphics 将图像插入 RMarkdown 时的替代文本？

Question

将图像插入具有 output: html_document 的 RMarkdown 文档时，我们可以使用

```{r pressure, echo=FALSE, fig.cap="A caption", out.width = '100%'}
knitr::include_graphics("path/to/image.png")
```

图片怎么给alt text？

Answer 1

在 knitr v1.31（2021 年 1 月 27 日）之后，您可以使用块选项 fig.alt 来提供替代文本。

在knitr v1.31之前，您可以使用块选项fig.cap生成替代文本。如果您查看 .html 输出文件的 HTML 源，您将看到带有 alt 属性的 <img> 标签。

<img src="...base64..." alt="A caption" ... />

然而，使用 fig.cap 的一个 side-effect 是它也会生成图形标题。要禁用图形标题，您可以在输出格式中将其关闭，例如，

output:
  html_document:
    fig_caption: false

Alt text when inserting image into RMarkdown with knitr::include_graphics?