portfolio-detail — Studio chinois / Portfolio LiShu (avec page de détail secondaire)
En une phrase
Lignes de texte horizontales + grande image apparaissant au survol à droite + grands caractères artistiques Alimama DaoLiTi + noir et blanc pur + thème light/dark + pages de détail par hash + double vue liste/album.
Différences avec les autres skills de portfolio
| skill | Mode principal | Pour qui |
|---|---|---|
portfolio-gen | Toile à glisser infinie + tuiles | Photographes / graphistes présentant des échantillons |
portfolio-museum-gen | Carrousel héro + grandes cartes + cascade + pages de détail (sens de la curation vidéo) | Artistes vidéo / image / installation |
industrial-archive-gen | Pages de couverture à retourner en cadre noir + archive latérale + industriel nordique | Produits physiques / objets / hardware |
lishu-portfolio-gen | Lignes de texte horizontales + miniatures apparaissant à droite au survol + grands caractères LiShu + retenue chinoise | Reliure / typographie / exposition / nature morte / plantes médicinales / thé / poterie / bois / papier / encens – tout ce qui demande une élégance sobre |
Quand déclencher
L'utilisateur dit :
- "Crée un portfolio de style chinois / oriental / classique"
- "Fais un site de style LiShu / une page d'accueil de studio"
- "Fais un portfolio style Maison Blanche" / "Fais un site à liste horizontale comme Gurgel D'Alfonso"
- "lishu-portfolio-gen …"
Et fournit :
- Description du studio (obligatoire) : nom, directeur, ville, discipline, titres et histoires de quelques œuvres
- Images des œuvres (optionnel) : URL / téléversement / chemin. Fonctionne même sans (utilise picsum comme placeholder)
Si l'utilisateur ne donne aucun titre d'œuvre → demander une fois au moins quelles œuvres exposer. Si l'utilisateur ne donne que les titres sans détails → générer soi-même : pour chaque œuvre, 1 phrase d'accroche (lead) + 3 paragraphes de prose + 6 à 8 lignes de specs + 3 à 6 images picsum + quelques crédits. Le ton doit correspondre au type d'œuvre (livre → reliure / caractère → typographie / objet → nature morte / exposition → visuel d'exposition).
Deux modes de fonctionnement
Mode A · Claude Code / local (avec système de fichiers)
- Utiliser
Bashpour lister les dossiers,sipspour vérifier les dimensions de chaque image - Sortie :
~/Desktop/{slug}-portfolio.html(un seul fichier, toutes les images via URL) - Si l'utilisateur fournit des images locales : les copier dans
~/Desktop/{slug}-portfolio-images/et modifier lessrcen chemins relatifs
Mode B · GLM / dialogue en ligne (sans système de fichiers)
- L'utilisateur glisse un zip ; après décompression, 4 fichiers sont visibles
- Sortie uniquement une chaîne HTML complète, enveloppée dans un bloc de code
```html - Si l'utilisateur téléverse des images sans URL → utiliser
https://picsum.photos/id/{id}/{w}/{h}comme placeholder (avec des ID existants connus) - Ne pas essayer d'accéder aux fichiers locaux, ne pas suggérer d'opérations en ligne de commande
Jugement : si vous ne pouvez pas voir les images locales via Read → 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 | Regarder : le phrasé des éléments de liste, le ton de la prose, le vocabulaire des specs, la densité des champs JSON |
template.html | Squelette vide — Mêmes CSS/JS/système de routage, 2 exemples + 20 marqueurs SWAP | Modifier sur cette base, sortir le HTML final |
README.md | Instructions d'utilisation pour l'utilisateur | Le modèle n'a pas besoin de le voir |
SKILL.md | Workflow pour le modèle (ce fichier) | À lire impérativement |
Règle fondamentale : toutes les modifications se font sur template.html ; de reference.html, apprendre comment écrire (ton, longueur, choix des tags), mais ne pas copier le contenu exact.
Étapes de travail
1. Lire les deux HTML
- Lire d'abord
reference.htmlpour comprendre "à quoi ça ressemble une fois complet" (en particulier la densité des champs dans le JSONworks-dataet le ton de la prose) - Puis lire
template.htmlpour repérer les 20 positions SWAP
Ne pas modifier le JS / ne pas modifier le CSS / ne pas modifier le système de routage des pages de détail / ne pas modifier l'import 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
Extraire :
- ATELIER_NAME_ZH — Nom chinois du studio (2-4 caractères idéalement, 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 du studio : 白 / 素 / 墨 / 青 / 拙)
- CITY — Ville
- DIRECTOR_ZH / DIRECTOR_EN — Nom du directeur + pinyin
- DISCIPLINE — 3 mots de discipline ("装帧 · 字体 · 静物")
- TAGLINE — Phrase d'accroche en une ligne (20-40 caractères, style italique)
- YEAR_FOUNDED — Année de fondation (peut utiliser le cycle干支 : 乙未冬 / 甲辰春)
Pour chaque œuvre, extraire :
- 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éalement, 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干支 (
甲辰 / 2024/2025/乙巳 / 2025) - tag — Catégorie en haut, entre crochets, ex.
[ 诗集 · 装帧设计 ]/[ 字体设计 · 中草药图谱 ] - cover — URL de la grande image de la page de détail
- list line location —
Ville, année · technique/spécifications(apparaît au survol) - meta — 4 paires clé-valeur (résumé 4 colonnes de la page de détail)
- lead — 30-70 caractères, grande phrase d'ouverture, peut utiliser
<em>mot-clé</em>pour mettre en valeur - prose — 3-4 paragraphes de prose, chaque 80-150 mots
- specs — 6-10 lignes de tableau de spécifications (format/papier/reliure/police/tirage/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 → inventer soi-même : selon le titre et le type de l'œuvre, écrire un lead et une prose qui correspondent à son caractère. Le ton doit se référer à reference.html — pas de langage marketing, mais plutôt un sentiment de « texte mural de musée + carnet d'atelier » (retenu, 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
Obtenir pour chaque image (filename, w, h, aspect). Privilégier les images verticales comme vignettes de liste (conteneur 4:3, les images verticales rendent mieux).
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 du studio (ex. « 白 ») |
| 4 | Caractère unique dans le SVG du logo | Même que SWAP-3 |
| 5 | Pinyin dans le SVG du logo | {PINYIN} en majuscules |
| 6 | li de la navigation principale | Généralement 3 items : Œuvres / À propos / Contact |
| 7 | Nom chinois du bloc de marque | {ATELIER_NAME} caractères séparés par des espaces (ex. 白 屋) |
| 8 | Anglais du bloc de marque | {PINYIN} Studio · {CITY} |
| 9 | Tagline | Phrase de positionnement en une ligne, style italique, 20-40 caractères, peut utiliser <br> pour les sauts 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, en grille plus compacte — le slug doit correspondre à celui de la liste |
| 12 | Titre À propos | 关 于 {name}<span class="en">About</span> |
| 13 | Paragraphes À propos | 1-3 paragraphes en italique (contexte de création / directeur / vision du design), chaque 60-120 mots |
| 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 li (E-mail/Phone/Address/Instagram/公众号) |
| 18 | Crédit rotatif | Site by {WHO} (généralement le nom du studio) |
| 19 | Trois blocs de footer | © / ICP / liens sociaux |
| 20 | JSON works-data | Données complètes des détails des N œuvres (critique !) |
5. Écrire le JSON works-data (l'étape la plus cruciale)
Chaque œuvre doit avoir une entrée dans le tableau JSON, le slug doit être exactement identique à celui du href #work/SLUG des cartes de liste/galerie.
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", "陈漱石(杭州·订书坊)"]
]
}
Points sensibles JSON ⚠️ :
- Dans la prose chinoise, utiliser les guillemets pleine largeur
「...」ou"..."(U+201C / U+201D), ne pas utiliser les guillemets ASCII"(cela casserait le JSON) - Ne pas mettre de vraies sauts de ligne dans les chaînes JSON ; pour changer de paragraphe, ajouter un élément supplémentaire dans le tableau
prose <em>mot</em>dans le lead peut contenir directement des balises HTML — le rendu se fait via innerHTML- Le
layoutde la galerie doit être choisi parmi trois :g-wide(pleine largeur) /g-half(moitié) /g-third(1/3)
6. Choix des sources d'images
- Placeholder picsum : utiliser la forme
id/Xplutôt queseed/X(plus stable). ID connus et fiables : 0, 20, 40, 51, 64, 76, 88, 91, 96, 119, 121, 130, 143, 145, 158, 164, 165, 175, 177, 180, 187, 195, 200 - La cover et la galerie d'une même œuvre doivent utiliser des ID adjacents pour créer une tonalité de couleur cohérente
- Ne pas utiliser le paramètre
?grayscale(l'utilisateur souhaite des images en couleur)
7. Inspirations pour les noms de studio chinois (si l'utilisateur n'en donne pas)
Si l'utilisateur vous demande de "trouver un nom vous-même" → choisir 2 caractères à l'aspect antique :
- Catégorie objet : 白屋 / 素园 / 墨记 / 青庐 / 拙轩 / 听雨 / 一勺 / 半亩
- Catégorie calligraphie : 素白 / 子衿 / 砚池 / 半山 / 寻常 / 浮云
- Éviter les mots fonctionnels comme "工作室 / Studio", que le nom soit lui-même un poème
8. Support vidéo
Si la couverture de l'œ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'à fournir le chemin de la vidéo dans l'URL de couverture.
9. Rapport
Mode A : Rapport en une phrase.
Fichier généré ~/Desktop/baiwu-portfolio.html — 6 œuvres, survolez une ligne pour voir la vignette, cliquez pour accéder à la page de détail. Light/Dark en bas à gauche, mode liste/album en haut au centre.
Mode B : Donner directement le bloc de code HTML complet + une ligne d'explication.
Enregistrez le code ci-dessus en
index.htmlet ouvrez-le en double-cliquant. Passez la souris sur un nom d'œuvre pour voir apparaître la vignette à droite, cliquez pour accéder à la page de détail. Pour changer les images, remplacez les URL picsum par vos adresses.
Éléments à conserver impérativement (ne pas modifier)
- Import de police :
@font-facechargeant le woff2 d'Alimama DaoLiTi (ne pas changer 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 de ligne, crédit rotatif, routage par hash de la page de détail
applyRoute(),renderDetail() - Le nœud
<script id="works-data">doit être conservé <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 en position fixe : #logo / #main-menu / .theme-toggle / #project-view / #svp-credit
Vérification rapide des erreurs
- Slug non concordant : é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 exactement identiques - Guillemets JSON : les guillemets dans le contenu chinois doivent être pleine largeur «» ou
"...", pas ASCII" - Trop d'images dans la galerie : maximum 6 images par œuvre, au-delà la mise en page sera perturbée
- Prose trop longue : chaque paragraphe 80-150 mots, au-delà de 200 mots la lecture devient moins agréable
- Liste / Galerie non synchronisées : doivent contenir le même ensemble d'œuvres (correspondance une à une)
- Seed picsum : utiliser
id/Xet nonseed/X, pour éviter qu'un ID aléatoire ne tombe sur une image supprimée - Moins de 3 œuvres : possible, 2 minimum suffisent
- Plus de 8 œuvres : conseillé de les diviser en deux lots, trop de lignes de liste allongent la page
- Premier caractère en grande capitale :
.detail__prose p:first-of-type::first-letterutilise la police DaoLiTi — le premier paragraphe doit commencer par du chinois (ne pas commencer par<em>ou par de l'anglais) - Suppression de la couleur des picsum : les images doivent rester en couleur, ne pas ajouter
filter: grayscale()dans le CSS