You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
vitepress/docs/ja/reference/default-theme-last-updated.md

1.9 KiB

最終更新日時

ページ右下に、コンテンツの最終更新時刻を表示できます。有効化するには、設定に lastUpdated オプションを追加します。

::: info VitePress は各ファイルの 直近の Git コミットのタイムスタンプ を用いて「最終更新」を表示します。これを有効にするには、対象の Markdown ファイルが Git にコミットされている必要があります。

内部的には、各ファイルに対して git log -1 --pretty="%ai" を実行してタイムスタンプを取得します。すべてのページで同じ更新時刻が表示される場合、CI 環境でよくある)浅いクローンshallow clone により Git の履歴が取得できていない可能性があります。

GitHub Actions での修正例は次のとおりです。

- name: Checkout
  uses: actions/checkout@v5
  with:
    fetch-depth: 0

他の CI/CD プラットフォームでも同様の設定が用意されています。

もしそのようなオプションが使えない場合は、package.json のビルドスクリプトで手動フェッチを前置してください。

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

:::

サイトレベルの設定

export default {
  lastUpdated: true
}

フロントマターでの設定

ページ単位で無効化するには、フロントマターで lastUpdated を指定します。

---
lastUpdated: false
---

より詳しくは デフォルトテーマ: 最終更新 を参照してください。テーマレベルで truthy な値を設定すると、サイトまたはページで明示的に無効化しない限り、この機能は有効になります。