# 更新日志

跟踪 Lotus release、用户可见变更和升级说明。

import { Badge, Card, CardGrid } from '@prosefly/astro-components';

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

<CardGrid>
  <Card icon="lucide:tag" title="GitHub Releases" href="https://github.com/prosefly/astro-theme-lotus/releases" external>
    查看已发布 tag、自动生成的 release notes 和 release assets。
  </Card>
  <Card icon="lucide:package" title="npm Package" href="https://www.npmjs.com/package/@prosefly/astro-theme-lotus" external>
    查看已发布 package version 和 package metadata。
  </Card>
</CardGrid>

## [0.3.0](https://github.com/prosefly/astro-theme-lotus/releases/tag/0.3.0)

<Badge variant="subtle" color="neutral">2026-07-19</Badge>

### 新增

- 为 `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](https://github.com/prosefly/astro-theme-lotus/releases/tag/0.2.0)

<Badge variant="subtle" color="neutral">2026-07-18</Badge>

### 新增

- 添加繁体中文、日文、韩文、法文、德文、西班牙文、巴西葡萄牙文、意大利文、
  俄文和阿拉伯文的内置 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](https://github.com/prosefly/astro-theme-lotus/releases/tag/0.1.1)

<Badge variant="subtle" color="neutral">2026-07-17</Badge>

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

## 0.1.0

<Badge variant="subtle" color="neutral">2026-07-17</Badge>

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