portfolio-detail — Studio chinois / Portfolio en style lishu (avec pages de détail secondaires)
En une phrase
Lignes de texte horizontales + survol révélant une grande image à droite + grands caractères artistiques « Alimama DaoLiTi » + couleurs noir et blanc + thème clair/sombre + pages de détail avec routage hash + double vue liste/album.
Différences avec les autres compétences de portfolio
| Compétence | Mode principal | Pour qui |
|---|---|---|
portfolio-gen | Toile à défilement infini + tuiles | Photographes / graphistes exposant des échantillons |
portfolio-museum-gen | Carrousel héroïque + grandes cartes + défilement en cascade + pages de détail (ambiance curatrice d'images) | Artistes vidéo / image / installation |
industrial-archive-gen | Couverture à retournement en cadre noir + archive latérale + industriel nordique | Produits physiques / objets / matériel |
lishu-portfolio-gen | Lignes de texte horizontales + vignette au survol + grands caractères lishu + retenue chinoise | Reliure / Typographie / Artisanat / Studio chinois |
Si le projet de l'utilisateur concerne « le livre / la typographie / l'exposition / la nature morte / la médecine chinoise / le thé / la poterie / le bois / le papier / l'encens » — utilisez cette compétence.
Quand déclencher
L'utilisateur dit :
- « Crée un portfolio de style chinois / oriental / classique »
- « Crée un site web de studio / page d'accueil en style lishu »
- « Crée un portfolio de style maison blanche » / « Crée 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 n'a donné aucun titre d'œuvre → demandez au moins quelles sont les œuvres à exposer. Si l'utilisateur a donné seulement les titres sans détails → écrivez vous-même : pour chaque œuvre, générez 1 phrase d'accroche + 3 paragraphes en prose + 6-8 lignes de spécifications + 3-6 images picsum + plusieurs 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 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 télécharge un zip ; après décompression, 4 fichiers sont visibles
- Sortie uniquement une chaîne HTML complète, encapsulée dans un bloc
```html - Si l'utilisateur télécharge une image sans URL → utilisez
https://picsum.photos/id/{id}/{w}/{h}comme placeholder (utilisez des ID connus) - N'essayez pas d'accéder aux fichiers locaux, ne suggérez pas de commandes en ligne de commande
Jugement : si vous ne pouvez pas Read pour voir les images locales → utilisez le 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 — BAIWU 6 œuvres | Étudiez : le ton des éléments de liste, le style de la prose, le vocabulaire des spécifications, la densité des champs JSON |
template.html | Structure vide — Mêmes CSS/JS/système de 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 | Flux de travail pour le modèle (ce fichier) | À lire impérativement |
Règle fondamentale : toutes les modifications sont basées sur template.html ; apprenez comment écrire à partir de reference.html (ton, longueur des mots, utilisation des balises), mais ne copiez pas le contenu spécifique.
Étapes de travail
1. Lire les deux HTML
- Lisez d'abord
reference.htmlpour comprendre « à quoi cela ressemble une fois terminé » (en particulier la densité des champs du 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'importation de la police. Les SWAP se trouvent uniquement dans le texte HTML et les données JSON.
2. Analyser l'entrée utilisateur pour extraire les informations
Extrayez :
- 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 — Une phrase de positionnement (20-40 caractères, style calligraphique)
- YEAR_FOUNDED — Année de fondation (peut utiliser les tiges célestes : 乙未冬 / 甲辰春)
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éalement, plus concis, plus de style)
- title_en — Sous-titre anglais (style guillemets :
An Anthology of Empty Mountains) - year — Année ou année des tiges célestes (
甲辰 / 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é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, phrase d'accroche en grands caractères ; peut utiliser
<em>mot-clé</em>pour mettre en valeur un point - prose — 3-4 paragraphes en prose, chaque paragraphe 80-150 mots
- specs — 6-10 lignes de tableau de spécifications (format/papier/reliure/typographie/tirage/impression/technique/prix, etc.)
- gallery — 3-6 images, layout au choix parmi trois :
g-wide/g-half/g-third - credits — 4-7 paires rôle/nom
Si l'utilisateur ne donne qu'une phrase/pas d'histoire → inventez : en fonction du titre et du type de l'œuvre, écrivez un lead et une prose qui correspondent au ton. Le ton doit être celui de reference.html — pas de langage marketing, mais une sensation de « texte mural de musée + carnet d'atelier » (retenu, concret, lent, avec des traces de travail manuel).
3. Lister les œuvres + obtenir 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 portrait comme vignettes de liste (conteneur 4:3, le portrait rend 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 du rideau | Premier caractère du nom du studio (ex. « 白 ») |
| 4 | Caractère dans le logo SVG | Identique à SWAP-3 |
| 5 | Pinyin dans le logo SVG | {PINYIN} en majuscules |
| 6 | Navigation principale li | Généralement 3 éléments : Œuvres / À propos / Contact |
| 7 | Nom chinois du brand-block | {ATELIER_NAME} avec espaces entre les caractères (ex. 白 屋) |
| 8 | Anglais du brand-block | {PINYIN} Studio · {CITY} |
| 9 | Tagline | Une phrase de positionnement en style calligraphique, 20-40 caractères, peut utiliser <br> pour les sauts de ligne |
| 10 | Éléments de liste N | Chaque <a class="item" href="#work/{slug}"> contient num/project-name/en-name/location/photo-thumb |
| 11 | Éléments de galerie N | 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 fondation / directeur / philosophie de design), chaque paragraphe 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 + délai de réponse |
| 17 | Tableau de faits Contact | 4-6 éléments (E-mail/Phone/Address/Instagram/公众号) |
| 18 | Crédit rotatif | 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 (l'étape la plus cruciale)
Chaque œuvre doit avoir une entrée dans le tableau JSON, le slug doit correspondre exactement à celui de l'attribut href dans les cartes liste/galerie (#work/SLUG).
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 courantes JSON ⚠️ :
- Dans la prose chinoise, utilisez les guillemets pleine largeur
「...」ou"..."(U+201C / U+201D), pas les guillemets ASCII"(cela briserait le JSON) - N'écrivez pas de vraies nouvelles lignes dans les chaînes JSON ; pour les paragraphes, ajoutez simplement un élément supplémentaire dans le tableau prose
- Les balises
<em>mot</em>dans le lead s'écrivent directement en 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. Sélection de la source des images
- Placeholder picsum : utilisez 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 - Pour le cover / la galerie d'une même œuvre, utilisez des ID adjacents pour créer une palette de couleurs cohérente
- N'utilisez pas le paramètre
?grayscale(les utilisateurs souhaitent des images en couleur)
7. Inspirations pour les noms de studios chinois (si l'utilisateur n'en donne pas)
Si l'utilisateur vous dit « inventez-en un » → choisissez 2 caractères, style ancien :
- Types d'objets : 白屋 / 素园 / 墨记 / 青庐 / 拙轩 / 听雨 / 一勺 / 半亩
- Types de lignes : 素白 / 子衿 / 砚池 / 半山 / 寻常 / 浮云
- Évitez les mots fonctionnels comme « 工作室 / 设计 / Studio », que le nom soit lui-même un poème
8. Prise en charge des vidéos
Si le 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'à fournir le chemin vidéo dans l'URL du cover.
9. Rapport
Mode A : Rapport en une phrase.
Fichier généré : ~/Desktop/baiwu-portfolio.html — 6 œuvres, survol des lignes pour voir les vignettes, clic pour accéder aux pages de détail. Light/Dark en bas à gauche, liste/album en haut centré.
Mode B : Donnez directement le bloc de code HTML complet + une ligne d'explication.
Enregistrez le code ci-dessus sous
index.htmlet double-cliquez pour l'ouvrir. Survolez n'importe quel nom d'œuvre pour voir la vignette apparaître à droite, cliquez pour accéder à la page de détail. Pour changer les images, remplacez les URL picsum par vos adresses.
Éléments obligatoires (ne pas modifier)
- Importation de la police : chargement du woff2 de
Alimama DaoLiTivia@font-face(ne changez pas la source de la police) - Système de variables CSS : double thème clair/sombre
- Tout le JS : bascule de thème, bascule de mode d'affichage, interaction hover-row, crédit rotatif, routage 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)- Système d'état
body[data-view="home/detail"]etbody[data-mode="list/gallery"] - Les cinq éléments à positionnement fixe : #logo / #main-menu / .theme-toggle / #project-view / #svp-credit
Vérification rapide 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 identiques - Guillemets JSON : les guillemets dans le contenu chinois doivent être en pleine largeur « » ou
"...", pas ASCII" - Trop de galerie : maximum 6 images par œuvre, au-delà la mise en page se dégrade
- Prose trop longue : chaque paragraphe 80-150 mots, au-delà de 200 mots l'expérience de lecture se dégrade
- Liste / Galerie désynchronisées : elles doivent contenir le même ensemble d'œuvres (correspondance une à une)
- Seed picsum : utilisez
id/Xpasseed/Xpour éviter qu'un ID aléatoire ne tombe sur une image supprimée - Œuvres < 3 : possible, minimum 2 œuvres pour que cela fonctionne
- Œuvres > 8 : recommandez de les diviser en deux lots, trop de lignes de liste allongent la page
- Premier caractère en retrait : le
.detail__prose p:first-of-type::first-letterde la page de détail utilise la police DaoLiTi — le premier paragraphe doit commencer par du chinois (pas par<em>ni par de l'anglais) - Suppression de la couleur des picsum : les images doivent rester en couleur, n'ajoutez pas
filter: grayscale()en CSS