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/sidebar/overview.md.

小组件与布局

适用版本 ≥ 2.0.0 | 后台路径:主题设置 → 侧边栏 → 小组件设置

侧边栏由「条目列表」驱动:往左栏、右栏、移动端三个列表里添加条目,再拖拽排序。小组件本身的参数不在这里,在下方对应的独立分组中配置。

配置项

选项默认值说明
左侧边栏小组件个人简介、公告、文章分类、文章标签按顺序显示。两栏布局开启「右栏模式」时显示在右侧
右侧边栏小组件一言、站点统计仅三栏布局生效
移动端小组件空留空则沿用上面两个列表的条目与顺序(左栏 + 右栏)

每个条目包含:

字段说明
小组件选择类型:个人简介 / 公告 / 热门文章 / 文章分类 / 文章标签 / 音乐播放器 / 一言 / 站点统计 / 天气 / 最近日程 / 自定义 HTML
吸顶勾选后滚动时固定在该栏;默认勾选,不吸顶需手动取消
名称 / HTML仅「自定义 HTML」使用,填写后按 HTML 渲染

吸顶规则

这是最容易踩坑的地方:不吸顶只对「前缀」生效。未勾选吸顶的条目,只有它前面的所有条目都未勾选时,才真正随页面滚动;一旦前面出现过吸顶条目,它也会被归入吸顶区。

列表:A(吸顶) → B(不吸顶) → C(吸顶) → D(不吸顶)
结果:A、B、C、D 全部进入吸顶区(B、D 虽然未勾选,但前面已有吸顶条目)

列表:A(不吸顶) → B(不吸顶) → C(吸顶) → D(不吸顶)
结果:A、B 随页面滚动;C、D 固定在吸顶区

因此「不吸顶」的条目必须集中在列表最前面。

推荐配法

简介随页滚、分类常驻:左栏「个人简介(不吸顶)→ 文章分类(吸顶)→ 文章标签(吸顶)」。简介在列表最前且不勾吸顶,滚动后分类标签固定在顶部。

整栏常驻:左栏「个人简介(吸顶)→ 文章分类 → 文章标签」。注意从简介开始整栏都会进入吸顶区;文章页若目录挂在同栏,吸顶区会限高,超出部分在栏内滚动。

文档感:右栏只放目录(文章页自动加入),左栏放简介与分类;三栏 + 目录位置选右侧时,目录占用右栏顶部。

移动端独立布局:移动端列表只放「个人简介 + 公告」,去掉分类与标签,减少手机端滚动长度(移动端不参与吸顶)。

注意事项

  • 同类型小组件可以重复添加,例如左栏和右栏各放一个公告,共用同一份配置
  • 移动端列表非空时,只显示该列表,且不参与吸顶、不受「文章页只保留前 2 个吸顶组件」的限制
  • 三栏布局的文章页,目录所在栏只保留前 2 个吸顶小组件,其余吸顶组件在该页隐藏;两栏布局不受影响
  • 小组件为空(例如站点统计一项都没勾)时整张卡片不渲染,不会留下空框
  • 侧边栏在换页时不会整体重建,只替换内容,所以小组件里的随机内容不会每次跳转都刷新