侧边栏

John Doe 2025-03-03 23:00:01
Categories: Tags:

侧边栏配置主要用于控制左侧目录的标题生成和搜索功能。

1
2
3
4
5
6
7
8
9
10
11
#------------------------------------------------------
# 侧边栏配置
#------------------------------------------------------
sidebar:
# 文章标题使用标题或文件名,如果未定义,默认为 false(使用文件名)
usePostTitle: false
search:
# 如果未定义,默认为 google。设置引擎为
# https://www.baidu.com/s?wd=
# https://www.google.com/search?q=
engine: https://www.google.com/search?q=

目录标题

sidebar.usePostTitle 控制着标题字符的生成来源,默认情况下使用文件名称生成。由于文件系统的特殊字符限制,这可能会导致您无法展示存在特殊字符的标题。

1
2
sidebar:
usePostTitle: false

如果您需要区别于文件名的特殊显示,您可以指定目录名称使用文章标题生成,只需要将 sidebar.usePostTitle 设置为 true。这样目录就能够使用您在 markdown 文件头部声明的 title 属性值。

1
2
sidebar:
usePostTitle: true

搜索功能

本主题的搜索功能,只实现了标题字符的搜索,全文搜索将通过搜索引擎的站内搜索来完成。因此,当按下回车按钮时,界面会将您重定向搜索引擎界面。

默认情况下,侧边栏的站内搜索功能使用谷歌搜索,您也可以设置其他搜索引擎,只需指定 sidebar.search.engine 的搜索前缀,例如 https://www.google.com/search?q=

1
2
3
sidebar:
search:
engine: https://www.google.com/search?q=