Construction de portfolio
Un portfolio ne bénéficie que d'environ 30 secondes lors de la première visite. Cette compétence en construit un qui utilise ces secondes efficacement : qui vous êtes et ce que vous faites apparaît sur le premier écran, des travaux réels à côté, votre rôle dans chaque projet est indiqué, et un moyen clair de vous contacter est fourni.
Elle fixe la structure et laisse l'apparence à la personne. Les trois grilles décident où et dans quel ordre placer les éléments. La police, la couleur, le rayon des coins et l'espacement leur appartiennent, définis dans un seul petit bloc. Deux portfolios construits avec cette compétence devraient se lire de la même manière et ne pas se ressembler du tout.
Les chemins ci-dessous sont relatifs au dossier de cette compétence.
Comment ça fonctionne
Un seul fichier, portfolio.json, contient tout : l'identité de la personne, les projets, la grille choisie et l'apparence. Une seule commande le transforme en site statique (HTML et CSS simples, sans framework, rien à installer) :
python3 scripts/build.py chemin/vers/son-site/portfolio.json
Le site est généré à côté du fichier de contenu. Le script affiche ensuite deux listes : ce qu'un audit de 30 secondes signalerait encore, chaque élément lié à un numéro de règle (references/rules.md contient les dix-sept règles en une ligne chacune), et chaque [slot] en attente d'un fait. Considérez les deux comme une liste de tâches.
Étapes
1. Déterminer à quoi sert le portfolio
Demandez, ou déduisez de ce qui vous a été donné :
- La cible. Le poste ou le client visé. Elle détermine le titre, l'ordre et ce qui est omis.
- Le travail. Quels projets, et pour chacun : de quoi il s'agissait, leur rôle, pour qui il était, l'année, une décision qu'ils ont prise et ce qui s'est produit.
- Le matériel. Où se trouvent les images et les vidéos.
S'ils ont un site existant, lisez-le d'abord et reprenez ce qui s'y trouve. Si la compétence portfolio-audit est disponible et qu'ils ont un site en ligne, l'exécuter en premier vous indique exactement quoi modifier.
Demandez uniquement ce que vous ne pouvez pas trouver. Une personne avec un dossier d'images et une page LinkedIn vous a déjà fourni l'essentiel. Si personne n'est là pour répondre, continuez avec ce que vous avez et utilisez des slots (étape 3).
Le matériel dont la personne n'est pas sûre (un carnet de croquis, un projet étudiant, quelque chose d'ancien) reste de côté. Ils ont douté pour une raison, et un portfolio est jugé sur son élément le plus faible. Dites ce que vous avez omis et pourquoi. Trois projets solides constituent un portfolio complet ; n'ajoutez pas de contenu pour en atteindre quatre.
2. Laissez la personne choisir la grille
Lisez references/grids.md. Il décrit les trois grilles et à qui chacune convient. La grille détermine la façon dont l'ensemble du site se lit, c'est donc le choix de la personne, pas le vôtre. Votre rôle est de rendre ce choix facile.
Avant de construire, nommez les trois grilles en un court message, une ligne chacune, dites laquelle vous recommandez pour leur travail et leur cible et pourquoi, et demandez laquelle ils souhaitent. Regroupez cela avec tout ce que vous devez demander à l'étape 1, afin de n'avoir qu'un seul tour de questions, pas deux.
- S'ils ont déjà nommé une grille, utilisez-la et ne rouvrez pas la question.
- S'ils en choisissent une différente de votre recommandation, construisez la leur. Dites une fois ce que cela leur coûte si cela a de l'importance (par exemple,
indexn'a pas de place pour une décision et un résultat), puis passez à autre chose. - S'ils hésitent, ou si personne n'est là pour répondre, allez-y avec votre recommandation et construisez avec
--compareà l'étape 5, afin que les trois soient disponibles pour être ouverts côte à côte.
Changer plus tard est un mot dans le fichier, donc personne n'est bloqué. C'est une raison pour proposer le choix légèrement, pas une raison pour le sauter.
3. Écrire le fichier de contenu
Copiez assets/example/portfolio.json comme point de départ et lisez references/content.md pour chaque champ. Mettez-le dans le dossier qui deviendra le site, avec les images à côté. L'exemple utilise la grille case ; pour index et columns, decision et result sont optionnels et les lignes avant/après sont rarement nécessaires.
Comment écrire les parties les plus importantes :
- Titre : une phrase qui dit ce qu'ils créent et pour qui, avec un fait concret. Il ne devrait pas convenir au site de quelqu'un d'autre. « Designer produit pour les applications fintech. Huit ans d'expérience, dernier poste : responsable du flux d'épargne chez Ledger. » Pas « Créatif multidisciplinaire passionné par la conception d'expériences. »
- Preuve : les trois ou quatre noms ou chiffres les plus forts, juste après le titre.
- Ordre : le projet qui correspond le mieux à la cible passe en premier, quelle que soit sa date. Quatre à huit projets. Les disciplines secondaires (film pour un directeur artistique, illustration pour un designer produit) sont mieux placées sur un second site avec son propre fichier de contenu que mélangées.
- Chaque projet : un résumé d'une ligne, le rôle, et si c'était pour un client, un employeur ou un concept personnel. Pour les cibles produit et leadership, ajoutez la décision et le résultat.
- Rôle : leur titre actuel tel quel, pas celui pour lequel ils postulent.
- Demande : une phrase au-dessus de l'email qui dit pour quoi écrire.
- Langue : écrivez dans la langue de leur public et définissez
site.lang. Les mots du modèle (Index, Facts, Next…) suivent pour l'anglais et l'espagnol ; pour toute autre langue, définissez-les danslabels.
Utilisez uniquement les faits que la personne vous a donnés ou qui figurent sur ses pages existantes. Un fait que vous avez déduit vous-même, comme le nom d'un client lu dans un nom de fichier, peut être utilisé, mais dites à la personne qu'il a été inféré afin qu'elle puisse le confirmer.
Lorsqu'un fait manque, écrivez un slot entre crochets ([année], [taille de l'équipe], [ce qui a été livré]). Les slots apparaissent sur le site exactement comme écrits et la construction liste chacun d'eux, donc :
- Gardez le titre exempt de slots : écrivez-le à partir de ce que vous savez. Un slot dans la première phrase est la première chose qu'un visiteur lit.
- Si un champ entier est inconnu et optionnel (
city,team,site.url), omettez le champ plutôt. - Pour un travail sans résultat, dites la vérité : « Livré en 2024 ; je n'ai pas les chiffres », « Concept, non lancé ». C'est un résultat. Une promesse vide d'impact ne l'est pas.
- Un site avec des slots est une ébauche. Dites-le clairement lors de la remise.
Un portfolio avec une lacune honnête est acceptable. Un portfolio avec un client inventé est un problème lors d'un entretien.
4. Définir l'apparence
Dans le bloc theme : clair ou sombre, une couleur d'accent, la police, le rayon des coins, l'espacement entre les images. Si la personne a une marque ou un site existant, reprenez-les. S'ils n'ont rien, choisissez une police et une couleur d'accent qui conviennent à leur travail et dites ce que vous avez choisi. Ne copiez pas l'apparence de l'exemple ou d'un autre site de designer.
Une police qui n'est pas présente sur tous les appareils nécessite font_url pour la charger ; la nommer uniquement dans font la fait retomber sur la police système pour la plupart des visiteurs. Donnez les deux, ou choisissez une pile de polices système.
5. Construire, visualiser, corriger
Exécutez la construction. Si la personne n'a pas choisi de grille elle-même, ajoutez --compare :
python3 scripts/build.py chemin/vers/son-site/portfolio.json --compare
Cela écrit également le même contenu dans les trois grilles dans un dossier compare/, avec une page qui les relie. Montrez cette page à la personne et laissez-la choisir. compare/ est uniquement pour le choix : supprimez-le avant la publication.
Ensuite, regardez le site dans un navigateur, en largeur d'ordinateur et de téléphone si possible : lancez python3 -m http.server dans le dossier du site (la grille case lie des dossiers de projet, qui nécessitent un serveur) et vérifiez le premier écran vous-même : nom, activité, preuve, un moyen de vous contacter, et un vrai travail, sans défilement.
Si vous ne pouvez pas ouvrir un navigateur, dites-le lors de la remise, et au moins gardez le titre et la preuve à environ 45 mots ensemble, ce qui tient au-dessus de la première image sur un téléphone.
Parcourez la liste que le script a imprimée. Corrigez ce que vous pouvez à partir du contenu (une ligne de rôle manquante, une image lourde, un titre long). Remettez le reste à la personne sous forme d'une courte liste de ce qu'elle seule peut fournir.
6. Remettre
Dites-leur : quelle grille et s'ils l'ont choisie ou si c'est vous (et que les deux autres sont à un mot de distance, ou dans compare/ si vous l'avez construite), ce que vous avez écrit pour le titre, ce que vous avez omis, tout ce que vous avez inféré, les slots encore à remplir, ce que la liste d'audit montre encore, et comment modifier les choses (éditer portfolio.json, relancer la construction). Le dossier est un site statique complet : il peut être publié sur n'importe quel hébergeur statique en le téléchargeant tel quel.
Deux choses qu'eux seuls peuvent fournir, demandez-les donc ici : l'adresse où le site sera hébergé (site.url), et une image de 1200×630 pixels pour les aperçus de liens (site.share_image) ; un recadrage de la meilleure image du premier projet fait l'affaire.
Images
- Exportez à 2000 px de large au maximum, en AVIF ou WebP, sous environ 500 Ko chacune. La construction avertit des images plus lourdes. JPEG, PNG et SVG fonctionnent aussi.
- Une copie plus petite pour les téléphones est utilisée automatiquement lorsque les fichiers sont nommés par paire :
shot-lg.jpgdans le fichier de contenu etshot-sm.jpgà côté. Un.avifavec les mêmes noms est proposé en premier aux navigateurs qui le lisent. - Donnez à chaque image un
altqui dit ce qu'elle montre. Sans cela, le titre du projet est utilisé, ce qui dit très peu de chose à un moteur de recherche ou à un assistant IA. Si vous n'avez pas vu les images, dites de quelle pièce il s'agit et demandez à la personne de les décrire. - Les vidéos courtes en boucle (
.mp4,.webm) fonctionnent comme des tuiles. Elles sont lues en sourdine, uniquement lorsqu'elles sont à l'écran. Donnez-leur unratio.
Ce qu'il ne faut pas faire
- N'ajoutez pas d'animation d'intro, de chargeur, de curseur personnalisé ou d'effets de défilement qui retardent le contenu. Le modèle affiche le premier écran immédiatement intentionnellement.
- Ne cachez pas les titres des projets derrière un survol. Les téléphones n'ont pas de survol.
- Ne supprimez pas le dock, la petite barre avec le nom et l'email qui apparaît une fois le bloc de contact défilé hors de l'écran. Un évaluateur décide d'écrire au milieu d'un projet, pas à la fin de la page.
- Ne comblez pas un travail faible avec des images de processus (notes autocollantes, personas). Une décision, dite clairement, vaut plus.
- Ne modifiez pas le HTML généré à la main : la prochaine construction l'écrase. Modifiez le fichier de contenu, ou le modèle dans
assets/template/si la structure elle-même doit changer.