Grav 1.7 Appi主题：如何为herohome模块设置背景图

核心原因 #

Twig模板逻辑依赖模块页面的header配置项background_image，而非正文插入的图片标记，你之前的操作未正确配置这个关键参数。

正确设置步骤 #

1. 放置图片到正确位置

   • 将backgroundImage.jpg上传到**_hero模块的媒体库**（对应本地目录user/pages/03.mod/_hero/），模板里的page指向当前模块页面，而非父级的03.mod页面。

2. 配置模块的header参数
   两种方式二选一：

   • 后台操作：进入Grav后台，编辑_hero模块，在「Page Headers」区域添加键值对：background_image: backgroundImage.jpg
   • 手动编辑文件：打开user/pages/03.mod/_hero/default.md，在顶部YAML头部添加配置：

     ---
     title: Hero
     background_image: backgroundImage.jpg
     # 保留原有其他配置（如type等）
     ---
     

3. 移除正文的图片标记
   无需在模块正文插入![backgroundImage](backgroundImage.jpg)，该标记用于在内容区显示图片，和背景图逻辑无关。

额外排查点 #

• 确认文件名大小写完全匹配（类Unix系统下Grav区分大小写）
• 清除Grav缓存：后台点击「Clear Cache」，或手动删除cache/目录下的文件

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