プロフィール画像を設定する
プロフィール画像は profile.avatar.url フィールドです。Takuhon は JSON を手で編集
せずにこれを埋める方法を 2 つ用意しています:画像をアップロードするか、
Gravatar を使うか。どちらも最終的に同じ場所 — profile.avatar.url の URL — に
たどり着くので、画像をどうホストしたいかで選んでください。
方法 1 — 画像をアップロードする
Section titled “方法 1 — 画像をアップロードする”admin エディタのアバターフィールドには Upload image ボタンがあります。ファイルを
選ぶと検証され、メタデータが除去され、保存され、生成された公開 URL が
profile.avatar.url に書き込まれます。
対応形式 は JPEG・PNG・WebP・GIF です。種別はファイル名や Content-Type では
なくバイト列から判定されるため、ラベルを偽ったファイルは拒否されます。
上限:
| 上限 | 値 |
|---|---|
| 最大ファイルサイズ | 5 MB |
| 最大寸法 | 4096 × 4096 px |
| 最大アニメーションフレーム数 | 100 |
保存前に Takuhon は 埋め込みメタデータを除去 します — EXIF・IPTC・XMP・カラー プロファイル — ので、位置情報やカメラの詳細がアバターに同梱されることはありません。 ピクセルデータは変更されません。
ファイルの保存先はアダプタによって異なります:
| アダプタ | 保存先 | 配信 |
|---|---|---|
CLI(ローカル takuhon admin) | takuhon.json と並ぶ assets/ ディレクトリ | GET /assets/* |
| Cloudflare | R2 バケット | GET /assets/*(長期キャッシュ) |
| 静的エクスポート | — | アップロード不可 |
方法 2 — Gravatar を使う
Section titled “方法 2 — Gravatar を使う”すでに Gravatar を持っているなら、admin エディタが email
アドレスからアバター URL を生成できます。Use Gravatar を選び、email を入力すると、
Takuhon が生成した URL を profile.avatar.url に書き込みます。
email は保存されません。URL を組み立てるためにブラウザ内でハッシュ化され、入力欄は
クリアされます — 保存されるのは生成された https://gravatar.com/avatar/… URL だけ
です。
URL は @takuhon/core の gravatarUrl ヘルパが組み立て、trim して小文字化した email
を SHA-256 でハッシュ化します。任意でピクセル size と、Gravatar が無い email 向けの
default image(identicon や mp などの Gravatar キーワード・リテラル 404・
画像 URL)も指定できます。
どちらの方法でも、profile.avatar.url が期待どおりを指しているか確認してください —
アップロードなら /assets/… URL、Gravatar なら https://gravatar.com/avatar/… URL —
そしてプロフィールページに新しい画像が表示されることを確認します。
アバターフィールドと制約は スキーマリファレンス を参照してください。