侧边栏配置
Logo
左上角的 logo 和标题取自站点根目录的配置文件:
blog/_config.yml设置鼠标指上 subtitle
后翻转另一行字(您可以将鼠标移至左上角的Stellar查看效果)
blog/_config.yml如果您想用一个图片作为 logo,可以直接在主题配置文件 sidebar.logo.title 中设置:
blog/_config.stellar.ymlsidebar: logo: title: '[<img no-lazy height="32px" src="xxx"/>](/)'
|
Navbar(主导航栏)
blog/_config.stellar.ymlsidebar: 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: field: all path: /search.json content: true codeblock: true
|
在 _config.stellar.yml
中设置搜索选项并配置你想在侧边栏中显示的位置。
然后在 widgets.yml
文件中配置侧边栏搜索组件
blog/source/_data/widgets.ymlsearch: layout: search filter: auto placeholder: 文章搜索
search_blog: layout: search filter: /blog/ 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: ''
即可。
blog/_config.stellar.ymlfooter: 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 支持丰富的自定义小组件,详见这篇文档: