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

Question

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

我已经尝试了 asciidoc writer's guide 推荐的方法(例如)

video::rAteGra5-xM[youtube]

原子编辑器中的预览有效，导出到 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::[]

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

这是 GitHub 上的结果:

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