Vault Heatmap

frontmatter の日付から Vault のアクティビティをカレンダーヒートマップで表示するプラグインです。任意のノートに vault-heatmap フェンスコードブロックを書くと、公開 Vault 全体の集計をビルド時に描画します。

English

概要

```vault-heatmap
weeks: 26
title: 執筆アクティビティ
weekStart: monday
end: 2026-10-31
```

各エントリの frontmatter から日付プロパティを読みます。既定では created（なければ date、published）を作成日、modified（なければ updated）を変更日として数えます。createdFields と modifiedFields でプロパティを変更でき、各リストで最初に見つかった有効な日付を使います。有効な日付がないエントリは集計に含みません。

集計対象は公開一覧に出る public コンテンツだけです。draft、unlisted、公開時刻に達していない scheduled は含まれないため、未公開の活動がヒートマップから分かることはありません。

既定の終了日は壁時計ではなく最新のアクティビティ日です。コンテンツが変わらなければ、同じ HTML が再現されます。

設定

import { defineConfig } from "@riebeckite/core";
import { vaultHeatmap } from "@riebeckite/plugin-vault-heatmap";
 
export default defineConfig({
  // ...
  plugins: [
    vaultHeatmap({
      createdFields: ["created", "date", "published", "posted"],
      modifiedFields: ["modified", "updated"],
    }),
  ],
});

プラグインは vault-heatmap.activity という派生ビューを登録し、マニフェスト生成時にブロックを描画します。ヒートマップのデータ用にクライアント JavaScript は読み込みません。

オプション

ブロックのフィールド

使用例

```vault-heatmap
---
weeks: 26
title: ドキュメントの更新状況
weekStart: monday
---
```

出力とアクセシビリティ

出力は静的な HTML です。キャプション、1 日 1 セルのグリッド、更新数とアクティブ日数の要約、Less から More への凡例を <figure> にまとめます。各セルは title に日付と件数を出し、グリッドには範囲と合計を説明する role="img" ラベルを付けます。

色は既存の --rb-color-success トークンと color-mix で作り、Default、Light、Dark の各テーマに追従します。空の日はページ背景と区別でき、狭い画面ではグリッドを横スクロールできます。

診断

関連資料

• プラグインシステム
• Core API