log

一覧ページに更新日順ソートを追加

一覧ページで作成日順と更新日順を切り替えられるようにした。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 に追記しない運用で、意味のある改訂数が可視化される