侧边栏组件

在「主题设置 → 侧边栏」中配置侧边栏小组件。Ethereal 支持 12 个小组件，可自由搭配组合。

布局与组件位置

  • 三栏布局：左侧边栏 + 右侧边栏，小组件可分布在两侧

  • 两栏布局：仅左侧边栏，右栏小组件不显示

在「主题设置 → 侧边栏 → 小组件设置」中分别配置左侧边栏和右侧边栏的组件。

小组件列表

组件

说明

配置项

公告

侧边栏首位展示公告内容

支持关闭与跳转链接，可配置显示位置

个人简介

站点头像、名称、简介展示

可配置展示位置与开关

天气

基于腾讯位置服务，自动定位显示天气

需填写 WebService API Key

音乐播放器

支持网易云、QQ、酷狗等平台歌单/歌曲

选择平台、类型、ID

一言

随机显示一句名言或短句

支持自定义 API 地址与失败兜底文案

站点统计

文章数、标签数、运行天数等

需填写网站上线日期

文章分类

分类列表导航

—

文章标签

标签云导航

—

热门文章

热度排行

—

自定义 HTML

自由嵌入任意内容

填写 HTML 代码

目录（TOC）

文章内容导航

仅三栏布局中显示

最近日程

配合「日程日历」插件，展示近期日程安排

需安装插件，可设置显示条数

限制说明

  • 公告与个人简介小组件由于组件性质不参与自由排列，仅允许放置左侧边栏或右侧边栏，不参与页面滑动小组件吸顶，并且都只允许放置在侧边栏首位。如果两个小组件同时存在于同一侧边栏，个人简介小组件始终显示在公告小组件上方

  • 音乐播放器小组件仅允许放置在左栏任意位置，不可放置右栏

  • 站点统计字数：总字数优先使用 API 扩展包 插件服务端统计，精确且零请求；未安装插件时自动回退客户端兜底统计

  • 最近日程小组件需安装 日程日历 插件

个人简介小组件

在「主题设置 → 侧边栏 → 个人简介小组件」中配置：

  • 启用：开启/关闭个人简介小组件

  • 显示位置：左侧边栏 / 右侧边栏（两栏布局时仅左侧）

  • 头像：上传头像图片

  • 昵称：显示名称

  • 简介：个人介绍文字

  • 链接：点击头像跳转的链接（如 /about 或 /login）

  • 社交媒体：添加社交媒体图标与链接

在线状态

昵称右侧的状态表情与展示文案，管理员登录后可在前台直接切换：

状态

默认文案

在线中

在线中

元气满满

元气满满

emo 中

emo 中

学习中

学习中

忙碌中

忙碌中

请勿打扰

请勿打扰

睡觉中

睡觉中

暂时离开

暂时离开

TIP

每个状态支持自定义文案（最多 10 字），留空则使用默认文案。

天气小组件

在小组件列表中添加天气组件后，需配置：

  • 腾讯位置服务 Key：WebService API 类型，免费注册：https://lbs.qq.com/dev/console/application/mine

  • 默认城市编码：IP 定位失败时的回退城市，填写行政区划编码如 110000（北京）或 310000（上海）

TIP

  • Key 会在前端页面源码中明文出现，建议在腾讯位置服务控制台配置域名白名单。

  • 需对【账户额度】下的 “天气:天气” 和“IP定位” 分别进行 配额分配，确保 “调用量分配” 和 “并发量分配” 满足网站需求。

音乐播放器

在小组件列表中添加音乐播放器后，需配置：

设置项

说明

平台

网易云 / QQ / 酷狗 / 虾米 / 百度

类型

歌曲 / 歌单 / 专辑 / 歌手 / 搜索

ID

歌曲 / 歌单 / 专辑 / 歌手 ID，搜索类型时填写关键词

播放模式

列表循环 / 单曲循环 / 随机

默认音量

0 ~ 1

自定义 Meting API

留空使用默认 API

一言小组件

在小组件列表中添加一言后，可配置：

  • 一言 API 地址：留空使用默认 API（https://v1.hitokoto.cn/）

  • 获取失败文案：API 获取失败时显示的兜底文案

  • 获取失败来源：兜底文案的作者/来源

站点统计

在小组件列表中添加站点统计后，可配置：

  • 网站上线日期：格式 YYYY-MM-DD，用于计算运行天数，留空则不显示运行天数