更新于 

侧边栏配置

左上角的 logo 和标题取自站点根目录的配置文件:

blog/_config.yml
title: 网站名称
avatar: 头像

设置鼠标指上 subtitle 后翻转另一行字(您可以将鼠标移至左上角的Stellar查看效果)

blog/_config.yml
subtitle:  标题1 | 标题2

如果您想用一个图片作为 logo,可以直接在主题配置文件 sidebar.logo.title 中设置:

blog/_config.stellar.yml
sidebar:
logo:
title: '[<img no-lazy height="32px" src="xxx"/>](/)'
blog/_config.stellar.yml
sidebar:
menu:
post: '[btn.blog](/)'
wiki: '[btn.wiki](/wiki/)'
notes: '[笔记](/notes/)'
more: '[更多](/more/)'

侧边栏宽度有限,如何在不影响观感的情况下设置更多的主导航栏按钮呢?建议设置一个「更多」按钮,然后在「更多」页面的侧边栏放上列表组件。

Search(搜索)

1.17.1 版本后开始支持,无需安装插件,可直接开启。

blog/_config.stellar.yml
# 文章搜索
search:
service: local_search # local_search, todo...
local_search: # 在 front-matter 中设置 indexing:false 来避免被搜索索引
field: all # post, page, all
path: /search.json # 搜索文件存放位置
content: true # 是否搜索内容
codeblock: true # 是否搜索代码块(需要content: true)

请提交PR…

_config.stellar.yml 中设置搜索选项并配置你想在侧边栏中显示的位置

然后在 widgets.yml 文件中配置侧边栏搜索组件

blog/source/_data/widgets.yml
search:
layout: search
filter: auto # auto or '/path'
placeholder: 文章搜索 # 搜索框处显示的文字

search_blog:
layout: search
filter: /blog/ # or /posts/ ...
placeholder: 文章搜索

search_docs:
layout: search
filter: /wiki/
placeholder: 文档搜索

您可以设置 filter 按地址过滤搜索结果,默认 auto 是智能选择,规则如下:

  • layout: wiki:只在 /wiki/当前项目 中搜索
  • 其它:站内搜索

你可以在某些页面中通过覆盖 search 组件的 filter 参数来定制化搜索范围,例如:

sidebar:
- toc
- layout: search
override: search
filter: /path/to/some

如果想始终进行不加过滤的站内搜索,那么设置为 filter: '' 即可。

Footer(页脚)

blog/_config.stellar.yml
footer:
social:
github:
icon: '<img src="/assets/placeholder/social/08a41b181ce68.svg"/>'
url: https://
music:
icon: '<img src="/assets/placeholder/social/3845874.svg"/>'
url: https://
unsplash:
icon: '<img src="/assets/placeholder/social/3616429.svg"/>'
url: https://
comments:
icon: '<img src="/assets/placeholder/social/942ebbf1a4b91.svg"/>'
url: https://

自定义组件

Stellar 支持丰富的自定义小组件,详见这篇文档: