Home Assistant中Dwains Dashboard更多页面插件YAML代码报错修复咨询

问题背景 #

在Home Assistant中使用Dwains Dashboard时，配置更多页面插件的代码出现大量报错，尝试给提示缺逗号的行加引号后又产生新错误。原代码如下：

# dwains_dashboard

#More_page addon view 
{% if _dd_more_pages %}
{% for addon in _dd_more_pages %}
- title: {{ _dd_more_pages[addon]["name"] }}
  path: more_page_{{ addon|lower|replace("'", "_")|replace(" ", "_") }}
  type: custom:dwains-dashboard-layout
  icon: {{ _dd_more_pages[addon]["icon"] }}
  visible: true
  cards:    
    - type: custom:more-page-card
      name: {{ _dd_more_pages[addon]["name"] }}
      icon: {{ _dd_more_pages[addon]["icon"] }}
      show_in_navbar: {{ _dd_more_pages[addon]["show_in_navbar"] }}
      foldername: {{ addon }}
      card: !include ../../../../{{ _dd_more_pages[addon]["path"] }}
{% endfor %}
{% endif %}

报错核心原因 #

1. YAML语法不规范：Jinja2模板渲染后的字符串（比如名称、图标、路径）如果包含空格、特殊字符，未加引号会触发YAML语法错误
2. !include路径格式问题：未给模板渲染的路径部分加引号，导致YAML解析器无法正确识别包含变量的路径
3. 变量类型不匹配：如果show_in_navbar字段存储的是字符串类型（比如"true"）而非布尔值（true），也会引发类型错误

修复步骤 #

1. 给所有模板渲染字段添加引号 #

用单引号包裹所有Jinja2渲染的内容（避免和内部双引号冲突），确保YAML能正确解析字符串：

# dwains_dashboard

#More_page addon view 
{% if _dd_more_pages %}
{% for addon in _dd_more_pages %}
- title: '{{ _dd_more_pages[addon]["name"] }}'
  path: 'more_page_{{ addon|lower|replace("'", "_")|replace(" ", "_") }}'
  type: custom:dwains-dashboard-layout
  icon: '{{ _dd_more_pages[addon]["icon"] }}'
  visible: true
  cards:    
    - type: custom:more-page-card
      name: '{{ _dd_more_pages[addon]["name"] }}'
      icon: '{{ _dd_more_pages[addon]["icon"] }}'
      show_in_navbar: {{ _dd_more_pages[addon]["show_in_navbar"] }}
      foldername: '{{ addon }}'
      card: !include '../../../../{{ _dd_more_pages[addon]["path"] }}'
{% endfor %}
{% endif %}

2. 检查变量结构与类型 #

• 确认_dd_more_pages中每个项的show_in_navbar是布尔值（true/false），而非字符串（"true"/"false"）
• 验证path字段对应的文件路径是否存在，确保../../../../的层级正确指向目标配置文件

3. 排查循环渲染的格式问题 #

确保循环生成的每个列表项（- title: ...）之间没有多余的空行或缩进错误，YAML对缩进要求严格，保持统一的2空格缩进

是否需要修复？ #

必须修复。这些语法错误会导致Dwains Dashboard无法加载更多页面插件，不仅对应功能无法使用，严重时还会导致整个仪表盘加载失败，影响Home Assistant的正常使用。

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