Cartão de saudação interativo
Faça um cartão com o qual alguém vai querer brincar: a imagem deles na frente de um cartão dobrado que balança na página, capta uma luz móvel em seu foil ou tinta, abre com um toque para a mensagem em caligrafia e vira para mostrar seu verso. Uma construção rápida transforma uma imagem e algumas configurações em um arquivo HTML com tudo dentro (imagem, fonte, renderizador), que abre direto de um arquivo, funciona offline e vai para qualquer servidor web sem alterações.
O que este skill contém:
scripts/make_card.pyconstrói a página a partir dos dados do cartão (JSON). Ele verifica os dados e explica qualquer erro antes de escrever algo.scripts/grid.pydesenha uma grade de pixels rotulada sobre a imagem, cortada exatamente como o cartão corta, para ler posições dela (necessário apenas para efeitos vivos e seleções de cor).scripts/foil_preview.pymostra exatamente o que se torna foil, em magenta, para que você possa ajustar o foil antes da construção (precisa de numpy).scripts/snapshot.mjs(opcional, precisa de Node e Playwright) tira screenshots da frente, do interior e do verso, e com--livemostra o que se move em um cartão vivo e o que cada toque faz.references/options.mdlista todas as configurações.references/living-cards.mdexplica como fazer um cartão ganhar vida. Leia-os quando precisar, não antes.
Como fazer um cartão
1. Obter a imagem e a mensagem
As duas coisas necessárias da pessoa são a imagem para a frente e o que escrever dentro. Se algum estiver faltando, peça, ou ofereça-se para escrever a mensagem (pergunte para quem é e de quem é). Todo o resto tem um padrão sensato, então não faça a pessoa responder a um questionário; escolha bem e mencione as escolhas que fez para que ela possa alterá-las.
Pegue a mensagem como foi dada. Não polir as palavras, a menos que peçam, mas coloque quebras de linha onde um cartão escrito à mão teria (uma saudação em sua própria linha, a despedida no final); uma linha muito longa para a folha quebra sozinha, com cerca de 20 letras. Até cerca de 60 palavras é lido grande e confortável; cartas mais longas são escritas menores, e além do que cabe, o final é cortado, então sugira encurtar uma muito longa.
Várias imagens geram vários cartões em uma página, lidados um após o outro com uma dock para alternar entre eles. Isso é adequado para um conjunto de cartões, ou um cartão em alguns designs para escolher.
2. Olhar a imagem e escolher o acabamento
O acabamento decide como a frente capta a luz. Olhe a imagem antes de escolher:
| A imagem | Acabamento | Notas |
|---|---|---|
| Uma pintura com textura de pincel (óleo, guache, acrílico, aquarela espessa) | paint | As próprias pinceladas se destacam e brilham sob a luz. Se tiver tinta dourada, faça-a brilhar também: foil.on: "colour" com o dourado selecionado. |
| Uma ilustração, arte linear, lettering ou design plano, especialmente em papel liso | foil | on: "details" carimba as linhas e detalhes escuros em foil; "colour" carimba uma cor que você escolhe (letras douradas, por exemplo); "darks" carimba as formas mais escuras (silhuetas). |
| Uma foto | print | Impresso em cartão fosco. Uma border fina de foil emoldura bem. Foil em detalhes de uma foto tende a parecer ruidoso. |
Cores de foil: gold (clássico, quente), silver (inverno, casamentos, paletas frias), rose (romance), copper (outono, rústico), pink (brincalhão), holo (holográfico, aniversários). Combine com a paleta da imagem e a ocasião.
Verifique o foil com foil_preview.py antes da construção (depois que os dados do cartão estiverem escritos, etapa 5). O que você pretendia que fosse foil deve sair sólido, e nada mais deve ser capturado. Duas coisas frequentemente precisam disso:
- O que você quer em foil compartilha sua cor ou escuridão com coisas que não quer, por exemplo, letras douradas acima de flores com centros dourados. Mantenha o foil em uma caixa ao redor com
foil.area. - O dourado padrão é claro e clássico. Arte desenhada em um dourado muito mais escuro pode ter sua própria tinta, então o foil corresponde.
A seção Foil de references/options.md tem as tintas, o que amount faz em cada modo e area.
Papel (interior, verso e bordas): white, cream, blush, sage, sky, midnight ou qualquer #rrggbb. Se a imagem foi desenhada em papel liso, o cartão pega esse papel por padrão, o que geralmente fica melhor.
O cartão é cortado do centro da imagem para sua forma: portrait (5:7, o padrão), square, landscape (7:5) ou original (a forma da própria imagem, dentro dos limites). Use landscape para imagens largas. Se o assunto estiver perto de uma borda, execute grid.py para ver o que o corte mantém.
3. Adicionar efeitos para a ocasião (opcional)
Estes não precisam de posições, então adicione-os livremente quando combinarem com o cartão:
snow: flocos caem sobre a frente (inverno, Natal)hearts: pequenos corações pintados flutuam para fora da imagem de vez em quando (amor, Dia dos Namorados, Dia das Mães, casamentos)fireflies: luzes suaves vagam pela parte inferior (noites de verão, cenas sonhadoras)shootingStars: uma estrela cruza o topo de vez em quando (céus noturnos)sparkle: pontos do foil captam a luz e cintilam (qualquer cartão com foil)
Um ou dois efeitos são suficientes; mais fica confuso.
4. Dar vida a ele (opcional, e a melhor parte)
Um cartão pode fazer muito mais: a lanterna na imagem brilha e tremula e acende quando tocada, o sol lança raios, o rabo de um gato balança e corações sobem dele quando acariciado, galhos balançam e deixam cair sua neve, cachecóis tremulam na brisa do ponteiro. Isso precisa de posições na imagem, que você lê da grade de grid.py. Leia references/living-cards.md e siga-o.
Faça isso quando a pessoa pedir que o cartão seja vivo, animado ou interativo, ou quando a imagem tiver luzes óbvias (velas, lanternas, sol, lua, janelas iluminadas) ou personagens. Leva um tempo, então para um cartão rápido, ofereça como um próximo passo.
5. Escrever os dados do cartão
Salve como JSON ao lado da imagem. Um cartão:
{
"title": "Feliz aniversário, Ellie",
"image": "ellie-birthday.jpg",
"alt": "Uma aquarela de uma raposa em um prado de papoulas.",
"name": "Raposa e Papoulas",
"finish": "foil",
"foil": { "colour": "rose", "on": "details", "amount": 0.12 },
"paper": "cream",
"message": "Querida Ellie,\nFeliz aniversário para minha pessoa favorita.\nUm brinde ao seu melhor ano ainda!\nCom amor, Nora",
"signature": ["Feito com amor por", "Nora"],
"effects": { "hearts": true, "sparkle": true }
}
alt descreve a frente para leitores de tela; sempre escreva um. name vai no verso como letras pequenas, a menos que back ou signature diga o contrário. Vários cartões vão em "cards": [ {...}, {...} ], com title e page no topo. Todas as configurações estão em references/options.md.
6. Construir
python scripts/make_card.py card.json --check # verifica os dados, imprime o tamanho do cartão em pixels
python scripts/make_card.py card.json -o card.html
Os caminhos no JSON são relativos ao arquivo JSON. Para um cartão rápido, há também um formulário de uma linha:
python scripts/make_card.py --image front.jpg --message "Feliz aniversário!" --finish foil --foil gold -o card.html
Se o script reportar um erro, ele diz o que está errado e como corrigir. Avisos (mensagem faltando, configuração desconhecida, posição fora do cartão) ainda constroem, mas corrija-os.
7. Verificar
Se Node e Playwright estiverem disponíveis, olhe o cartão antes de entregá-lo:
node scripts/snapshot.mjs card.html shots/
node scripts/snapshot.mjs card.html shots/ --live # um cartão que ganha vida: também verifica o que se move
Isso escreve a frente, a frente com a luz sobre ela (front-lit: o foil ou tinta captando a luz), o interior e o verso como PNGs. Olhe para eles: a mensagem é fácil de ler, o foil parece carimbado em vez de pontilhado, a imagem foi cortada onde você esperava? Ajuste e reconstrua; cada rodada é rápida. Sem um navegador, diga claramente que não pôde pré-visualizar (a pré-visualização do foil ainda funciona).
8. Entregar
Dê à pessoa o arquivo HTML e diga como usá-lo:
- Abra em qualquer navegador para ver o cartão. Toque nele (ou pressione O) para abri-lo; arraste para o lado (ou pressione T) para virá-lo.
- Para enviar, coloque online e compartilhe o link: GitHub Pages, Netlify Drop ou qualquer host estático aceita o arquivo como está. Ou envie o próprio arquivo; funciona offline.
- Tem um a dois megabytes, quase tudo a imagem.
Mencione o que você escolheu (acabamento, foil, papel, efeitos) em uma frase, para que possam pedir alterações.
Bom saber
- Fotos de celular são viradas para a orientação correta e imagens grandes são reduzidas (com Pillow). Áreas transparentes tornam-se brancas. Fotos HEIC precisam ser convertidas para JPEG primeiro, a menos que o Pillow possa lê-las.
- A caligrafia é Caveat, incorporada na página. Cobre latim, latim estendido e cirílico; outros scripts (vietnamita, grego, CJK) recaem para a fonte de caligrafia do dispositivo.
- Sem WebGL, a página ainda mostra a imagem e a mensagem, planas.
- A página é temática clara por design: o cartão fica sobre branco com sombras suaves.
- Para mudar como os cartões parecem ou se comportam além dessas configurações, o código-fonte do renderizador está no repositório GitHub do skill (
renderer/), e reconstruí-lo substituiassets/greeting-card.js.