配置首页推荐与侧栏组合

solitude@example.org (Solitude) — Mon, 24 Aug 2026 10:00:00 +0800

线上演示站通过首页推荐和侧栏卡片帮助访客快速理解站点。Hugo 版本已经把这些能力收进主题配置：内容来自站点数据，不需要服务端接口，也不需要额外的侧栏插件。

首页标题与推荐内容

首页顶部由 params.solitude.hometop 控制。推荐项最多展示五条；配置不足五条时，主题会按发布日期自动补入最近文章。

params:
 solitude:
 hometop:
 enable: true
 banner:
 title: 用 Solitude<br>记录与创造
 desc: Hugo 主题演示、配置指南与前端实践
 recommendList:
 - title: 开始使用 Solitude Hugo
 url: /p/getting-started.html
 cover: /img/demo/cover-getting-started-v2.webp
 label: 快速开始
 color: "#3b82f6"
 - title: 配置首页推荐与侧栏组合
 url: /p/homepage-and-aside.html
 cover: /img/demo/cover-pagination-v2.webp
 label: 配置指南
 color: "#16a34a"

url 应当使用文章最终生成的地址，cover 则应放在站点 static/ 下或指向稳定的远程资源。首页卡片会复用文章标题、分类和封面，因此不必为自动补入的文章重复维护数据。

组合不同页面的侧栏

侧栏支持四个内置组件：

about：站点或作者信息卡。
newestPost：最近发布的五篇文章。
allInfo：标签与文章数、字数、运行时间等站点信息。
newest_comment：启用受支持评论服务后展示最近评论。

每种页面可以分别声明普通区域和吸顶区域：

params:
 solitude:
 aside:
 position: 1
 home:
 noSticky: about
 Sticky: allInfo
 post:
 noSticky: about
 Sticky: newestPost,allInfo
 page:
 noSticky: about
 Sticky: newestPost,allInfo

组件名称使用逗号分隔。文章存在 Markdown 标题并且没有设置 toc: false 时，目录会自动插入吸顶区域，不需要把 toc 写进组件列表。

用数据文件构建特色页面

solitude@example.org (Solitude) — Sun, 23 Aug 2026 10:00:00 +0800

Solitude 的特色页面使用 Hugo 分支包与数据文件协作：_index.md 决定页面地址和类型，data/ 中的 YAML 保存可重复维护的内容。调整数据即可更新页面，无需复制模板。

创建页面入口

以装备页为例，创建 content/equipment/_index.md：

---
title: 我的装备
type: kit
data: kit
aliases:
 - /kit/
---

type 用于选择 Solitude 的专用模板；data 可以把默认的 data/kit.yaml 改成其他文件名。关于、友链和即刻短文分别使用 about、links 与 brevity 类型。

关于页的模块顺序

data/about.yaml 必须使用模块化的 sections 数组，列表顺序就是最终展示顺序：

title: 关于 Solitude
sections:
 - type: intro
 greeting: 你好，欢迎了解 Solitude
 name_prefix: 这是
 name: Solitude
 description: 一款专注内容体验的 Hugo 主题

 - type: values
 motto:
 label: 设计原则
 prefix: 内容优先
 content: 克制表达
 expertise:
 label: 主题能力
 prefix: 专注于
 specialist: 阅读体验
 content: 长期维护
 level: 原生