> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# 关于 Ethereal

> 适用版本 ≥ 2.0.0 ｜ Halo ≥ 2.25.0

Ethereal 是一款为 Halo 2 打造的 Fuwari 风格博客主题。它在保持内容优先、界面清爽的前提下，把「壁纸、布局、侧边栏、访客交互」都做成可调项：默认状态开箱即用，需要个性化时几乎每个视觉层都能在后台改。

## 设计取向

- **内容优先**：正文排版、目录、摘要、版权与分享都围绕阅读展开，装饰元素可逐项关闭
- **渐进增强**：樱花、磨砂、Banner 动画等特效默认关闭或可关，弱设备与省流场景不受影响
- **一次配置，多处生效**：主题色、圆角、卡片样式等由 CSS 变量驱动，后台改一处即可全站一致
- **访客可调但可控**：前台「显示设置」面板开放哪些标签页，由后台逐项决定

## 能力地图

| 能力     | 说明                               | 文档                                                                                           |
| ------ | -------------------------------- | -------------------------------------------------------------------------------------------- |
| 页面布局   | 两栏 / 三栏切换，两栏支持右栏模式；目录可挂左栏或右栏     | [页面布局](/ethereal/appearance/layout.md)                                                       |
| Banner | 关闭 / 横幅 / 全屏 / 全屏透明四种模式，图片、视频、轮播 | [Banner](/ethereal/appearance/banner.md) · [Banner 样式](/ethereal/appearance/banner-style.md) |
| 菜单栏    | Logo、菜单、移动端手风琴 / 抽屉、固定栏、语言与配色切换  | [菜单栏](/ethereal/appearance/navbar.md)                                                        |
| 文章卡片   | 列表 / 网格、封面比例、瀑布流、简介行数            | [文章卡片](/ethereal/appearance/post-list.md)                                                    |
| 主题风格   | 主题色相、深浅色、切换动画、语言、动画速度、外部字体       | [主题风格](/ethereal/appearance/theme-style.md)                                                  |
| 侧边栏    | 11 类小组件、任意排序、吸顶规则、移动端独立列表        | [小组件与布局](/ethereal/sidebar/overview.md) · [小组件详解](/ethereal/sidebar/widgets.md)              |
| 文章页    | 目录、摘要、版权、点赞 / 分享海报 / 打赏          | [文章页](/ethereal/content/post-page.md)                                                        |
| 扩展页面   | 朋友圈、时间轴、技能、关于、打赏、心愿便签            | [扩展页面](/ethereal/content/extend-pages.md)                                                    |
| 站点集成   | 页脚、外链提示、SEO、登录页、图片处理             | [页脚](/ethereal/site/footer.md) 等                                                             |
| 访客样式   | 访客在前台调整主题色、布局、卡片、壁纸与特效           | [菜单栏](/ethereal/appearance/navbar.md)                                                        |

## 版本与更新

- 主题版本以 `theme.yaml` 为准，文档按大版本维护：文档中的「适用版本」低于你的主题版本时，请以对应版本的文档为准
- 后台「主题 → 检查更新」可获取新版本；更新不会重置设置，但**分组改名的版本会有部分设置回落默认**，升级前请先记录当前设置
- 主题要求 Halo ≥ 2.25.0，低于此版本无法安装

## 反馈

- Issue：[https://github.com/AloneNanNan/halo-theme-ethereal/issues](https://github.com/AloneNanNan/halo-theme-ethereal/issues)
- 交流群：1098801176
- 提问时请附上 Halo 版本、主题版本、浏览器与复现步骤，涉及显示问题请附截图与设备宽度

## 相关链接

- 应用市场：[https://www.halo.run/store/apps/app-zqvrlonl](https://www.halo.run/store/apps/app-zqvrlonl)
- 源码仓库：[https://github.com/AloneNanNan/halo-theme-ethereal](https://github.com/AloneNanNan/halo-theme-ethereal)
- 演示站点：[https://www.nanzhiy.cn/](https://www.nanzhiy.cn/)