Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
21 changes: 20 additions & 1 deletion docs/zh/reference/default-theme-last-updated.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,26 @@
最近一条内容的更新时间会显示在页面右下角。要启用它,请将 `lastUpdated` 选项添加到配置中。

::: tip
你必须提交 markdown 文件才能看到最后更新时间。
VitePress 通过每个文件最近一次 Git 提交的时间戳显示"最后更新"时间,因此你必须提交 markdown 文件才能看到最后更新时间。

具体实现上,VitePress 会对每个文件执行`git log -1 --pretty="%ai"`命令以获取时间戳。若所有页面显示相同的更新时间,可能是由于浅克隆(常见于 CI 环境)导致 Git 历史记录受限所致。

在 **GitHub Actions** 中修复此问题,请在工作流中添加以下配置:

```yaml{4}
- name: Checkout
uses: actions/checkout@v4
with:
fetch-depth: 0
```

其他 CI/CD 平台也有类似设置。

若上述选项不可用,可在 `package.json` 中的 `docs:build` 命令后手动添加获取操作:

```json
"docs:build": "git fetch --unshallow && vitepress build docs"
```
:::

## 全局配置 {#site-level-config}
Expand Down