Stellar v2 将页面外观与行为拆分到命名明确的对象中。Hexo 自带的 title、date、tags、categories、description、excerpt 等字段保持不变。
推荐模板
blog/scaffolds/post.md---
title: {{ title }}
date: {{ date }}
tags: []
categories: []
description:
card:
cover:
tagline:
banner:
image:
headline:
tagline:
listing:
priority: 0
article:
style: tech
paragraph_indent: never
author:
ai_label:
footer:
references: []
license: null
share: true
show_tags: true
comments:
enabled: true
visibility:
listed: true
searchable: true
sidebar:
left:
widgets:
right:
widgets:
navigation:
menu: post
breadcrumb: true
render:
math: false
diagrams: false
---
|
不需要的对象可以整段删除，不要保留类型错误的空值。
列表卡片
card 只控制文章在首页、专栏、搜索等列表中的呈现：
card:
cover: https://example.com/card.webp
tagline: 一行辅助文案
|
card.tagline 缺失时依次使用 description、excerpt 或正文摘要。主题不会用横幅图片或其它身份图标自动补 card.cover。
主题级卡片样式与自动摘要长度在 _config.stellar.yml 的 content.article.listing 中配置：
content:
article:
listing:
card_layout: hero
excerpt_length: 200
|
内容页横幅
banner 只控制内容页顶部：
banner:
enabled: true
image: https://example.com/banner.webp
avatar: https://example.com/avatar.webp
headline: 快速开始
tagline: 页面顶部的一行说明
|
设置 banner.enabled: false 可关闭横幅。banner.headline: '' 可隐藏横幅主标题。横幅与卡片需要使用同一张图时，请分别显式配置 card.cover 和 banner.image。
文章排版和作者
article:
style: story
paragraph_indent: always
author: xaoxuu
ai_label: reviewed
|
tech 是默认技术文章风格，story 会增加文字与段落间距。作者 id 对应 _data/authors.yml。
所属集合
页面使用同一组字段加入 Wiki、专栏或笔记本：
collection:
profile: topic
id: stellar
|
collection:
type: wiki
id: hexo-stellar
|
collection:
type: notebook
id: dev-notes
|
置顶和可见性
listing:
priority: 10
visibility:
listed: true
searchable: true
|
listing.priority > 0 才置顶，数字越大越靠前。visibility.listed 控制主题列表，visibility.searchable 控制站内搜索；两者可以分别设置。
导航和侧边栏
navigation:
menu: more
breadcrumb: false
sidebar:
left:
widgets: [recent]
search: false
menu: true
brand:
image:
src: https://example.com/icon.svg
style: icon
name: 关于本站
tagline: 独立页面
url: /about/
right:
widgets: [toc]
|
navigation.menu 对应 menubar.items 中的 id，用于高亮主菜单。sidebar.left 是页面左侧主导航栏，sidebar.right 是正文右侧辅助栏；widgets 必须写成数组。
手机端 Brand 栏由页面类型自动决定：主页和各类索引/列表页显示，文章、普通页面、集合内容页、归档、作者页和 404 隐藏，不提供页面开关。
参考资料、许可和分享
footer:
references:
- '[参考资料](https://example.com)'
license: '本文采用 CC BY-NC-SA 4.0 许可协议。'
share: true
|
footer.license: true 沿用主题的文章许可文案，字符串则覆盖文案，false 隐藏。footer.share 控制分享入口。
评论
comments:
enabled: true
title: 欢迎讨论
id: shared-thread
service: giscus
giscus:
data-repo: owner/repo
data-mapping: specific
data-term: shared-thread
|
enabled: false 关闭当前页面评论。Giscus、Twikoo、Waline 等服务对象保持上游字段名。
摘要与 Open Graph
正文开头与正文之间可使用 <!-- more --> 生成摘要。也可以直接配置 Hexo 的 description 或 excerpt。
open_graph:
image: https://example.com/social.webp
|
open_graph 属于现有 SEO 集成，字段格式保持插件约定。
独立页面
关于、友链等独立页面无需特殊布局。通过 navigation.menu 设置菜单高亮，再按需组合 Stellar 标签：
blog/source/about/index.md---
title: 关于
navigation:
menu: more
sidebar:
left:
widgets: [recent]
right:
widgets: [toc]
---
|
友链可以在任意页面通过友链标签插入，详见
。