非公開にしたのは本文だけだった

朝から記事を書かせていた。そのうちの1本は、書き上げたあとで公開しなくてよいと思い直した。公開ディレクトリに入ったままだったので、「非公開の方に入れといてください」と頼んだ。

非公開の置き場所は content/_local-unpublished/ になっている。この配下は本番のビルドから外れ、dev では今までどおり読める。移動は数秒で終わった。それで片付いたと思っていた。

移動のあとで、画像の扱いも確認させた。その記事には図が7枚ある。本文が本番に出ないのなら、図はどこにいるのか。

図は public/images/ にあるので本番へ出ている、というのが返ってきた答えだった。 public/ はビルドのときに中身を問わず dist/ へコピーされる。記事の側だけを非公開ディレクトリへ動かしても、画像はそこに置き去りになる。本文は非公開、図は公開。 7枚とも、URLを直接叩けば本番で見られる状態だった。

仕様を変えるまでもなかった

非公開記事の画像は手元で見られれば足りる。本番へ配る理由がない。仕様をそう変えないかと提案した。

調べさせたら、その仕様はすでにあった。 server/middleware/content-images.ts が /_local-unpublished/ 配下の画像を dev の localhost にだけ配信し、本番では 404 を返す。ビルド時のコピー対象からも外れている。

作るものは何もなかった。 public/images/ を画像の置き場所に選んだ時点で、記事をどこへ動かそうと図は本番に出る。 用意されていた仕組みを使っていなかっただけだった。

移す前に、公開記事からの参照を確かめる

非公開に回してあった記事は1本ではなかった。 8本ぶん、18ファイルの画像が public/images/ に取り残されていた。

移す前に、その18枚が公開記事から参照されていないことを機械的に確認させた。同じ図を公開記事が使っていたら、移した瞬間にそちらが壊れる。参照はゼロだった。

移動と同時に、本文の参照を /_local-unpublished/<YYYY-MM>/<YYYY-MM-DD>/<slug>/... の形へ書き換えた。移したあとで公開記事867件の画像参照を全数検証させたところ、破損はゼロだった。

二度目を lint で止める

この種の取り違えは、忘れたころにまたやる。 scripts/lint-md-render.mjs に検査を1本足した。非公開記事が /images/ を参照していたら、その場で exit 1 になる。 .githooks/pre-commit から自動で走るので、コミットの前に必ず引っかかる。

SVGが消えた、と思った

画像を動かした直後に図解のページを開いたら、SVGカードが表示されていなかった。 18枚を移したあとだったので、まずそれを疑った。

確認させると、SVGの実体は無事だった。 part1が126件、part2が108件、どれも欠けていない。応答していなかったのはポート3001の dev サーバーの方で、60秒待っても返ってこないハング状態だった。ポート3000で同じページを開いたら、カードは全部並んでいた。

dev サーバーには朝から手を焼いていた。ポート3000のサーバーは旧セッションの残骸で、メモリを2.8GB使い、初回の応答に47秒かかっていた。図が消えたように見えた原因は、画像の移動ではなく dev サーバーの残骸の側にあった。

並行して書いていた公開記事2本

朝の記事は、GPUの計算資源を独立した投資対象として扱う金融側の動きだった。運用会社6社と組み、第三者の資本5000億ドル超をAIインフラの建設へ向ける枠組みが前日に発表されていた。チップを買ってデータセンターを1件ずつ建てる時代から、計算資源そのものに資本がつく時代への移行として書かせた。

図は5枚作らせて、1枚ずつ自分の目で見た。引っかかったのは3枚目だった。 B200のクラウド価格が2026年に5.30ドルから7.05ドルの幅で動くという図で、その幅が棒グラフで塗られていた。読めば分かる。ただ、ぱっと見て棒の高さが値なのか幅なのかを判断できない。株のローソク足のように上下へ短い横棒を渡して縦線でつなぐ形にしてほしい、と言った。直った図は、上端7.05ドル、下端5.30ドルのI字マーカーになった。これなら一目で幅だと読める。

この計算資源の売り方が残価設定ローンに似ているのではないかと聞いたら、かなり近いという答えが返ってきた。図をもう1枚足して、その節を記事に追加させた。

記事: /nvidia-ai-factory-investable-asset-class

午後は、CloudflareがAIエージェント向けに出した Kitesurf というブラウザを調べさせた。知りたかったのは3つで、費用がかかるのか、手元のChromeと併用するのか、拡張機能でやっていることが要らなくなるのかだった。 Kitesurf は画面を持たないサーバー側のブラウザで、手元のChromeとも拡張機能とも競合しない、というのが答えだった。置き換えの話ではなかった。これも公開記事にした。 1枚目の図で行の折り返しが語の途中に入っていたので、そこだけ直させた。

記事: /cloudflare-kitesurf-agent-browser

学習ゲートの教材の図

前日ぶんの学習ゲートの教材に、図を2点とSVGマニフェストを足した。

今日の学び

「非公開にして」と言ったとき、自分が動かしたのは本文だけだった。本文と画像で置き場所が分かれていると、片方を動かした時点で安心してしまう
仕様を変えようとする前に既存の仕組みを調べさせたら、作るものは何もなかった。middleware は最初から書かれていて、使っていなかっただけだった
同じ間違いを二度しないように、判定を lint に落として pre-commit へ載せた。次は自分が気づく前に止まる
図は自分の目で見る。範囲を棒で塗った図は、読めば分かるが、ぱっと見では読めない
表示が消えたときは、まず自分の直前の変更を疑う。今回はそれが外れて、原因はハングした dev サーバーの方にあった

#Nuxt#静的サイト生成 #非公開記事#lint #SVG