AsciiDoc：如何在GitHub风格的AsciiDoc中嵌入YouTube视频？

Question

我正在使用asciidoc标记语言编写文档，并将其推送到github存储库。Github会自动呈现asciidoc文件（*.adoc），但由于未知的原因，它无法接受我嵌入YouTube视频的操作。

我已尝试了asciidoc编写者指南中推荐的方式，例如： video::rAteGra5-xM[youtube] 在Atom编辑器中预览正常，在导出为HTML版本时也正常工作。请问您能否提供帮助？在Github呈现的asciidoc页面中，最佳方法是什么？

谢谢

- Matthias Kubisch

Answer 1

GitHub出于安全考虑删除了<iframe>标签，因此您无法在README中嵌入YouTube视频。

作为解决方法，您可以执行以下操作:

ifdef::env-github[]
image:https://img.youtube.com/vi/rAteGra5-xM/maxresdefault.jpg[link=https://youtu.be/rAteGra5-xM]
endif::[]

ifndef::env-github[]
video::rAteGra5-xM[youtube]
endif::[]

在上面的示例中，我使用image宏来显示YouTube视频的缩略图，并在GitHub上呈现README时提供指向YouTube视频的链接。否则，我将使用video宏。

在GitHub上的结果如下：

如果我点击图片，它会打开https://youtu.be/rAteGra5-xM

- Mogztter