記事一覧
ファイル構成
保存場所
記事ファイルは docs/posts/
ディレクトリに保存します。
ファイル命名規則
- 形式:
YYYY-MM-DD-<slug>.md
- 例:
2020-07-14-sotsuken-8.md
※ URLでは日付プレフィックスを除去します:
- ファイルパス:
posts/2020-07-14-sotsuken-8.md
- 生成されるURL:
posts/sotsuken-8
フロントマター
各記事ファイルは以下のフロントマター形式で記述します:
yaml
---
title: 記事のタイトル
date: YYYY-MM-DD
categories: ["カテゴリー1", "カテゴリー2"] # オプショナル
tags: ["タグ1", "タグ2"] # オプショナル
---
表示順序
記事は日付(date)の降順で表示されます。
実装の詳細
記事データの処理は docs/.vitepress/theme/posts.data.ts
で行われ、以下の処理が実装されています:
- ファイルの読み込み:
posts/!(index).md
パターンで記事ファイルを読み込み - フロントマターからデータを抽出
- URLから日付プレフィックスを除去
- 日付でソート(新しい記事が上に表示)
共通ヘッダー PostTitle.vue
- 各記事の頭に表示
- title, date, categories, tags を表示