インタラクティブグリーティングカード は何をしますか?
思わず触りたくなるカードを作りましょう。写真を表面にあしらった折りたたみカードがページ上でゆらめき、箔や絵の具が動く光を反射し、タップで開くと手書きのメッセージが現れ、裏返すと裏面も見えます。短時間のビルドで、写真、フォント、レンダラーをすべて内部に含む 1つのHTMLファイル が生成されるので、ファイルから直接開け、オフラインでも動作し、そのままどんなWebホストにもアップロードできます。
このスキルに含まれるもの:
scripts/make_card.py- カードデータ(JSON)からページをビルドします。データをチェックし、エラーがあれば説明してから書き出します。scripts/grid.py- 画像上にラベル付きピクセルグリッドを描画します。カードのカットラインと正確に一致するので、位置の読み取りに使えます(エフェクトやカラーピッカーにのみ必要)。scripts/foil_preview.py- 箔になる部分をマゼンタで正確にプレビュー表示します。ビルド前に箔の設定を調整できます(numpyが必要)。scripts/snapshot.mjs(オプション、NodeとPlaywrightが必要) - 表面、内部、裏面のスクリーンショットを撮影します。--liveオプションで、動くカードの内容や各タップの動作を確認できます。references/options.md- すべての設定項目を記載しています。references/living-cards.md- カードを生き生きと動かす方法を説明しています。必要なときに読んでください。
カードの作り方
1. 画像とメッセージを入手する
必要なのは、表面に使う画像と、内部に書くメッセージの2つだけです。どちらかが不足している場合は、相手に依頼するか、代わりにメッセージを書くことを提案してください(誰宛で、誰からのメッセージかを尋ねます)。その他の設定にはすべて適切なデフォルト値があるため、相手にアンケートに答えるよう求める必要はありません。適切に選択し、選択した内容を相手に伝えて変更できるようにしましょう。
メッセージは相手が提示したまま使用してください。相手が依頼しない限り、言葉を磨く必要はありません。ただし、手書きカードに適した位置で改行を入れてください(挨拶は独立した行に、結びの言葉は最後に)。行が長すぎると、約20文字で自動的に折り返されます。約60語までが大きく読みやすく、それ以上長いと文字は小さくなり、収まりきらない部分はカットされるため、長すぎるメッセージは短くするよう提案してください。
複数の画像がある場合は、1ページに複数のカードが並び、ドックで切り替えられます。カードのセットや、複数のデザインから選べる1枚のカードに適しています。
2. 画像を確認し、仕上げを選ぶ
仕上げによって、表面の光の反射の仕方が決まります。選択する前に画像を確認してください。
| 画像の種類 | 仕上げ | 備考 |
|---|---|---|
| 筆跡のある絵画(油彩、ガッシュ、アクリル、厚塗り水彩) | paint | 絵の具の筆跡が立体的に浮かび上がり、光の下で輝きます。金の絵の具がある場合は、それも光るようにします: foil.on: "colour" で金色を選択。 |
| イラスト、線画、レタリング、フラットデザイン(特に無地の紙) | foil | on: "details" で線や暗いディテールを箔押し。"colour" で選択した1色(例:金のレタリング)を箔押し。"darks" で最も暗い形状(シルエット)を箔押し。 |
| 写真 | print | マットなカードに印刷。薄い箔の border で上品に仕上がります。写真のディテールに箔を施すと、ノイズのように見えることが多いです。 |
箔の色: gold(クラシックで暖かみのある)、silver(冬、結婚式、クールなパレット)、rose(ロマンチック)、copper(秋、素朴な雰囲気)、pink(遊び心)、holo(ホログラフィック、誕生日)。画像のパレットと機会に合わせて選んでください。
ビルドする前に foil_preview.py で箔を確認してください(カードデータを書いた後、ステップ5)。意図した部分だけが箔になり、それ以外に影響がないことを確認します。よくある問題:
- 箔にしたい部分が、したくない部分と色や暗さを共有している場合(例:花の金色の中心の上にある金のレタリング)。
foil.areaで箔を適用する範囲を四角形で囲んで制限します。 - 標準の金は淡くクラシック。もっと濃い金で描かれたアートワークは、独自のインクを持たせることができるため、箔がそれに合います。
references/options.mdのFoilセクションに、インク、各モードでの amount の動作、および area の説明があります。
紙(内部、裏面、端): white、cream、blush、sage、sky、midnight、または任意の #rrggbb。画像が無地の紙に描かれている場合、カードはデフォルトでその紙の色になり、通常最も美しく見えます。
カードは画像の中央から形状に合わせて切り抜かれます: portrait(5:7、デフォルト)、square、landscape(7:5)、original(画像の元の形状、制限あり)。横長の画像には landscape を使用します。被写体が端に近い場合は、grid.py を実行して切り抜き後の範囲を確認してください。
3. 機会に合わせてエフェクトを追加する(オプション)
これらは位置指定が不要なので、カードに合う場合は自由に追加してください:
snow: 表面に雪の結晶が舞い降ります(冬、クリスマス)hearts: 小さなハートが時々画像から浮かび上がります(恋愛、バレンタイン、母の日、結婚式)fireflies: 柔らかな光が下部を漂います(夏の夜、夢のようなシーン)shootingStars: 星が時々上部を横切ります(夜空)sparkle: 箔のポイントが光を捉えてキラキラ輝きます(箔カード全般)
1〜2個のエフェクトで十分です。多すぎるとごちゃごちゃします。
4. カードに命を吹き込む(オプション、最高の部分)
カードはさらに多くのことができます。画像の中のランタンが光り、揺らめき、タップすると輝きが増す。太陽が光線を放つ。猫の尾が揺れ、撫でられるとハートが浮かび上がる。枝が揺れて雪を落とす。マフラーがポインターの風にひらひらと揺れる。これには画像上の位置指定が必要で、grid.py のグリッドから読み取ります。references/living-cards.md を読んで従ってください。
相手がカードにアニメーションやインタラクティブ性を求めている場合、または画像に明らかな光源(ろうそく、ランタン、太陽、月、明かりのついた窓)やキャラクターが含まれている場合にこれを行ってください。時間がかかるため、簡単なカードの場合は、次のステップとして提案するにとどめてください。
5. カードデータを書く
画像の隣にJSONとして保存します。1枚のカードの場合:
{
"title": "Happy birthday, Ellie",
"image": "ellie-birthday.jpg",
"alt": "A watercolour of a fox in a meadow of poppies.",
"name": "Fox and Poppies",
"finish": "foil",
"foil": { "colour": "rose", "on": "details", "amount": 0.12 },
"paper": "cream",
"message": "Dear Ellie,\nHappy birthday to my favourite person.\nHere's to your best year yet!\nLove, Nora",
"signature": ["Made with love by", "Nora"],
"effects": { "hearts": true, "sparkle": true }
}
alt はスクリーンリーダー向けの表面の説明です。必ず記述してください。name は、back や signature で特に指定がない限り、裏面に小さく印刷されます。複数のカードは "cards": [ {...}, {...} ] として、先頭に title と page を置きます。すべての設定は references/options.md にあります。
6. ビルドする
python scripts/make_card.py card.json --check # データをチェックし、カードのピクセルサイズを表示
python scripts/make_card.py card.json -o card.html
JSON内のパスは、JSONファイルからの相対パスです。簡単なカード用の1行形式もあります:
python scripts/make_card.py --image front.jpg --message "Happy birthday!" --finish foil --foil gold -o card.html
スクリプトがエラーを報告した場合、何が問題で、どう修正すればよいかが示されます。警告(メッセージの欠落、不明な設定、カードから外れた位置など)でもビルドは行われますが、修正してください。
7. 確認する
NodeとPlaywrightが利用可能な場合は、カードを引き渡す前に確認してください:
node scripts/snapshot.mjs card.html shots/
node scripts/snapshot.mjs card.html shots/ --live # 動くカードの場合: 何が動くかも確認
これにより、表面、光を当てた表面(front-lit: 箔や絵の具が光を反射)、内部、裏面のPNGが書き出されます。これらを確認してください: メッセージは読みやすいか、箔は斑点状ではなくきれいに押されているか、画像は意図した位置でカットされているか。調整して再ビルドします。各サイクルは短時間です。ブラウザがない場合は、プレビューできなかったことを明確に伝えてください(箔プレビューは引き続き機能します)。
8. 引き渡す
相手にHTMLファイルを渡し、使い方を説明してください:
- 任意のブラウザで開いてカードを表示します。タップする(またはOキーを押す)と開きます。横にドラッグする(またはTキーを押す)と裏返します。
- 送信するには、オンラインに置いてリンクを共有します: GitHub Pages、Netlify Drop、または任意の静的ホストがそのままファイルを受け付けます。またはファイル自体を送信します。オフラインでも動作します。
- ファイルサイズは1〜2メガバイトで、ほとんどは画像です。
選択した内容(仕上げ、箔、紙、エフェクト)を一文で伝え、相手が変更をリクエストできるようにしてください。
参考情報
- スマートフォンの写真は正しい向きに回転され、大きな画像は縮小されます(Pillow使用)。透明部分は白になります。HEIC写真は、Pillowが読み取れない限り、事前にJPEGに変換する必要があります。
- 手書きフォントはCaveatで、ページに埋め込まれています。ラテン文字、拡張ラテン文字、キリル文字に対応。その他の文字(ベトナム語、ギリシャ語、CJK)は、デバイス自身の手書きフォントにフォールバックします。
- WebGLがない場合でも、ページは画像とメッセージをフラットに表示します。
- ページはライトテーマでデザインされています。カードは白い背景に柔らかな影で配置されます。
- これらの設定を超えてカードの見た目や動作を変更するには、レンダラーのソースがスキルのGitHubリポジトリ(
renderer/)にあり、再ビルドするとassets/greeting-card.jsが置き換えられます。