一覧ページに更新日順ソートを追加
一覧ページで作成日順と更新日順を切り替えられるようにした。URL ベースの単純な実装で、既存のページネーション構造を壊さずに併設した。
一覧ページ(トップ・type別・tag別)に「作成日順」「更新日順」を切り替えるプルダウンを追加した。
背景
これまで記事一覧は作成日のみでソートされていた。更新頻度が高い記事(仕様書・リファレンス系)が古い作成日のまま下に埋もれてしまい、「最近手を入れたもの」を見つけにくかった。
実装方針
- URL ベースで状態を保持する(
/ja/updated/でサブパス切り替え) - デフォルトは作成日順(prev/next ナビゲーションと順序を揃えるため)
- 既存の
/ja/page/[n]/構造はそのまま維持 - 更新日順は
/ja/updated/page/[n]/として新規に静的生成
クエリパラメータ(?sort=updated)やクライアント JS によるソートも検討したが、SSG との相性と「ブックマーク可能で特殊でない実装」を優先して URL パスで分けた。生成ページ数は増えるが、ソートは2種類固定で YAGNI 的に受け入れ可能と判断。
変更点
src/lib/entries.tsにtoTimelineByUpdated()を追加(既存のtoTimeline()は作成日順のまま維持)src/components/SortSelect.astroを新規作成。現在パスから作成/更新を判定し、反対側の URL に遷移するsrc/components/EntryCard.astroにrevision > 1の場合のみ「updated YYYY-MM-DD · vN」を表示- トップ・type別・tag別の既存ページに
SortSelectを追加、updated 系ページを新規作成
prev/next は作成日ベースのまま維持した。更新日順にすると「次の古い記事」が直感と乖離するため。
補足
type: page系の size カスタムページ(/ja/size/[size]/)は組み合わせ爆発を避けて対応見送り。普段使いは PageSize 既定で十分- 「更新日」の正体は frontmatter の
updates配列の末尾。Git 履歴は参照しない(スキーマ原則に従い手入力主義) - バージョン表示(
vN)はupdates.length + 1。typo 修正等はupdatesに追記しない運用で、意味のある改訂数が可視化される