# 楠枝文档中心

> Ethereal 主题与初春图床插件的使用文档

## 关于

- [关于与反馈](/about.md): 站点说明 · 作者与项目 · 反馈渠道

## Others

- [自定义样式与代码注入](/ethereal/advanced/custom.md): 适用版本 ≥ 2.0.0 ｜ 后台路径：设置 → 代码注入 主题没有开放在线编辑 CSS 的设置，需要微调样式时走 Halo 的「代码注入」。这一篇给出可安全覆盖的变量、注入位置与升级注意事项。
- [插件兼容清单](/ethereal/advanced/plugins.md): 适用版本 ≥ 2.0.0 ｜ 后台路径：插件（Halo 后台） 主题核心功能不依赖插件，但很多页面与卡片由插件提供数据。下表按「深度集成 / 建议安装 / 可选」分类，安装后对应功能自动生效，无需主题侧额外配置。
- [Banner 样式](/ethereal/appearance/banner-style.md): 适用版本 ≥ 2.0.0 ｜ 后台路径：主题设置 → 样式设置 → Banner 样式 / 标题与副标题 素材与文案层：放什么图、怎么轮播、移动端用不用另一套图、标题怎么动。Banner 的形态（横幅 / 全屏 / 透明）在 Banner 里设置。
- [Banner](/ethereal/appearance/banner.md): 适用版本 ≥ 2.0.0 ｜ 后台路径：主题设置 → 布局设置 → Banner 布局 Banner 是首页顶部的视觉区，也是整套页面高度的基准。这一页只讲形态与高度；图片、视频、轮播的素材配置见 Banner 样式。
- [浮动按钮与欢迎弹窗](/ethereal/appearance/floating.md): 适用版本 ≥ 2.0.0 ｜ 后台路径：主题设置 → 布局设置 → 浮动导航按钮 / 欢迎弹窗 右下角的快捷按钮，以及访客首次进入时的问候卡片。两者默认都存在，但可以按需关掉或替换。
- [页面布局](/ethereal/appearance/layout.md): 适用版本 ≥ 2.0.0 ｜ 后台路径：主题设置 → 布局设置 → 页面布局 决定全站是「内容 + 左右两栏」还是「内容 + 单侧栏」，以及内容区顶部要不要挂分类导航和瞬间预览条。Banner 的形态不在这里，见 Banner。
- [菜单栏](/ethereal/appearance/navbar.md): 适用版本 ≥ 2.0.0 ｜ 后台路径：主题设置 → 布局设置 → 菜单栏设置 / 访客样式切换 控制顶部导航：Logo、站名、菜单来源、移动端形态、是否固定，以及允许访客在前台改哪些样式。
- [文章卡片](/ethereal/appearance/post-list.md): 适用版本 ≥ 2.0.0 ｜ 后台路径：主题设置 → 布局设置 → 文章卡片布局 首页、归档、分类、标签、搜索结果里的文章列表长什么样，都由这里决定。列表与网格是两套独立参数，切换布局时各自的设置会保留。
- [主题风格](/ethereal/appearance/theme-style.md): 适用版本 ≥ 2.0.0 ｜ 后台路径：主题设置 → 样式设置 主题色、明暗方案、语言、动画节奏与字体。这一组决定「全站看起来是什么气质」，与具体页面无关。
- [扩展页面](/ethereal/content/extend-pages.md): 适用版本 ≥ 2.0.0 ｜ 后台路径：主题设置 → 扩展页面 朋友圈、时间轴、技能、关于、打赏、心愿便签六个模板的全部配置。创建页面的步骤见 基础页面与模板。
- [友链页](/ethereal/content/friends.md): 适用版本 ≥ 2.0.0 ｜ 后台路径：主题设置 → 友情链接 /links 页面的配置。友链数据本身由「链接管理」插件管理，这里控制展示方式、申请流程与说明文案。
- [基础页面与模板](/ethereal/content/pages.md): 适用版本 ≥ 2.0.0 ｜ 后台路径：页面（Halo 后台）＋ 主题设置 → 扩展页面 Halo 的「页面」是一套独立于文章的内容类型。主题提供多个页面模板，创建页面时选择对应模板，就能得到时间轴、关于、打赏等不同形态。
- [其它插件页面](/ethereal/content/plugin-pages.md): 适用版本 ≥ 2.0.0 ｜ 后台路径：无（由插件提供路由，主题提供模板） 有些页面不需要你创建，也不需要配置：安装并启用插件后，插件会注册固定路由，主题自动套用同名模板。这一篇说明哪些页面属于这一类，以及样式不匹配时怎么判断。
- [文章页](/ethereal/content/post-page.md): 适用版本 ≥ 2.0.0 ｜ 后台路径：主题设置 → 文章 决定文章正文长什么样：封面、目录、摘要、版权，以及文末的点赞 / 分享 / 打赏操作栏。
- [常见问题与排错](/ethereal/getting-started/faq.md): 适用版本 ≥ 2.0.0 ｜ 后台路径：无 按「现象 → 原因 → 处理」组织。排查前先做两件事：强刷页面（排除缓存）、切换到默认主题对比（判断是主题还是插件问题）。
- [安装与升级](/ethereal/getting-started/install.md): 适用版本 ≥ 2.0.0 ｜ 后台路径：主题
- [功能总览与页面预览](/ethereal/getting-started/overview.md): 适用版本 ≥ 2.0.0 ｜ 后台路径：无（前台页面） 这一篇用两张表回答两个问题：主题提供了哪些页面、每个页面由什么功能支撑。配置前先在这里定位，再跳到对应文档。
- [关于 Ethereal](/ethereal/index.md): 适用版本 ≥ 2.0.0 ｜ Halo ≥ 2.25.0 Ethereal 是一款为 Halo 2 打造的 Fuwari 风格博客主题。它在保持内容优先、界面清爽的前提下，把「壁纸、布局、侧边栏、访客交互」都做成可调项：默认状态开箱即用，需要个性化时几乎每个视觉层都能在后台改。
- [小组件与布局](/ethereal/sidebar/overview.md): 适用版本 ≥ 2.0.0 ｜ 后台路径：主题设置 → 侧边栏 → 小组件设置 侧边栏由「条目列表」驱动：往左栏、右栏、移动端三个列表里添加条目，再拖拽排序。小组件本身的参数不在这里，在下方对应的独立分组中配置。
- [小组件详解](/ethereal/sidebar/widgets.md): 适用版本 ≥ 2.0.0 ｜ 后台路径：主题设置 → 侧边栏 每个小组件的参数都在同名分组里，添加 / 排序在 小组件与布局。以下按分组顺序说明。
- [登录与认证页](/ethereal/site/auth.md): 适用版本 ≥ 2.0.0 ｜ 后台路径：主题设置 → 杂项设置 → 认证设置 访客触发登录（评论、会员页、后台入口）时看到的登录页样式。
- [外链跳转](/ethereal/site/external-link.md): 适用版本 ≥ 2.0.0 ｜ 后台路径：主题设置 → 外链跳转 访客点击站外链接时，先显示一个跳转提示页，避免误入钓鱼站或无意中离开站点。只对外部域名生效，站内链接不受影响。
- [页脚](/ethereal/site/footer.md): 适用版本 ≥ 2.0.0 ｜ 后台路径：主题设置 → 页脚 页脚的结构、备案信息、链接与友情链接卡片墙。页脚底部还有插件扩展点，代码注入类内容也会在这里输出。
- [速度优化](/ethereal/site/performance.md): 适用版本 ≥ 2.0.0 ｜ 后台路径：主题设置 → 速度优化 → 图片处理 对封面、正文图片、Banner、头像做实时压缩与缩放，减少带宽。原理是给图片地址附加服务商的处理参数，不改变原图。
- [SEO 与元信息](/ethereal/site/seo.md): 适用版本 ≥ 2.0.0 ｜ 后台路径：主题设置 → 杂项设置 → SEO 设置 主题输出的搜索引擎与社交分享元信息。默认开启，绝大多数站点不需要改动。
- [开发与架构](/oneimg/development.md): 适用版本 1.0.4 ｜ 面向二次开发与源码阅读 插件由「Java 后端 + Vue 3 控制台扩展」两部分组成，构建产物是一个 Halo 插件 JAR。许可证为 GPL-3.0。
- [常见问题](/oneimg/faq.md): 适用版本 1.0.4 ｜ 后台路径：插件 / 附件
- [初春图床 Halo 插件](/oneimg/index.md): 适用版本 1.0.4 ｜ Halo ≥ 2.25.0 ｜ 后台路径：插件 / 附件 把自部署的 初春图床（oneimg） 接入 Halo 2.x 的附件系统：新上传的图片直接进入图床，图床里已有的图片可以批量同步回 Halo 附件库。
- [安装与部署](/oneimg/install.md): 适用版本 1.0.4 ｜ Halo ≥ 2.25.0 ｜ 后台路径：插件 / 应用市场 插件只负责「Halo ↔ 图床」的对接，图床服务需要单独部署。顺序不要颠倒：先有图床和 Token，再装插件。
- [存储策略配置](/oneimg/storage.md): 适用版本 1.0.4 ｜ 后台路径：附件 → 存储策略 → 新增 → 初春图床 插件通过一条 Halo 存储策略接入图床。策略决定「图片传到哪个图床、哪个桶、带什么标签」。
- [同步与清理](/oneimg/sync.md): 适用版本 1.0.4 ｜ 后台路径：插件 → 初春图床 → 同步 把图床里已有的图片批量导入 Halo 附件库，并在同步结束后清理 Halo 侧已失效的附件记录。适合「先用了图床，后接入 Halo」或「换过图床」的场景。