コンテンツへスキップ
Fumadocs

ページ履歴

ドキュメントページにコントリビューターと Git 履歴を表示します。

これはコミュニティがメンテナンスしているインテグレーションです。

fumadocs-page-history は、ドキュメントページにコントリビューターと折りたたみ可能な変更履歴を表示します。ビルド時に Git 履歴を読み取り、Fumadocs MDX と Sätteri に対応しています。

ライブデモを見る

セットアップ

Node.js 24.14 以降と、16.x 系の Fumadocs 16.17 以降が必要です。

パッケージのインストール

npm install fumadocs-page-history

スタイルをインポートする

Fumadocs のスタイルの後に、次の import 文を追加してください。

app/global.css
@import 'fumadocs-page-history/css/preset.css';

プラグインを登録する

docs コレクションに remarkGitChangelog を追加し、repoURL にリポジトリの URL を設定します。既存のスキーマやコンパイラのオプションは変更せずにそのまま残してください。

source.config.ts
import { applyMdxPreset, defineDocs } from 'fumadocs-mdx/config';
import { remarkGitChangelog } from 'fumadocs-page-history/remark';

export const docs = defineDocs({
  dir: 'content/docs',
  docs: {
    mdxOptions: applyMdxPreset({
      remarkPlugins: [[remarkGitChangelog, { repoURL: 'https://github.com/owner/repository' }]],
    }),
  },
});

これで、このコレクション内の各ドキュメントの末尾に、コントリビューターとページ履歴が表示されるようになります。ページテンプレートを変更する必要はありません。

Git の履歴

ビルド環境には Git と、リポジトリの完全な履歴が必要です。GitHub Actions では fetch-depth: 0 を指定してください。

- uses: actions/checkout@v6
  with:
    fetch-depth: 0
  • 新しいファイルの履歴を含めるには、ビルド前にコミットしてください。
  • 新しくコミットした後は再ビルドしてください。開発中に Git 上でのみ発生した変更を反映させるには、サーバーを再起動してください。

設定

コントリビューターと履歴の表示はそれぞれ個別に切り替えられます。また、翻訳をカスタマイズしたり、必要に応じて GitHub のアバターとプロフィールリンクを取得したりすることもできます。

How is this guide?

最終更新日