使用blogdown搭建hugo-academic站点时如何激活/停用widget

问题根本原因 #

你遇到的配置格式差异是Hugo Academic主题版本迭代导致的：

• 你参考的2020年教程对应v4及更早的旧版Academic主题，页面元数据使用TOML格式，配置项用key = value的写法，停用widget的参数是active = true/false
• 你当前安装的是v5及之后的版本，页面元数据已经全面切换为YAML格式，配置项用key: value的写法，就是你实际看到的---包裹的配置块格式

解决方案 #

如果要停用对应widget，直接在目标.md文件的YAML配置块（两个---中间的部分）任意位置新增一行active: false即可，以你的hero.md为例，修改后的配置如下：

---
widget: hero
active: false # 新增这一行即可停用hero组件
headless: true
weight: 10
title: Hugo Academic Theme
hero_media: hero-academic.png
# 剩余原有配置保持不变即可
---

补充说明 #

• 所有content/home目录下的组件停用逻辑完全一致，都可以通过加active: false实现
• 旧版主题的TOML配置参数大部分都可以直接转换成key: value的YAML格式复用，注意YAML对缩进要求严格，不要随便修改原有配置的缩进层级

内容的提问来源于stack exchange，提问作者Hugh Warden