AsciiDoc：如何将 youtube 视频嵌入 github 风格的 asciidoc 中？

Question

我正在使用 asciidoc 标记语言编写文档并将其推送到 github 存储库。Github 自动渲染 asciidoc 文件 (*.adoc)，但出于（我）未知的原因不想接受我嵌入的 YouTube 视频。

我已经尝试了 asciidoc 作者指南中推荐的方法（例如）

video::rAteGra5-xM[youtube]

Atom 编辑器中的预览有效，导出为 HTML 版本有效。你能帮我吗？让它在 github 渲染的 asciidoc 页面中工作的首选方法是什么？

谢谢

Answer 1

GitHub 会删除<iframe>（我猜是出于安全原因），因此您将无法在自述文件中嵌入 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::[]

在上面的示例中，当 README 在 GitHub 上呈现时，我使用image宏来显示 YouTube 视频的缩略图，以及 YouTube 上视频的链接。否则我正在使用video宏。

这是 GitHub 上的结果：

如果我单击图像，它将打开https://youtu.be/rAteGra5-xM