portfolio-detail — Estúdio Chinês / Portfólio em Estilo Lishu (com Páginas de Detalhes)
Característica Principal
Linhas de texto horizontais + hover que revela uma imagem grande à direita + letras artísticas grandes em Alimama DaoLiTi + preto e branco puro + light/dark + páginas de detalhes com hash routing + visualização dupla: lista/álbum.
Diferenças dos Outros Skills de Portfólio
| skill | Modo principal | Para quem é |
|---|---|---|
portfolio-gen | Tela infinita arrastável + tiles | Fotógrafos / designers gráficos para amostras |
portfolio-museum-gen | Hero carrossel + cards grandes + waterfall + páginas de detalhes (curadoria de imagens) | Artistas de vídeo/imagem/instalação |
industrial-archive-gen | Capa flip de moldura preta + barra lateral + arquivo + industrial nórdico | Produtos físicos / utensílios / hardware |
lishu-portfolio-gen | Linhas de texto horizontais + hover mostra thumbnail à direita + letras Lishu grandes + elegância chinesa contida | Encadernação / Tipografia / Artesanato / Estúdios Chineses |
Se o projeto do usuário é sobre 'livros / fontes / exposições / naturezas-mortas / ervas chinesas / chá / cerâmica / madeira / papel / incenso' — use este skill para um estilo contido e elegante.
Quando Acionar
O usuário diz:
- "Crie um portfólio de estilo chinês / oriental / clássico"
- "Crie um site em estilo Lishu / página inicial de estúdio"
- "Crie um portfólio estilo 'Casa Branca' / um site de lista horizontal como Gurgel D'Alfonso"
- "lishu-portfolio-gen ..."
E fornece:
- Descrição do estúdio (obrigatório): nome, diretor, cidade, disciplina, títulos e histórias de algumas obras
- Imagens das obras (opcional): URL / upload / caminho. Funciona sem (usa picsum para placeholder)
Se o usuário não forneceu títulos de obras → pergunte quais obras pelo menos estão sendo exibidas. Se o usuário só deu títulos sem detalhes → escreva você mesmo: para cada obra, gere 1 lead + 3 parágrafos de prosa + 6-8 linhas de especificações + 3-6 imagens picsum + alguns créditos. O tom deve combinar com o tipo de obra (livro → encadernação / fonte → tipografia / objeto → natureza-morta / exposição → visual de exposição).
Dois Modos de Operação
Modo A · Claude Code / Local (com sistema de arquivos)
- Use
Bashpara listar pastas,sipspara verificar largura e altura de cada imagem - Saída:
~/Desktop/{slug}-portfolio.html(arquivo único, todas as imagens via URL) - Se o usuário forneceu imagens locais: copie para
~/Desktop/{slug}-portfolio-images/e altere o src para caminho relativo
Modo B · GLM / Chat online (sem sistema de arquivos)
- Usuário arrasta um zip que, após descompactado, contém 4 arquivos
- Saída: apenas uma string HTML completa, dentro de um bloco de código
```html - Se o usuário enviou imagens mas sem URL → use
https://picsum.photos/id/{id}/{w}/{h}como placeholder (use IDs existentes conhecidos) - Não tente acessar arquivos locais, não sugira comandos de terminal
Julgar: se você não consegue Ler para ver imagens locais → vá para o Modo B.
Divisão de Arquivos
| Arquivo | Função | Como usar |
|---|---|---|
reference.html | Referência completa — Casa Branca BAIWU com 6 obras | Veja: redação dos itens da lista, tom da prosa, vocabulário de specs, densidade dos campos JSON |
template.html | Estrutura vazia — mesmos CSS/JS/sistema de rota, 2 exemplos + 20 marcadores SWAP | Modifique a partir dele para gerar o HTML final |
README.md | Instruções para o usuário final | O modelo não precisa ver |
SKILL.md | Fluxo de trabalho para o modelo (este arquivo) | Leitura obrigatória |
Regra principal: todas as alterações baseadas no template.html; aprenda como escrever (tom, número de palavras, tags) do reference.html, mas não copie conteúdo específico.
Etapas de Trabalho
1. Leia os Dois HTMLs
- Primeiro leia
reference.htmlpara entender "como fica quando completo" (especialmente a densidade dos campos JSON e o tom da prosa) - Depois leia
template.htmlpara encontrar os 20 locais SWAP
Não altere JS / Não altere CSS / Não altere o sistema de roteamento de detalhes / Não altere a importação de fonte. Os SWAPs estão todos no texto HTML e nos dados JSON.
2. Extrair Informações da Entrada do Usuário
Extraia:
- ATELIER_NAME_ZH — Nome chinês do estúdio (2-4 caracteres ideal, por exemplo: '白屋', '素园', '墨记', '青庐', '拙轩')
- PINYIN — Pinyin (5-6 letras maiúsculas: BAIWU / SUYUAN / MOJI)
- CHAR — Caractere para o logotipo (geralmente o primeiro caractere do nome: 白 / 素 / 墨 / 青 / 拙)
- CITY — Cidade
- DIRECTOR_ZH / DIRECTOR_EN — Nome do diretor + pinyin
- DISCIPLINE — 3 palavras de disciplina ("Encadernação · Tipografia · Natureza-Morta")
- TAGLINE — Frase de uma linha (20-40 caracteres, tom de fonte KaiTi)
- YEAR_FOUNDED — Ano de fundação (pode usar Ganzhi: 乙未冬 / 甲辰春)
Para cada obra:
- slug — ID da URL, letras minúsculas e hífens (
kong-shan-ji/wu-ming-shu) - title_zh — Título chinês (2-5 caracteres ideal, quanto mais conciso, melhor)
- title_en — Subtítulo em inglês (estilo:
An Anthology of Empty Mountains) - year — Ano ou ano Ganzhi (
甲辰 / 2024/2025/乙巳 / 2025) - tag — Categoria no topo, entre colchetes, por exemplo
[ 诗集 · 装帧设计 ]/[ 字体设计 · 中草药图谱 ] - cover — URL da imagem grande da página de detalhes
- location na linha da lista —
Cidade, Ano · Técnica/Especificação(aparece ao passar o mouse) - meta — 4 pares chave-valor (resumo de 4 colunas na página de detalhes)
- lead — 30-70 caracteres de abertura em letras grandes, pode usar
<em>palavra-chave</em>para destacar - prose — 3-4 parágrafos de prosa, cada um com 80-150 caracteres
- specs — 6-10 linhas de tabela de especificações (formato/papel/encadernação/fonte/tiragem/impressão/técnica/preço, etc.)
- gallery — 3-6 imagens, layout um de três:
g-wide/g-half/g-third - credits — 4-7 pares de cargo/nome
Se o usuário deu apenas uma frase/sem história → invente você mesmo: com base no título e tipo da obra, escreva lead e prosa que combinem com o tom. Consulte o tom do reference.html — nada de linguagem de marketing, mas sim uma sensação de 'texto de parede de museu + caderno de estúdio' (contido, concreto, lento, com marcas de artesanato).
3. Listar Obras e Verificar Dimensões (apenas Modo A)
ls -la "{works_path}"
sips -g pixelWidth -g pixelHeight "{works_path}/{file}" 2>/dev/null
Obtenha (filename, w, h, aspect) para cada imagem. Dê preferência a imagens verticais como miniatura da lista (contêiner 4:3, imagem vertical fica melhor).
4. Substituir os 20 SWAPs
| SWAP | Local | Conteúdo |
|---|---|---|
| 1 | <title> | {ATELIER_NAME} {PINYIN} — {DIRECTOR}作品集 / Studio |
| 2 | meta description | Uma frase de descrição do site |
| 3 | caractere da cortina | Primeiro caractere do nome do estúdio (ex.: '白') |
| 4 | caractere interno do SVG do logotipo | Igual ao SWAP-3 |
| 5 | pinyin interno do SVG do logotipo | {PINYIN} em maiúsculas |
| 6 | li da navegação principal | Geralmente 3 itens: Obras / Sobre / Contato |
| 7 | nome chinês do bloco de marca | {ATELIER_NAME} com espaços nos caracteres (ex.: 白 屋) |
| 8 | bloco de marca inglês | {PINYIN} Studio · {CITY} |
| 9 | tagline | Frase de uma linha em fonte KaiTi, 20-40 caracteres, pode usar <br> para quebra de linha |
| 10 | N itens da lista | Cada <a class="item" href="#work/{slug}"> contendo num/project-name/en-name/location/photo-thumb |
| 11 | N itens da galeria | As mesmas N obras, em grid mais compacto — slug deve ser igual ao da lista |
| 12 | Título Sobre | 关 于 {name}<span class="en">About</span> |
| 13 | Parágrafos Sobre | 1-3 parágrafos em fonte KaiTi (história de fundo / diretor / visão de design), cada um com 60-120 caracteres |
| 14 | Tabela de fatos Sobre | 4-6 li (Founded/Location/Discipline/Director/Hours) |
| 15 | Título Contato | 来 信<span class="en">Get in Touch</span> |
| 16 | Parágrafos Contato | 1-2 parágrafos convidando o contato e prometendo prazo de resposta |
| 17 | Tabela de fatos Contato | 4-6 itens (E-mail/Phone/Address/Instagram/WeChat Official Account) |
| 18 | crédito rotativo | Site by {WHO} (geralmente o nome do estúdio) |
| 19 | três blocos do rodapé | © / ICP / links sociais |
| 20 | works-data JSON | Dados completos de detalhes das N obras (crucial!) |
5. Escrever o works-data JSON (Passo Mais Crucial)
Cada obra deve ter uma entrada no array JSON, e o slug deve ser exatamente igual ao href dos cards na lista/galeria em #work/SLUG.
Campos JSON:
{
"slug": "kong-shan-ji",
"title_zh": "空山集",
"title_en": "An Anthology of Empty Mountains",
"year": "甲辰 / 2024",
"tag": "[ 诗集 · 装帧设计 ]",
"cover": "https://picsum.photos/id/143/1800/1100",
"meta": [
{"label": "Type / 类型", "value": "诗集装帧"},
{"label": "Year / 年份", "value": "2024"},
{"label": "Edition / 印量", "value": "首印 320 本"},
{"label": "Format / 开本", "value": "130 × 195 毫米"}
],
"lead": "三十六首关于山的诗。我们想做一本——读者翻开后,先听见<em>风声</em>,再读见字的书。",
"prose": [
"段落一:诗稿来源 / 设计语境。80—150 字。",
"段落二:制作中的关键决定 — 字体、纸张、装订选择。",
"段落三:最后呈现 / 留给读者的感受。"
],
"specs": [
["开本 / Format", "130 × 195 毫米"],
["页数 / Pages", "144 页"],
["纸张 / Paper", "本色棉纸 90gsm"],
["装订 / Binding", "线装四目"],
["字体 / Typeface", "老宋(标题)· 楷体(正文)"],
["印刷 / Printing", "单色凸印"],
["印量 / Edition", "首印 320 本"],
["定价 / Price", "¥ 388"]
],
"gallery": [
{"src": "...", "layout": "g-wide", "caption": "封面"},
{"src": "...", "layout": "g-half"},
{"src": "...", "layout": "g-half"},
{"src": "...", "layout": "g-third"},
{"src": "...", "layout": "g-third"},
{"src": "...", "layout": "g-third"}
],
"credits": [
["设计 / Design", "周墨白"],
["手工装订 / Binding", "陈漱石(杭州·订书坊)"]
]
}
Erros comuns no JSON ⚠️:
- Na prosa em chinês, use aspas → must use full-width
「...」ou"..."(U+201C / U+201D), nunca use ASCII"(quebra o JSON) - Não coloque quebras de linha reais dentro de strings JSON; para parágrafos, adicione mais um item no array prose
- A tag
<em>word</em>escreva diretamente a tag HTML no lead — sairá como innerHTML na renderização - O
layoutda galeria deve ser exatamente um dos três:g-wide(ocupa toda a largura) /g-half(metade) /g-third(1/3)
6. Seleção de Fonte de Imagens
- Placeholder picsum: use a forma
id/Xem vez deseed/X(mais estável). IDs bons conhecidos: 0, 20, 40, 51, 64, 76, 88, 91, 96, 119, 121, 130, 143, 145, 158, 164, 165, 175, 177, 180, 187, 195, 200 - Para cover/galeria da mesma obra, use IDs adjacentes para criar um tom de cor consistente
- Não use o parâmetro
?grayscale(o usuário espera imagens coloridas)
7. Inspiração para Nomes de Estúdios Chineses (se o usuário não forneceu)
Se o usuário pedir "invente um nome" → escolha 2 caracteres + tom antigo:
- Categoria de objetos: 白屋 / 素园 / 墨记 / 青庐 / 拙轩 / 听雨 / 一勺 / 半亩
- Categoria de caracteres: 素白 / 子衿 / 砚池 / 半山 / 寻常 / 浮云
- Evite palavras funcionais como "工作室 / 设计 / Studio", deixe o nome ser ele mesmo um poema
8. Suporte a Vídeo
Se a capa da obra for .mp4 / .webm / .mov, a página de detalhes usará automaticamente <video autoplay muted loop> em vez de <img>. Basta fornecer o caminho do vídeo na URL da capa.
9. Relatório
Modo A: Relatório de uma linha.
Gerado ~/Desktop/baiwu-portfolio.html — 6 obras, passe o mouse sobre as linhas para ver thumbnails, clique para entrar na página de detalhes. Light/Dark no canto inferior esquerdo, lista/álbum no centro superior.
Modo B: Dê diretamente o bloco de código HTML completo + uma linha de instrução.
Salve o código acima como
index.htmle abra com duplo clique. Mova o mouse sobre o nome de qualquer obra para ver a thumbnail à direita, clique para ir à página de detalhes. Para trocar as imagens, substitua a URL do picsum pelo endereço da sua imagem.
Obrigatório Manter (não altere)
- Importação de fonte:
@font-facecarregando a URL woff2 da Alimama DaoLiTi (não troque a fonte) - Sistema de variáveis CSS: temas claro e escuro
- Todo o JS: alternância de tema, alternância de modo de visualização, interação de hover na linha, crédito rotativo, roteamento hash de detalhes
applyRoute(),renderDetail() - Nó
<script id="works-data">deve ser mantido <main id="detail-root">deve ser mantido (ponto de montagem da página de detalhes)- Sistema de estado
body[data-view="home/detail"]ebody[data-mode="list/gallery"] - Cinco elementos de posicionamento fixo: #logo / #main-menu / .theme-toggle / #project-view / #svp-credit
Verificação Rápida de Erros Comuns
- Slug incompatível: item da lista
#work/kong-shan-ji↔ item da galeria#work/kong-shan-ji↔ JSON"slug": "kong-shan-ji"— os três devem ser exatamente iguais - Aspas no JSON: no conteúdo em chinês, use aspas full-width 「」 ou
"...", não ASCII" - Galeria com muitos itens: no máximo 6 imagens por obra; mais que isso, a quebra de linha fica confusa
- Prosa muito longa: cada parágrafo entre 80-150 caracteres; acima de 200, a experiência de leitura cai
- Lista / galeria dessincronizadas: devem conter exatamente o mesmo conjunto de obras (um a um)
- Picsum seed: use
id/X, nãoseed/X, para evitar IDs aleatórios que podem ser de imagens deletadas - Menos de 3 obras: pode, mínimo de 2 já funciona
- Mais de 8 obras: sugira dividir em dois lotes; muitas linhas na lista deixam a página longa
- Primeira letra em destaque: na página de detalhes,
.detail__prose p:first-of-type::first-letterusa a fonte DaoLiTi — o primeiro parágrafo deve começar com texto chinês (não com<em>ou inglês) - Remover escala de cinza do picsum: as imagens devem ficar coloridas; não adicione
filter: grayscale()no CSS