portfolio-detail — Atelier chinois / Portfolio Lishu (avec page de détail secondaire)
En une phrase
Lignes de texte horizontales + survol faisant apparaître une grande image à droite + caractères artistiques Alimama DaoLiTi + couleurs noir et blanc purs + thème clair/sombre + 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-déposer infinie + tuiles | Photographes / Graphistes montrant des échantillons |
portfolio-museum-gen | Carrousel héroïque + grandes cartes + flux en cascade + pages détaillées (sens cinématographique) | Artistes vidéo / image / installation |
industrial-archive-gen | Couverture à pages noires + archive latérale + design nordique/industriel | Produits physiques / objets / hardware |
lishu-portfolio-gen | Lignes de texte horizontales + survol affichant une vignette à droite + caractères lishu + sobriété chinoise | Reliure / Typographie / Artisanat / Atelier chinois |
Si le projet de l'utilisateur concerne « livres / typographie / expositions / natures mortes / herbes médicinales / thé / poterie / bois / papier / encens » — utilisez celui-ci.
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 de studio »
- « Fais-moi un portfolio style maison blanche » / « Fais-moi un site liste horizontale comme Gurgel D'Alfonso »
- « lishu-portfolio-gen ... »
Et fournit :
- Description du studio (obligatoire) : nom, directeur, ville, discipline, titres et histoires des œuvres
- Images des œuvres (optionnel) : URL / téléchargement / chemin. Fonctionne même sans (utilise picsum comme placeholder)
Si l'utilisateur ne donne aucun titre d'œuvre → demander au moins quelles œuvres doivent être présentées. Si l'utilisateur donne seulement les titres sans détails → les écrire soi-même : pour chaque œuvre, générer 1 phrase d'accroche (lead) + 3 paragraphes en prose + 6-8 lignes de spécifications + 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)
- Utilisez
Bashpour lister les dossiers,sipspour obtenir les dimensions de chaque image - Emplacement de sortie :
~/Desktop/{slug}-portfolio.html(fichier unique, toutes les images via URL) - Si l'utilisateur donne des images locales : copiez-les dans
~/Desktop/{slug}-portfolio-images/et modifiez src en chemin relatif
Mode B · GLM / Chat en ligne (sans système de fichiers)
- L'utilisateur télécharge un zip ; après décompression, vous voyez 4 fichiers
- Sortie uniquement la chaîne HTML complète, dans un bloc de code ```html
- Si l'utilisateur télécharge des images sans donner d'URL → utilisez
https://picsum.photos/id/{id}/{w}/{h}comme placeholder (avec des IDs existants connus) - N'essayez pas d'accéder aux fichiers locaux, ne suggérez pas d'opérations en ligne de commande
Règle : si vous ne pouvez pas lire les images locales → par défaut, mode B.
Répartition des fichiers
| Fichier | Rôle | Comment l'utiliser |
|---|---|---|
reference.html | Exemple complet terminé — BAIWU 6 œuvres | Voir : formulation des items de liste, ton de la prose, vocabulaire des specs, densité des champs JSON |
template.html | Squelette vide — même système CSS/JS/routage, 2 exemples + 20 marqueurs SWAP | Modifiez-le, sortie du HTML final |
README.md | Instructions pour l'utilisateur | Le modèle n'a pas besoin de le voir |
SKILL.md | Workflow pour le modèle (ce fichier) | À lire |
Règle principale : toutes les modifications se basent sur template.html ; apprenez de reference.html comment écrire (ton, nombre de mots, choix de tags), mais ne copiez pas le contenu spécifique.
Étapes de travail
1. Lire les deux fichiers HTML
- Lisez d'abord
reference.htmlpour comprendre « à quoi ça ressemble quand c'est fini » (en particulier la densité des champs JSONworks-dataet le ton de la prose) - Lisez ensuite
template.htmlpour trouver les 20 positions 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'import de la police. Les SWAP se trouvent dans le texte HTML et les données JSON.
2. Analyser l'entrée utilisateur et extraire les informations
Extrayez :
- ATELIER_NAME_ZH — Nom chinois du studio (2-4 caractères idéalement, ex. « 白屋 », « 素园 », « 墨记 », « 青庐 », « 拙轩 »)
- 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 : 白 / 素 / 墨 / 青 / 拙)
- CITY — Ville
- DIRECTOR_ZH / DIRECTOR_EN — Nom du directeur + pinyin
- DISCIPLINE — 3 mots de discipline (« 装帧 · 字体 · 静物 »)
- TAGLINE — Phrase de positionnement (20-40 caractères, style calligraphique kaiti)
- YEAR_FOUNDED — Année de fondation (peut être en tige terrestre/ branche céleste : 乙未冬 / 甲辰春)
Pour chaque œuvre, extrayez :
- slug — ID d'URL, en minuscules avec traits d'union (ex.
kong-shan-ji,wu-ming-shu) - title_zh — Titre chinois (2-5 caractères idéalement, plus c'est concis, plus c'est stylé)
- title_en — Sous-titre anglais (style titre de livre :
An Anthology of Empty Mountains) - year — Année ou année cyclique (
甲辰 / 2024/2025/乙巳 / 2025) - tag — Catégorie en haut, entre crochets, ex.
[ 诗集 · 装帧设计 ]/[ 字体设计 · 中草药图谱 ] - cover — URL de la grande image de la page de détail
- list row location —
Ville, année · Technique/spécifications(apparaît au survol) - meta — 4 paires clé-valeur (résumé en 4 colonnes de la page de détail)
- lead — 30-70 caractères d'accroche, peut utiliser
<em>mot-clé</em>pour mettre en valeur - prose — 3-4 paragraphes en prose, 80-150 caractères chacun
- 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 de rôle/nom
Si l'utilisateur donne seulement une phrase / pas d'histoire → inventez : en fonction du titre et du type de l'œuvre, écrivez un lead et une prose en cohérence avec le ton de l'œuvre. Inspirez-vous de reference.html — pas de langage marketing, mais un style « texte de musée + carnet d'atelier » (sobre, concret, lent, avec une touche artisanale).
3. Lister les œuvres et vérifier les dimensions (mode A uniquement)
```bash 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 verticales pour les vignettes de liste (conteneur 4:3, les verticales sont plus flatteuses).
4. Remplacer les 20 SWAP
| SWAP | Emplacement | Contenu |
|---|---|---|
| 1 | <title> | {ATELIER_NAME} {PINYIN} — Portfolio de {DIRECTOR} / Studio |
| 2 | meta description | Une phrase de description du site |
| 3 | Curtain (rideau) caractère unique | Premier caractère du nom du studio (ex. « 白 ») |
| 4 | Logo SVG caractère unique | Identique au SWAP-3 |
| 5 | Logo SVG pinyin | {PINYIN} en majuscules |
| 6 | Navigation principale li | Généralement 3 éléments : Œuvres / À propos / Contact |
| 7 | brand-block nom chinois | {ATELIER_NAME} avec espacement (ex. 白 屋) |
| 8 | brand-block anglais | {PINYIN} Studio · {CITY} |
| 9 | tagline | Une phrase de positionnement en style calligraphique, 20-40 caractères, peut utiliser <br> pour sauter une ligne |
| 10 | N éléments de liste | Chaque <a class="item" href="#work/{slug}"> contenant num/project-name/en-name/location/photo-thumb |
| 11 | N éléments de galerie | Les mêmes N œuvres, 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 style calligraphique (contexte de création / directeur / vision du design), 60-120 caractères 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 du studio) |
| 19 | Footer trois blocs | © / ICP / Liens sociaux |
| 20 | JSON works-data | Données complètes des N œuvres (essentiel !) |
5. Écrire le JSON works-data (étape la plus critique)
Chaque œuvre doit avoir une entrée dans le tableau JSON, le slug doit correspondre exactement au #work/SLUG dans les href des cartes liste/galerie.
Champs JSON : ```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": "三十六首关于山的诗。我们想做一本——读者翻开后,先听见风声,再读见字的书。", "prose": [ "Paragraphe un : source des poèmes / contexte du design. 80—150 caractères.", "Paragraphe deux : décisions clés pendant la fabrication — police, papier, choix de reliure.", "Paragraphe trois : résultat final / sentiment laissé au lecteur." ], "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 fréquentes ⚠️ :
- Dans la prose chinoise, utilisez des guillemets → doivent être des guillemets pleine largeur
「...」ou"..."(U+201C / U+201D), pas de guillemets ASCII"(cela casserait le JSON) - N'écrivez pas de retours à la ligne réels dans les chaînes JSON ; pour changer de paragraphe, ajoutez un élément supplémentaire dans le tableau prose
<em>mot</em>dans le lead écrit directement la balise HTML — lors du rendu, il est traité en innerHTML- Le
layoutde gallery doit être choisi parmi les trois :g-wide(pleine largeur) /g-half(demi-largeur) /g-third(tiers)
6. Choix des sources d'images
- Placeholder picsum : utilisez la forme
id/Xplutôt queseed/X(plus stable). IDs 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 - Pour le cover/gallery 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 nommer un studio chinois (si l'utilisateur n'en donne pas)
Si l'utilisateur vous demande de "trouver un nom" → choisissez 2 caractères + style ancien :
- Catégorie objets : 白屋 / 素园 / 墨记 / 青庐 / 拙轩 / 听雨 / 一勺 / 半亩
- Catégorie mots : 素白 / 子衿 / 砚池 / 半山 / 寻常 / 浮云
- Évitez les mots fonctionnels comme « 工作室 / 设计 / Studio », le nom doit déjà être un poème.
8. Support vidéo
Si le cover d'une œuvre est .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 du cover.
9. Rapport
Mode A : Rapport en une phrase.
Généré ~/Desktop/baiwu-portfolio.html — 6 œuvres, survolez les lignes pour voir les vignettes, cliquez pour accéder à 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.
Enregistrez ce qui précède sous
index.htmlet double-cliquez pour l'ouvrir. Déplacez la souris sur le nom d'une œuvre pour voir la vignette apparaître à droite, cliquez pour accéder à la page de détail. Pour changer les images, remplacez les URLs picsum par vos propres adresses.
À conserver impérativement (ne pas modifier)
- Import de la police :
@font-facechargeant le woff2 d'Alimama DaoLiTi (ne pas changer la source) - Système de variables CSS : double thème clair/sombre
- Tout le JS : theme toggle, view mode toggle, interaction hover-row, crédit tournant, routage par hash pour les pages de détail
applyRoute(),renderDetail() - La balise
<script id="works-data">doit être conservée - La balise
<main id="detail-root">doit être conservée (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 fixement : #logo / #main-menu / .theme-toggle / #project-view / #svp-credit
Vérification rapide des erreurs
- 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 exactement identiques - Guillemets JSON : dans le contenu chinois, utilisez toujours les guillemets pleine largeur « » ou
"...", pas les guillemets ASCII" - Trop de galeries : maximum 6 images par œuvre, au-delà la mise en page sera désordonnée
- Prose trop longue : 80-150 caractères par paragraphe, au-delà de 200 caractères l'expérience de lecture se dégrade
- Liste/galerie désynchronisées : doivent contenir exactement le même ensemble d'œuvres (correspondance un-à-un)
- Picsum seed : utilisez
id/Xpasseed/X, pour éviter un ID aléatoire pointant vers une image supprimée - Moins de 3 œuvres : possible, minimum 2 pour que ça fonctionne
- Plus de 8 œuvres : suggérez de diviser en deux lots, trop de lignes de liste allongent la page
- Lettre initiale tombante :
.detail__prose p:first-of-type::first-letterutilise la police DaoLiTi — le premier paragraphe doit commencer par du chinois (pas par<em>ou par de l'anglais) - Couleur supprimée de picsum : les images doivent rester en couleur, n'ajoutez pas de
filter: grayscale()dans le CSS