HUGO

  • 新闻
  • 文档
  • 主题
  • 社区
  • GitHub
gohugoio 加星
  • 关于
    • 在本节中
    • 简介
    • 特性
    • 隐私
    • 安全
    • 许可证
  • 安装
    • 在本节中
    • macOS
    • Linux
    • Windows
    • BSD
  • 入门
    • 在本节中
    • 快速开始
    • 基本用法
    • 目录结构
    • 配置
    • 配置标记
    • 配置构建
    • 术语表
    • 外部学习资源
  • 快速参考
    • 在本节中
    • 表情符号
    • 函数
    • 方法
    • 页面集合
  • 内容管理
    • 在本节中
    • 组织
    • 页面捆绑包
    • 内容格式
    • 前置信息
    • 构建选项
    • 页面资源
    • 图像处理
    • 短代码
    • 相关内容
    • 章节
    • 内容类型
    • 原型
    • 分类法
    • 摘要
    • 链接和交叉引用
    • URL 管理
    • 菜单
    • 评论
    • 多语言
    • Markdown 属性
    • 语法高亮
    • 图表
    • 数学
    • 数据源
    • 内容适配器
  • 模板
    • 在本节中
    • 简介
    • 模板类型
    • 查找顺序
    • 基础模板
    • 主页模板
    • 单页模板
    • 章节模板
    • 分类模板
    • 术语模板
    • 局部模板
    • 内容视图模板
    • 短代码模板
    • 站点地图模板
    • RSS 模板
    • 404 模板
    • robots.txt 模板
    • 菜单
    • 分页
    • 嵌入式模板
    • 自定义输出格式
  • 函数
    • 在本节中
    • cast
    • collections
    • compare
    • crypto
    • css
    • data
    • debug
    • diagrams
    • encoding
    • fmt
    • global
    • go 模板
    • hash
    • hugo
    • images
    • inflect
    • js
    • lang
    • math
    • openapi3
    • os
    • partials
    • path
    • reflect
    • resources
    • safe
    • strings
    • templates
    • time
    • transform
    • urls
  • 方法
    • 在本节中
    • Duration
    • Menu
    • 菜单项
    • Page
    • Pager
    • Pages
    • Resource
    • Shortcode
    • Site
    • Taxonomy
    • Time
  • 渲染钩子
    • 在本节中
    • 简介
    • 块引用
    • 代码块
    • 标题
    • 图像
    • 链接
    • 直通
    • 表格
  • 短代码
    • 在本节中
    • 评论
    • 详细信息
    • 图
    • Gist
    • 高亮
    • Instagram
    • Param
    • QR
    • Ref
    • Relref
    • Vimeo
    • X
    • YouTube
  • Hugo 模块
    • 在本节中
    • 配置 Hugo 模块
    • 使用 Hugo 模块
    • 主题组件
  • Hugo Pipes
    • 在本节中
    • 简介
    • 将 Sass 转译为 CSS
    • PostCSS
    • 后处理
    • JavaScript 构建
    • 资源压缩
    • 连接资源
    • 指纹识别和 SRI 哈希
    • 从字符串创建资源
    • 从模板创建资源
  • CLI
  • 故障排除
    • 在本节中
    • 审核
    • 日志
    • 检查
    • 弃用
    • 性能
    • 常见问题解答
  • 开发者工具
    • 在本节中
    • 编辑器插件
    • 前端
    • 搜索
    • 迁移
    • 其他项目
  • 托管和部署
    • 在本节中
    • Hugo Deploy
    • 使用 Rclone 部署
    • 使用 Rsync 部署
    • 在 21YunBox 上托管
    • 在 AWS Amplify 上托管
    • 在 Azure 静态 Web 应用上托管
    • 在 Cloudflare Pages 上托管
    • 在 Firebase 上托管
    • 在 GitHub Pages 上托管
    • 在 GitLab Pages 上托管
    • 在 KeyCDN 上托管
    • 在 Netlify 上托管
    • 在 Render 上托管
  • 贡献
    • 在本节中
    • 开发
    • 文档
    • 主题
  • 维护
短代码

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
v0.125.0 中的新增功能
(bool) iframe 元素是否可以激活全屏模式。默认值为 true。
autoplay
v0.125.0 中的新增功能
(bool)是否自动播放视频。强制 mute 为 true。默认值为 false。
class
(string)包装 div 元素的 class 属性。指定时,将从 iframe 元素及其包装 div 元素中删除 style 属性。
controls
v0.125.0 中的新增功能
(bool)是否显示视频控件。默认值为 true。
end
v0.125.0 中的新增功能
(int)播放器应停止播放视频的时间,以秒为单位,从视频开始算起。
loading
v0.125.0 中的新增功能
(string)iframe 元素的 loading 属性,可以是 eager 或 lazy。默认值为 eager。
loop
v0.125.0 中的新增功能
(bool)是否无限重复播放视频。在第一次播放后忽略 start 和 end 参数。默认值为 false。
mute
v0.125.0 中的新增功能
(bool)是否将视频静音。当 autoplay 为 true 时,始终为 true。默认值为 false。
start
v0.125.0 中的新增功能
(int)播放器应开始播放视频的时间,以秒为单位,从视频开始算起。
title
(string)iframe 元素的 title 属性。默认为 “YouTube 视频”。

使用上述部分参数的示例

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

隐私

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

hugo。
     
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。

另请参阅

  • Vimeo
  • 详细信息
  • 图
  • 高亮
  • Instagram

在本页

  • 示例
  • 参数
  • 隐私

在本节中

  • 评论
  • 详细信息
  • 图
  • Gist
  • 高亮
  • Instagram
  • Param
  • QR
  • Ref
  • Relref
  • Vimeo
  • X
  • YouTube
上次更新时间:2025 年 1 月 16 日: 将嵌入式短代码文档提升到其自己的部分 (a346ca1fd)
改进此页面
由 Hugo 作者
Hugo Logo
  • 提交问题
  • 获取帮助
  • @GoHugoIO
  • @spf13
  • @bepsays

Netlify badge

 

Hugo 赞助商

您的公司?
 

Hugo 徽标的版权归 Steve Francia 2013–2025 所有。

Hugo 地鼠基于 Renée French 的原创作品。

  • 新闻
  • 文档
  • 主题
  • 社区
  • GitHub
  • 关于
  • 安装
  • 入门
  • 快速参考
  • 内容管理
  • 模板
  • 函数
  • 方法
  • 渲染钩子
  • 短代码
  • Hugo 模块
  • Hugo Pipes
  • CLI
  • 故障排除
  • 开发者工具
  • 托管和部署
  • 贡献
  • 维护