Starlight项目0.31.0版本发布：文档主题与搜索功能全面升级

Starlight是基于Astro构建的现代化文档主题，它提供了开箱即用的文档站点解决方案。作为一个专注于技术文档的框架，Starlight整合了代码高亮、多语言支持、响应式设计等专业功能，帮助开发者快速搭建高质量的文档网站。

核心功能升级

1. 代码高亮引擎全面更新

本次版本将astro-expressive-code依赖更新至0.40版本，带来了显著的代码高亮改进：

• 升级至Shiki 1.26.1引擎，支持所有最新的Shiki主题和语法高亮语言
• 新增多项配置选项，包括shiki.engine、shiki.bundledLangs等，提供更精细的控制能力
• 可折叠代码区块插件增加了新的样式变体
• 修复了代码块中的颜色对比度问题，提升可读性

这些改进使得技术文档中的代码示例展示更加专业和美观。

2. 搜索功能优化

搜索是文档网站的核心功能之一，0.31.0版本对Pagefind搜索进行了多项改进：

• 将Pagefind最低依赖版本提升至1.3.0
• 重新评估并设置了默认的搜索结果排序选项，基于Starlight自身文档进行了优化
• 新增支持手动配置排序选项的功能
• 修复了日志级别问题，现在Pagefind日志会正确遵循Astro的日志级别设置

这些变化显著提升了文档搜索的相关性和用户体验。

其他重要改进

打印样式支持

新增了专门的打印样式表，优化了文档页面在打印时的显示效果。这一改进对于需要离线阅读或分享文档内容的用户特别有价值。

视觉细节优化

• 使用语义化的CSS变量var(--sl-color-hairline)替代硬编码颜色值，使主题颜色覆盖更加一致
• 修复了代码块中的颜色对比度问题，提升可读性

依赖更新

• 最低支持的Astro版本提升至5.1.5（重大变更）
• 更新了内部依赖@astrojs/sitemap和@astrojs/mdx至最新版本

升级建议

对于使用Starlight的项目，建议按照以下步骤进行升级：

1. 首先确保Astro版本至少为5.1.5
2. 使用npx @astrojs/upgrade命令同时更新Astro和Starlight
3. 检查自定义配置，特别是代码高亮和搜索相关设置

0.31.0版本带来了多项功能增强和问题修复，特别是代码高亮和搜索功能的改进，将显著提升技术文档的质量和用户体验。建议所有Starlight用户考虑升级以获得这些改进。