portfolio-detail — Atelier chinois / Portfolio en style lishu (avec pages de détail secondaires)
Description en une phrase
Ligne de texte horizontale + vignette apparaissant au survol à droite + grands caractères artistiques Alimama DaoLiTi + noir et blanc pur + thème light/dark + page de détail par hash routing + double vue liste / album.
Différence avec les autres skills de portfolio
| skill | mode principal | pour qui |
|---|---|---|
portfolio-gen | Canvas infini avec glisser-déposer + tuiles | Photographes / graphistes pour montrer des échantillons |
portfolio-museum-gen | Carrousel héro + grandes cartes + cascade + page de détail (ambiance commissaire d'exposition) | Artistes vidéo / image / installation |
industrial-archive-gen | Couverture à feuilleter à cadre noir + barre latérale d'archive + industriel nordique | Produits physiques / objets / matériel |
lishu-portfolio-gen | Lignes de texte horizontales + vignette au survol à droite + grands caractères lishu + sobriété chinoise | Reliure / typographie / exposition / nature morte / herbes médicinales chinoises / thé / poterie / bois / papier / encens — tout ce qui nécessite une élégance sobre et classique |
Si le projet de l'utilisateur concerne : « livre / typographie / exposition / nature morte / herbes médicinales chinoises / thé / poterie / bois / papier / encens » et nécessite une retenue et une élégance classique — utilisez ce skill.
Quand déclencher
L'utilisateur dit :
- "Fais-moi un portfolio de style chinois / oriental / classique"
- "Fais-moi un site de style lishu / page d'accueil d'atelier"
- "Fais-moi un portfolio style maison blanche" / "Fais-moi un site avec liste horizontale comme Gurgel D'Alfonso"
- "lishu-portfolio-gen ..."
Et fournit :
- Description de l'atelier (obligatoire) : nom, directeur, ville, discipline, titres et histoires de quelques œuvres
- Images des œuvres (optionnel) : URL / téléchargement / chemin. Fonctionne aussi sans (utilise picsum comme placeholder)
Si l'utilisateur ne donne PAS du tout les titres des œuvres → demandez au moins quelles œuvres il souhaite présenter. Si l'utilisateur donne seulement les titres sans les détails → générez vous-même : pour chaque œuvre, une phrase d'accroche + 3 paragraphes de prose + 6-8 lignes de spécifications + 3-6 images picsum + quelques crédits. Le ton doit correspondre au type d'œuvre (livre → reliure / typographie → typographie / objet → nature morte / exposition → visuel d'exposition).
Deux modes de fonctionnement
Mode A · Claude Code / Local (avec système de fichiers)
- Utilisez
Bashpour lister les dossiers,sipspour vérifier les dimensions de chaque image - Emplacement de sortie :
~/Desktop/{slug}-portfolio.html(fichier unique, toutes les images sont en URL) - Si l'utilisateur donne des images locales : copiez-les dans
~/Desktop/{slug}-portfolio-images/et modifiez les src en chemins relatifs
Mode B · GLM / Chat en ligne (sans système de fichiers)
- L'utilisateur glisse un zip, après décompression il voit 4 fichiers
- Ne produisez qu'une seule chaîne HTML complète, encapsulée dans un bloc de code
```html - Si l'utilisateur télécharge des images mais ne donne pas d'URL → utilisez
https://picsum.photos/id/{id}/{w}/{h}comme placeholder (utilisez des ID qui existent) - N'essayez pas d'accéder aux fichiers locaux, ne suggérez pas d'opérations en ligne de commande
Décision : si vous ne pouvez pas Lire et voir les images locales → allez en mode B par défaut.
Répartition des fichiers
| Fichier | Rôle | Comment l'utiliser |
|---|---|---|
reference.html | Référence complète du produit fini — Maison Blanche BAIWU, 6 œuvres | Regardez : le ton des éléments de liste, le ton de la prose, le vocabulaire des spécifications, la densité des champs JSON |
template.html | Structure vide — Même système CSS/JS/routage, 2 exemples + 20 marqueurs SWAP | Modifiez-le pour produire le HTML final |
README.md | Instructions d'utilisation pour l'utilisateur | Le modèle n'a pas besoin de le lire |
SKILL.md | Workflow pour le modèle (ce fichier) | À lire obligatoirement |
Règle essentielle : toutes les modifications se font sur template.html ; apprenez comment écrire (ton, longueur des mots, utilisation des tags) à partir de reference.html, mais ne copiez pas le contenu spécifique.
Étapes de travail
1. Lire les deux HTML
- Lisez d'abord
reference.htmlpour comprendre "à quoi ressemble le produit fini" (en particulier la densité des champs dans le JSONworks-dataet le ton de la prose) - Ensuite, lisez
template.htmlpour trouver les 20 emplacements SWAP
Ne modifiez pas le JS / ne modifiez pas le CSS / ne modifiez pas le système de routage des pages de détail / ne modifiez pas l'importation des polices. Les SWAP se trouvent uniquement dans le texte HTML et les données JSON.
2. Analyser la saisie utilisateur et extraire les informations
Extrayez :
- ATELIER_NAME_ZH — Nom chinois de l'atelier (2-4 caractères idéal, par exemple « 白屋 », « 素园 », « 墨记 », « 青庐 », « 拙轩 »)
- PINYIN — Pinyin (5-6 lettres anglaises, tout en majuscules : BAIWU / SUYUAN / MOJI)
- CHAR — Caractère unique pour le logo (généralement le premier caractère du nom de l'atelier : 白 / 素 / 墨 / 青 / 拙)
- CITY — Ville
- DIRECTOR_ZH / DIRECTOR_EN — Nom du directeur + pinyin
- DISCIPLINE — 3 mots de discipline ("装帧 · 字体 · 静物")
- TAGLINE — Phrase d'accroche d'une ligne (20-40 caractères, style kaïti)
- YEAR_FOUNDED — Année de création (peut être en caractères cycliques : 乙未冬 / 甲辰春)
Pour chaque œuvre, extrayez :
- slug — ID d'URL, en minuscules avec traits d'union (
kong-shan-ji/wu-ming-shu) - title_zh — Titre chinois (2-5 caractères idéal, plus c'est concis, plus c'est élégant)
- title_en — Sous-titre anglais (style entre guillemets :
An Anthology of Empty Mountains) - year — Année ou année cyclique (
甲辰 / 2024/2025/乙巳 / 2025) - tag — Catégorie en haut, entre crochets, par exemple
[ 诗集 · 装帧设计 ]/[ 字体设计 · 中草药图谱 ] - cover — URL de la grande image de la page de détail
- location de la ligne de liste —
Ville, Année · Technique/Spécification(apparaît au survol) - meta — 4 paires clé-valeur (résumé en 4 colonnes de la page de détail)
- lead — Phrase d'ouverture en grands caractères, 30-70 caractères, peut utiliser
<em>mot-clé</em>pour mettre en valeur - prose — 3-4 paragraphes en prose, 80-150 mots chacun
- specs — Tableau de spécifications de 6-10 lignes (format/papier/reliure/typographie/quantité/impression/technique/prix, etc.)
- gallery — 3-6 images, layout au choix parmi :
g-wide/g-half/g-third - credits — 4-7 paires poste/nom
Si l'utilisateur ne donne qu'une phrase / pas d'histoire → générez vous-même : en fonction du titre et du type de l'œuvre, écrivez un lead et une prose qui correspondent au ton de l'œuvre. Référez-vous au ton de reference.html — pas de langage marketing, mais une sensation de « texte mural de musée + carnet d'atelier » (sobre, concret, lent, avec des traces de travail manuel).
3. Lister les œuvres + vérifier les dimensions (Mode A uniquement)
ls -la "{works_path}"
sips -g pixelWidth -g pixelHeight "{works_path}/{file}" 2>/dev/null
Obtenez pour chaque image (filename, w, h, aspect). Privilégiez les images en portrait comme vignettes de liste (conteneur 4:3, le portrait est plus photogénique).
4. Remplacer les 20 SWAP
| SWAP | Emplacement | Contenu |
|---|---|---|
| 1 | <title> | {ATELIER_NAME} {PINYIN} — {DIRECTOR}作品集 / Studio |
| 2 | meta description | Une phrase de description du site |
| 3 | Caractère unique du rideau | Premier caractère du nom de l'atelier (par exemple « 白 ») |
| 4 | Caractère unique dans le SVG du logo | Identique à SWAP-3 |
| 5 | Pinyin dans le SVG du logo | {PINYIN} en majuscules |
| 6 | li de la navigation principale | Habituellement 3 éléments : Œuvres / À propos / Contact |
| 7 | Nom chinois du bloc de marque | {ATELIER_NAME} avec espace entre les caractères (par exemple 白 屋) |
| 8 | Anglais du bloc de marque | {PINYIN} Studio · {CITY} |
| 9 | Tagline | Phrase d'accroche d'une ligne en style kaïti, 20-40 caractères, peut utiliser <br> pour un saut de ligne |
| 10 | Éléments de liste N œuvres | Chaque <a class="item" href="#work/{slug}"> contient num/project-name/en-name/location/photo-thumb |
| 11 | Éléments de galerie N œuvres | Les mêmes N œuvres, grille plus compacte — le slug doit être identique à celui de la liste |
| 12 | Titre À propos | 关 于 {name}<span class="en">About</span> |
| 13 | Paragraphes À propos | 1-3 paragraphes en kaïti (contexte de création / directeur / vision du design), 60-120 mots chacun |
| 14 | Tableau de faits À propos | 4-6 éléments li (Founded/Location/Discipline/Director/Hours) |
| 15 | Titre Contact | 来 信<span class="en">Get in Touch</span> |
| 16 | Paragraphes Contact | 1-2 paragraphes invitant à écrire + promesse de délai de réponse |
| 17 | Tableau de faits Contact | 4-6 éléments (E-mail/Phone/Address/Instagram/公众号) |
| 18 | Crédit tournant | Site by {WHO} (généralement le nom de l'atelier) |
| 19 | Trois blocs de pied de page | © / ICP / lien social |
| 20 | JSON works-data | Données complètes de détails pour N œuvres (essentiel !) |
5. Écrire le JSON works-data (étape la plus cruciale)
Chaque œuvre doit avoir une entrée dans le tableau JSON, le slug doit correspondre exactement au #work/SLUG dans les href des cartes list/gallery.
Champs 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", "陈漱石(杭州·订书坊)"]
]
}
Erreurs JSON courantes ⚠️ :
- Dans la prose chinoise, utilisez des guillemets → il faut utiliser les guillemets chinois pleine largeur
「...」ou"..."(U+201C / U+201D), ne pas utiliser le guillemet ASCII"(cela briserait le JSON) - Ne faites pas de vrais sauts de ligne dans les chaînes JSON ; pour changer de paragraphe, ajoutez un élément de plus dans le tableau prose
- Les balises
<em>mot</em>dans le lead sont écrites directement en HTML — elles sont rendues avec innerHTML - Le
layoutde la galerie doit être choisi parmi trois valeurs :g-wide(pleine largeur) /g-half(moitié) /g-third(tiers)
6. Choix des sources d'images
- Placeholder picsum : utilisez la forme
id/Xplutôt queseed/X(plus stable). IDs connus pour être bons : 0, 20, 40, 51, 64, 76, 88, 91, 96, 119, 121, 130, 143, 145, 158, 164, 165, 175, 177, 180, 187, 195, 200 - Pour la cover et la galerie d'une même œuvre, utilisez des IDs adjacents pour créer une tonalité de couleur cohérente
- N'utilisez pas le paramètre
?grayscale(l'utilisateur souhaite des images en couleur)
7. Inspirations pour les noms d'ateliers chinois (si l'utilisateur n'en donne pas)
Si l'utilisateur vous demande d'"en inventer un" → choisissez 2 caractères + style antique :
- Noms d'objets : 白屋 / 素园 / 墨记 / 青庐 / 拙轩 / 听雨 / 一勺 / 半亩
- Noms de lignes de caractères : 素白 / 子衿 / 砚池 / 半山 / 寻常 / 浮云
- Évitez les mots fonctionnels comme "工作室 / 设计 / Studio", le nom doit être poétique en lui-même
8. Support vidéo
Si la cover d'une œuvre est en .mp4 / .webm / .mov, la page de détail utilisera automatiquement <video autoplay muted loop> au lieu de <img>. Le modèle n'a qu'à donner le chemin de la vidéo dans l'URL de la cover.
9. Rapport
Mode A : Rapport en une phrase.
Généré ~/Desktop/baiwu-portfolio.html — 6 œuvres, survolez les lignes pour voir la vignette, cliquez pour entrer dans la page de détail. Light/Dark en bas à gauche, liste/album en haut au centre.
Mode B : Donnez directement le bloc de code HTML complet + une ligne d'explication.
Sauvegardez ce qui précède en tant que
index.htmlet double-cliquez. Déplacez la souris sur un nom d'œuvre pour voir la vignette apparaître à droite, cliquez pour accéder à la page de détail. Pour changer les images, remplacez l'URL picsum par votre adresse d'image.
Éléments à conserver impérativement (ne pas modifier)
- Importation de la police :
@font-facecharge l'URL woff2 de la police Alimama DaoLiTi (ne changez pas la source de la police) - Système de variables CSS : double thème light/dark
- Tout le JS : bascule de thème, bascule de mode de vue, interaction de survol des lignes, crédit tournant, routage par hash des pages de détail
applyRoute(),renderDetail() - Le nœud
<script id="works-data">doit être conservé - Le
<main id="detail-root">doit être conservé (point de montage de la page de détail) - Le système d'état
body[data-view="home/detail"]etbody[data-mode="list/gallery"] - Les cinq éléments positionnés de manière fixe : #logo / #main-menu / .theme-toggle / #project-view / #svp-credit
Aide-mémoire des erreurs courantes
- slug non correspondant : élément de liste
#work/kong-shan-ji↔ élément de galerie#work/kong-shan-ji↔ JSON"slug": "kong-shan-ji"— les trois doivent être strictement identiques - Guillemets JSON : dans le contenu chinois, utilisez toujours les guillemets chinois pleine largeur «」ou
"...", pas le guillemet ASCII" - Trop d'images dans la galerie : maximum 6 images par œuvre, au-delà la mise en page sera perturbée
- Prose trop longue : 80-150 mots par paragraphe, au-delà de 200 mots l'expérience de lecture se dégrade
- Liste / Galerie non synchronisées : elles doivent contenir le même ensemble d'œuvres (correspondance biunivoque)
- seed picsum : utilisez
id/Xet nonseed/X, pour éviter qu'un ID aléatoire ne corresponde à une image supprimée - Moins de 3 œuvres : possible, 2 œuvres minimum pour que ça fonctionne
- Plus de 8 œuvres : il est conseillé de les répartir en deux groupes, trop de lignes de liste allongent la page
- Premier caractère en retrait : dans la page de détail,
.detail__prose p:first-of-type::first-letterutilise la police DaoLiTi — le premier paragraphe doit commencer par du chinois (pas par<em>ou de l'anglais) - Suppression de la couleur picsum : les images doivent rester en couleur, n'ajoutez pas
filter: grayscale()dans le CSS