搜索功能配置¶
Zensical 内置的强大搜索功能
Zensical 内置了客户端搜索功能,无需额外配置即可使用。搜索是内置功能,不是插件,因此不需要在 [project.plugins] 中配置。
基本配置¶
搜索功能默认启用。如需调整搜索行为,可以在主题配置中设置:
[project.theme]
features = [
"search.suggest", # 搜索建议
"search.highlight", # 搜索结果高亮
"search.share", # 搜索结果分享
]
搜索排除¶
排除整个页面¶
在页面的 front matter 中添加:
---
search:
exclude: true
---
排除页面中的某个章节¶
使用 data-search-exclude 属性:
## 内部备注 { data-search-exclude }
这部分内容不会被搜索索引。
排除特定内容块¶
<div data-search-exclude>
这部分内容不会被搜索索引。
</div>
中文搜索优化¶
对于中文内容,搜索默认支持中文。如需进一步优化,可以配置搜索分隔符:
[project.theme]
features = [
"search.suggest",
"search.highlight",
"search.share",
]
搜索会自动处理中文内容,无需特殊配置。
注意事项¶
- 搜索是内置功能:不需要
[project.plugins.search]配置 - 客户端搜索:所有搜索在浏览器端完成,无需后端服务
- 自动索引:构建时自动生成搜索索引
- 多语言支持:搜索支持多种语言,包括中文