HUGO
Menu
GitHub 87548 stars Mastodon

Hugo YouTube 短代码

使用 youtube 短代码在你的内容中嵌入 YouTube 视频。

要覆盖 Hugo 内置的 youtube 短代码,请将 源代码 复制到 layouts/_shortcodes 目录中同名文件中。

示例

要显示具有此 URL 的 YouTube 视频:

https://www.youtube.com/watch?v=0RKpf3rK57I

在你的 Markdown 中包含此内容:

{{< youtube 0RKpf3rK57I >}}

Hugo 渲染为:

参数

id
(string) 视频 id。如果 id 是第一个且唯一的位置参数,则为可选。
allowFullScreen
(bool) iframe 元素是否可以激活全屏模式。默认值为 true
autoplay
(bool) 是否自动播放视频。强制将 mute 设置为 true。默认值为 false
class
(string) 包裹 div 元素的 class 属性。指定后,从 iframe 元素及其包裹的 div 元素中删除 style 属性。
controls
(bool) 是否显示视频控件。默认值为 true
end
(int) 从视频开始算起的时间(以秒为单位),播放器应在此时停止播放视频。
loading
(string) iframe 元素的 loading 属性,eagerlazy。默认值为 eager
loop
(bool) 是否无限重复播放视频。第一次播放后忽略 startend 参数。默认值为 false
mute
(bool) 是否将视频静音。当 autoplaytrue 时始终为 true。默认值为 false
start
(int) 从视频开始算起的时间(以秒为单位),播放器应从此处开始播放视频。
title
(string) iframe 元素的 title 属性。默认值为 “YouTube video”。

以下是使用一些可用参数的示例:

{{< youtube id=0RKpf3rK57I start=30 end=60 loading=lazy >}}

隐私

在你的站点配置中调整相关的隐私设置。

privacy:
  youTube:
    disable: false
    privacyEnhanced: false
[privacy]
  [privacy.youTube]
    disable = false
    privacyEnhanced = false
{
   "privacy": {
      "youTube": {
         "disable": false,
         "privacyEnhanced": false
      }
   }
}
disable
(bool) 是否禁用短代码。默认值为 false
privacyEnhanced
(bool) 是否阻止 YouTube 在用户播放嵌入视频之前在你的网站上存储访客信息。默认值为 false

Last updated: January 1, 0001
Improve this page