Colophon

設計思想

Siderは、ゲームやソフトウェア、開発の記録、気に入ったものをまとめる個人サイトです。読みやすい文字と整列、適切な余白で、作ったものと書いたものが自然に並ぶ場所を目指しています。

デザイン

無彩色、細い境界線、控えめな強調を基本にしています。ツールや制作物のブランドに含まれる色は、そのまま残します。

LightとDarkは同じCSS変数を使います。初期表示はOS設定に従い、保存した選択があれば優先します。動きは短く抑え、Reduced Motionとキーボードのフォーカス表示に対応しています。

書体

Geist
欧文とインターフェースの文字。
Noto Sans JP
短いラベルから長い本文まで、日本語の文字。
Geist Mono
コード、技術的なラベル、小さな補助情報。

公開サイトはAstroのFonts APIからフォントアセットを配信し、エディタは同じ書体のFontsourceパッケージを使用しています。

技術構成

フレームワーク
Astro静的HTMLの生成
言語
TypeScriptデータとブラウザ操作の型付け
スタイル
Vanilla CSSスコープ付きスタイルと共通のCSS変数
コンテンツ
Content CollectionsMarkdownとFrontmatterの検証
アイコン
LucideUIのSVGアイコン
コード
Shikiシンタックスハイライト
画像
Astro Assets / Sharpビルド時の画像最適化
記事OGP
Satori / Sharpビルド時のOGP画像生成

公開の仕組み

  1. GitHub
  2. Workers Builds
  3. Static Assets

記事は1記事1フォルダで、Markdownと必要な画像をまとめます。Frontmatterにタイトル、日付、公開状態、任意のカテゴリーを持ち、公開済みの記事だけを一覧・RSS・記事ページへ含めます。

mainへのPushでWorkers Buildsが動き、生成したHTMLとアセットをCloudflare Workers Static Assetsが配信します。公開サイトにリクエストごとのページ生成やデータベースは不要です。記事OGPはビルド時に生成し、通常ページには完成済みの共通PNGを使います。

管理画面はCloudflare Accessで保護した独立Workerです。CodeMirrorでのMarkdown編集、ローカル下書き復元、明示的なGitHub保存を行い、公開サイトとは別にデプロイします。日本語・英語ページはレイアウトとSEOの規則を共用します。

Credits