Stellar：布局与导航

Stellar 把页面分成顶部栏、左侧栏和右侧栏。左边通常放站点名字与主菜单，右边适合目录或仓库信息；手机空间不够时，它们会收进抽屉。

以下示例在顶部放首页和文档入口，左侧放博客、笔记和搜索，文章页右侧显示目录。

配置导航菜单

blog/_config.stellar.yml

topbar:
  enabled: true
  menu:
    - id: home
      title: 首页
      url: /
    - id: docs
      title: 文档
      url: /wiki/
leftbar:
  menu:
    - id: post
      title: 博客
      icon: default:documents
      url: /
    - id: notes
      title: 笔记
      icon: default:documents
      url: /notebooks/
    - type: search
profiles:
  post:
    rightbar:
      widgets: [toc]

菜单数组整体替换默认列表。链接项填写 id/title/url，非空 kebab-case 的 id 用于与 active_menu 匹配；type: search 是搜索入口。Topbar 开关、固定 Brand/Menu 与 Widget 列表分开配置。

为页面或集合单独配置

blog/source/_data/wiki/handbook.yml

name: 使用手册
active_menu: notes
breadcrumb: true
leftbar:
  widgets: [tree, related]
rightbar:
  widgets: [toc]

Wiki 默认隐藏 Leftbar 固定菜单与操作区，保留文档树。需要菜单时在 Collection 明确设置 leftbar.menu。页面也可用相同 Region 字段进一步覆盖；覆盖顺序见行为参考。

页脚与附加导航

blog/_config.stellar.yml

leftbar:
  footer:
    actions:
      - type: link
        title: 关于
        icon: default:profile
        url: /about/
footer:
  content: '记录每一天。'
  sections:
    - title: 站点
      items:
        - title: 关于
          url: /about/
profiles:
  blog_index:
    listing_nav:
      enabled: true
      tabs:
        - title: 朋友文章
          url: /friends/rss/

Leftbar 底部操作支持链接、按钮、下拉和占位项。主题 footer 是主内容区站点页脚，页面 footer 则是许可、参考资料和分享，两者不能互换。

折叠与移动端

leftbar.default_state 设置桌面初始状态，支持 expanded/collapsed。移动端通过主题抽屉入口打开侧栏；隐藏某个 Region 使用它的 enabled: false，清空内容用 widgets: []。

Widget 放在不支持的位置时会被跳过，并在 Doctor 报告中产生警告。各组件支持的位置见 Widget 参考。