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

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 在 [=28] 上呈现时，我使用 image 宏将带有 link 的 YouTube 视频的缩略图显示到 YouTube 上的视频=].否则我正在使用 video 宏。

这是 GitHub 的结果：

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

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

AsciiDoc: How to embed youtube videos in github-flavored asciidoc?

youtube

github

asciidoc