旧サイトは2023年に止まっていました

個人サイトの最後のコンテンツ更新は2023年10月23日でした。翌日にプッシュし、その後はインターネットの片隅で3年間ほこりをかぶっていました。

そこへ戻るのは考古学のようなものでした。Hexo 6.3.0、4つの講義ノート、9枚のJPEGカバー、Bulma + jQuery + Fancybox、リポジトリは約25 MB。Aboutページは今も私を「junior undergraduate」と呼び、CVは2023年版、ナビゲーションには誤字がありました——「Intership-Experience」。まるで間違った名前で呼んでくる旧友に会うようなものでした。

正直に言えば、あれが個人サイトへの最初の試みでした。エンジニアリングは未熟で、デザインもまだ足場を探している段階でした。しかし、ただの笑い話では済まない部分もありました。モバイルではズームが無効化されていたため、文字を大きくするには宝の地図を読むように顔を画面へ近づけるしかありませんでした。アナリティクスのスクリプトはコメントアウトされていましたが、構造はそのまま残っていました。そして何かを変えたいと思うたびに、2023年の自分の心境まで戻らなければなりませんでした。誰にもメンテナンスされないサイトは、少しずつ時代遅れの自己紹介へと変わっていきます。

より軽やかな土台

新しいサイトはAstro 7で構築し、静的出力として配信しています。コンテンツはMarkdownとコンテンツコレクションで管理し、プロジェクト、論文、ブログ記事をそれぞれ別のコレクションに分けています。スタイルは手書きのデザイントークン、フォントはすべてセルフホスト(Google Fontsは不使用)、RSS、サイトマップ、404ページはビルドで生成されます。デプロイはGitHub ActionsからGitHub Pagesへ行います。

ビジュアルの方向性も変わりました。温かみのあるアーカイブ紙、ほぼ黒に近いインク、ほんのりとしたバーントオレンジ。見出しにはNewsreader、本文にはPublic Sans、ラベルにはIBM Plex Mono。3層のガラス調ナビゲーションは、Firefoxでは不透明な面にフォールバックします。1.78秒の「QL signal lock」イントロがあり、これは更新時に再生され、ページ間の移動時には再生されません。情報は何も伝えませんが、このサイトが真剣に扱われていることだけを告げます。

英語がソースです。簡体字中国語と日本語はビルド時に生成され、翻訳されたすべての文字列はリポジトリにキャッシュされるため、CIにAPIキーは不要です。3つの静的サイトがそれぞれ独自のRSSフィードを持ちます。

ローカルのDeepSeekに仕事を任せる

この再構築における実行の大半は、私が一行ずつ入力したものではありません。モデルはエアギャップされたMac mini(Mシリーズチップ、静かに唸っています)上でローカルに動作し、DeepSeek Harnessを通じて、実際に手を動かせるエージェントに接続されています。リポジトリのドキュメントを読み、ファイルを編集し、npm run checkとビルドを実行し、Playwrightを動かして3つのブラウザでスクリーンショットとクリック操作を行い、axeでアクセシビリティを検査し、結果を私に渡します。

私の役割はどちらかといえば編集と承認でした。この内容は事実か、日付や役割は正しいか、このデザインを維持するか、この変更をプッシュできるか。モデルは反復的なチェック(回帰テストにおける90通りのページ・ビューポート・ブラウザの組み合わせなど)を完了させるのが得意で、問題を説明すれば動作するパッチを出してくれます。しかし、私の経験のどの部分が本物なのかは知らないため、事実に関わることはすべて私の署名が必要です。

実用的な利点は持続可能性です。以前はサイトを変更するたびに環境を再構築し、古いコマンドを掘り起こす必要がありました。今ではルールがドキュメントにあり、エージェントがそれに従います。チェックを実行し、失敗したものを修正し、私の承認を待つ。手を抜かず、コーヒーも要りません——飲むかどうかは定かではありませんが。

いくつかの具体的な落とし穴

  • 3言語は3つのページではなく、3つの静的ドキュメントです。言語を切り替えるとページ全体が読み込まれるため、ブラウザは先頭に戻ってしまいます。スクロール位置を記録する小さなスクリプトで解決しました。今では言語を切り替えても、実際に読んでいた位置を保てます。
  • 翻訳にはキャッシュが必要です。英語の原文が変わったときは、新しい文字列だけを翻訳に回し、残りは再利用します。CIはオフラインキャッシュから再ビルドし、文字列が欠けていれば失敗します。ページ上で抜けに気づくより、ずっと良い仕組みです。
  • アクセシビリティは機能として扱うべきです。旧サイトからuser-scalable=noを外したのは始まりにすぎません。フォーカススタイル、スキップリンク、aria-current、コントラスト、モーションの低減は、すべてリグレッションに含めるべきものです。
  • ブログにはカテゴリが必要です。3年分の講義ノートを経て、ブログにlife、course、projectのカテゴリとキーワード検索を追加しました。検索はレンダリング後のテキストを読むため、中国語ページは中国語を、日本語ページは日本語を検索します。

現在

サイトが再び公開されました。2023年の講義ノート4件は「講義ノート」というラベルで残してあり、公開プロジェクト、論文、経歴はCVと照合済みです。旧サイトの画像と2023年のPDFは今もリポジトリのルートにあります。個人サイトへの最初の試みで、技術的には未熟でしたが、捨てるのは難しいものです。

3年前のサイトを復活させるコストは、思ったより低く済みました。コツは、変更方法、検証方法、公開してよいタイミングを書き留め、決して疲れない実行者にそのルールを守らせることです。判断は今も自分が下さなければなりません。