更新日志

查看 Lotus releases，了解有哪些变更、修复，以及升级是否会影响你的文档站点。

0.3.0

2026-07-19

新增

• 为 h2、h3 和 h4 添加 SSR heading anchors。
• 为自定义页面添加基于 Shiki highlight 的 CodeBlock export。
• 为自定义页面添加 Prose export。
• 为 docs 页面 metadata 添加 Markdown alternate links。
• 添加自动生成的 /llms.txt endpoint，用于 AI-readable docs discovery。
• 为 info、success、warning 和 danger 添加语义化 status color tokens。

变更

• 将 @prosefly/astro-components 更新到 0.2.1。
• 将 SiteHeader 重构为独立 site header。

修复

• 修复 headings 内 prose links 的样式。
• 改进移动端 heading anchor 样式。
• 修复宽屏下 docs content width，避免 page actions 与 table of contents 重叠。

0.2.0

2026-07-18

新增

• 添加繁体中文、日文、韩文、法文、德文、西班牙文、巴西葡萄牙文、意大利文、 俄文和阿拉伯文的内置 UI translations。
• 为阿拉伯语、波斯语、希伯来语、乌尔都语等常见 RTL locale 添加方向推断。
• 为 header、dropdowns、mobile docs menu、sidebar、table of contents、 page actions 和 previous/next page navigation 添加 RTL-aware 行为。
• 添加 sidebar diagnostics，用于检测 missing entries、empty autogenerated directories、 duplicate sections 和 duplicate page ownership。

变更

• 增强 sidebar generation，支持 autogenerate.structure、autogenerate.depth 和 autogenerate.exclude。
• 将 sidebar generation 拆分为 resolver、autogenerate、index 和 diagnostics 模块。
• 简化 docs homepage routing：现在由 docsBase 控制文档渲染位置，设置 docsBase: '/docs' 时，/ 可以留给自定义首页。
• 移除单独的 homepage config option。
• 移除 source.contentRoot；edit links 和 contributor source paths 现在直接使用 content entry file path。
• 更新 release workflow，自动生成 GitHub release notes。

修复

• 改进 dropdowns、local search、mobile docs navigation 和 page actions 的 ARIA state、 focus handling 与键盘行为。
• 修复已部署页面中的 page action URLs，避免生成的 assistant links 保留本地开发 origin。
• 改进移动端 Copy page 的 clipboard 处理。
• 为 header logo image 添加 high fetch priority。
• 在 RTL prose content 中保持 code、keyboard 和 sample text 从左到右显示。

0.1.1

2026-07-17

• 修复 package release 中的 Tailwind CSS 问题。

0.1.0

2026-07-17

• 初始发布 @prosefly/astro-theme-lotus。