r - 使用 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 日)之后，您可以使用 block 选项 fig.alt提供替代文本。

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

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

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

output:
  html_document:
    fig_caption: false