From e108e6a20b5010edf587d976f69d1b31e7adb6ce Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=8D=83=E5=9D=82=E7=A5=9E=E5=A5=88=E5=AD=90?= Date: Tue, 7 Oct 2025 13:34:48 +0800 Subject: [PATCH] docs: update Chinese translation for default-theme-last-updated.md --- .../reference/default-theme-last-updated.md | 21 ++++++++++++++++++- 1 file changed, 20 insertions(+), 1 deletion(-) diff --git a/docs/zh/reference/default-theme-last-updated.md b/docs/zh/reference/default-theme-last-updated.md index 6c04a2c6..b2db74cc 100644 --- a/docs/zh/reference/default-theme-last-updated.md +++ b/docs/zh/reference/default-theme-last-updated.md @@ -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}