For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /ethereal/getting-started/overview.md.

功能总览与页面预览

适用版本 ≥ 2.0.0 | 后台路径:无(前台页面)

这一篇用两张表回答两个问题:主题提供了哪些页面、每个页面由什么功能支撑。配置前先在这里定位,再跳到对应文档。

页面清单

页面路径额外依赖说明
首页/无Banner、分类导航栏、瞬间预览条、文章卡片列表
文章页由 Halo 永久链接设置决定无目录、摘要、版权、点赞 / 分享 / 打赏
归档/archives无按年月归档,支持分类筛选
分类列表/categories无全部分类
分类详情/category/:slug无单个分类下的文章
标签列表/tags无全部标签
标签详情/tag/:slug无单个标签下的文章
独立页面创建页面时自定义无默认 page 模板,支持目录与评论
友链/links链接管理插件分组、搜索、随机访问、申请表单
朋友圈创建页面时自定义(示例 /friends)链接管理插件需在「扩展页面 → 朋友圈页面」配置
瞬间/moments瞬间插件列表、详情与分组
图库/photos图库插件相册列表与详情
项目集/portfolio项目集插件项目卡片与详情
追番/bangumis追番插件番剧列表
装备/equipments装备管理插件装备展示
日程日历/schedule-calendar日程日历插件周视图与 .ics 订阅
心愿便签创建页面时自定义(示例 /wishes)心愿便签插件需在创建页面时选择「心愿便签」模板
时间轴 / 技能 / 关于 / 打赏创建页面时自定义无主题内置模板,见 扩展页面
错误页由 Halo 触发无404 与其它状态码统一展示

路径列中标注「创建页面时自定义」的,都是自定义模板页:需要先在「后台 → 页面 → 新建页面」创建,再在页面设置里选择对应模板。其余带固定路径的页面由插件提供路由,主题只负责样式。

功能与文档对应

想要的效果去这里配置
改首页视觉与整体布局页面布局、Banner
换 Banner 图片 / 视频 / 轮播Banner 样式
改导航菜单、移动端菜单样式菜单栏
改文章列表的排布文章卡片
换主题色、深浅色、字体主题风格
增删侧边栏小组件小组件与布局
配置公告、天气、音乐等小组件详解
调整文章页的目录 / 摘要 / 版权文章页
新增关于、时间轴等页面扩展页面
改页脚、备案号页脚
开启图片压缩速度优化

页面预览

建议只放「首页、文章页、三栏 + 目录、关于页」四张整页截图,其余页面用文字说明即可,避免图片随版本频繁过期。

注意事项

  • 插件页面只有在插件启用后才会出现;插件停用后对应路径会 404,主题无需改动
  • 自定义模板页的路径由创建页面时决定,文档中的 /friends、/about 等只是示例,实际路径需要与页脚、菜单、关于页卡片里的链接保持一致
  • 页面清单里的固定路径可能被 Halo 的路由前缀设置影响(如部署在子目录),配置菜单与页脚链接时以实际访问地址为准