Home Assistant Dashboard 项目启动与配置教程

1. 项目的目录结构及介绍

Home Assistant Dashboard 是一个开源项目，旨在为 Home Assistant 智能家居系统提供一个可定制的仪表盘界面。以下是项目的目录结构及各部分的简要介绍：

hadashboard/
├── components/          # 存放各种自定义组件的目录
├── dashboard/           # 仪表盘的主要文件，包括HTML、CSS和JavaScript
├── docs/                # 项目文档
├── img/                 # 存放项目所需的图片资源
├── json/                # 存放JSON格式的配置文件
├── locales/             # 国际化文件，包含不同语言的翻译
├── manifest.json        # 插件元数据文件
├── package-lock.json    # 依赖锁定文件
├── package.json         # 项目依赖和配置文件
└── ui/                  # 用户界面相关的文件，包括HTML和JavaScript

2. 项目的启动文件介绍

Home Assistant Dashboard 项目的启动主要通过 manifest.json 文件来定义。以下是 manifest.json 文件的基本内容：

{
  "domain": "hadashboard",
  "name": "Dashboard",
  "version": "0.1.0",
  "description": "A custom dashboard for Home Assistant",
  "dependencies": [],
  "discovery": [],
  "configuration": {
    "type": "yaml",
    "title": "Dashboard Configuration"
  },
  "icons": {
    "svelte": "ui/icon.png"
  }
}

在这个文件中，定义了插件的名称、版本、描述等信息，并且指明了配置文件的类型为 YAML。

3. 项目的配置文件介绍

Home Assistant Dashboard 的配置文件是 YAML 格式，通常放置在 Home Assistant 配置目录下的 configuration.yaml 文件中，或者单独创建一个配置文件如 hadashboard.yaml。以下是配置文件的一个示例：

hadashboard:
  theme: default
  dashboard_name: "我的仪表盘"
  show_sidebar: true
  show_header: false
  panels:
    - title: "房间温度"
      cards:
        - type: "sensor"
          entity: "sensor.room_temperature"
    - title: "智能家居设备"
      cards:
        - type: "switch"
          entity: "switch.my_light"

在配置文件中，可以设置主题、仪表盘名称、侧边栏和头部显示等，以及定义多个面板和卡片来展示不同的实体和组件。每个面板可以包含多个卡片，每个卡片根据类型和实体来展示不同的信息。