nxxy335
5c7c6325b1
- 文档对齐 1.2.7：feed/RSS 聚合改由官方链接管理插件订阅承担、Halo 要求统一 >=2.27.0、补齐设置分组文档、清理与代码不符的描述，并修复正文引用块留白 - 三个可选 API 设置项 help 只保留功能说明，隐私披露统一由 README「外部资源与隐私」与文档站承载；字段恢复按开关条件显示，修正配置块缩进 - audit:external 改为防回潮检查：字段存在、help 不得出现披露文案、README 必须保留隐私披露章节
2.2 KiB
2.2 KiB
首页
首页是网站的入口，由 Hero 首屏、置顶文章和文章列表三个模块组成。
页面结构
首页从上到下依次为：
- Hero 首屏 — 全屏展示区（可通过 Hero 设置关闭）
- 置顶文章 — 显示置顶的文章，大卡片布局
- 文章列表 — 非置顶文章的流式布局
Hero 首屏
Hero 区域占据整个视口高度，包含：
- 主标题：默认使用站点标题，可在主题设置中自定义
- 副标题：默认使用站点副标题
- 描述文案：默认「无」（不显示、零请求）；可选「一言」（API 字段默认预填
https://v1.hitokoto.cn/，清空则用内置本地句子库）或「自定义」静态文案 - 视觉效果：渐变背景 + 呼吸光球 + 滚动模糊
页面滚动时，Hero 区域会产生模糊效果，内容向上淡出，底部有向下箭头提示滚动。
Hero 设置详见 Hero 首屏配置。
置顶文章
在 Halo 后台将文章设置为「置顶」后，该文章会出现在首页置顶区域：
- 单篇置顶：全宽大卡片展示
- 多篇置顶：两列网格布局
- 显示分类、日期、标题和摘要
- 支持封面图，悬停时图片微缩放
文章列表
非置顶文章以流式卡片布局展示：
- 有封面图：左侧内容 + 右侧缩略图
- 无封面图：纯文字布局
- 移动端：统一为上下布局
每张卡片显示以下信息（均可通过主题设置控制显隐）：
- 分类标签
- 发布日期
- 文章标题
- 文章摘要（可配置行数）
- 标签列表
- 阅读量
文章加载方式
支持两种加载方式，在 首页配置 中设置：
分页
传统翻页导航，页面底部显示「较新」「较旧」按钮和页码信息。
无限滚动
滚动到页面底部时自动加载下一页文章，新文章以渐入动画出现。加载过程中显示旋转加载指示器，全部加载完毕后显示提示文案。